Waardes ophalen uit een zaak of contactmoment

Waardes uit een zaak of contactmoment kunnen opgehaald worden door gebruik te maken van Juel of Velocity scriptie. Welke scripting je wanneer gebruikt is afhankelijk van de plaats waar je de waarde wilt gebruiken (zie Juel & Velocity scripting).

-→ info hieronder nog te verwerken

Juel

Velocity - vb.
- Waarde uit taakformulier halen - naam uitvoerder: ${s.taskFormsFromLastRunMap.get('naam_vd_taak').creator.fullName}
- Flex form waarde van taakformulier halen - voornaam ondertekenaar1: ${s.taskFormsFromLastRunMap.get('naam_vd_taak').formDataFlexesMap.get('ondertekenaar_vraag_id').value.signer1FirstName}
Juel - vb.
- Referentie nummer: ${s.reference}
- Waarde uit taakformulier halen - naam uitvoerder: ${s.taskFormsFromLastRunMap['naam_vd_taak'].creator.fullName}
- Flex form waarde van taakformulier halen - voornaam ondertekenaar1: ${s.taskFormsFromLastRunMap['naam_vd_taak'].formDataFlexesMap['ondertekenaar_vraag_id'].value.signer1FirstName}

Object graph van GenericObject (=s).

Elk object heeft ook nog id, version, creator, modifier, createdDate, modifiedDate als property maar dit wordt hieronder niet telkens herhaald.

genericObjectType
- code
- message (ResourceMessage)
  - code
  - message
  - language
- genericObjectTypeObjectType (GenericObjectTypeObjectType)
  - label
- formReference
- workflow (Workflow)
  - lastDeployment (WorkflowRevision)
    - name
    - key
    - description
    - definition
    - message
    - deploymentVersion
    - basedOn (WorkflowRevision)
    - deployed
  - revisions (List)
  - deployed
  - headRevision (WorkflowRevision)
    - name
    - key
    - ...
- genericObjectTypeGroup (GenericObjectTypeGroup)
  - code
  - message (ResourceMessage)
    - code
    - message
    - language
reference (${s.reference})
confidential
archivedSince
form (Form)
- formType
- formDataFixed (FormDataFixed)
  - subject (${s.form.formDataFixed.subject})
  - description
  - locationChoice
  - locationGeoCode
  - locationStreet
  - locationStreetNbr
  - locationRemark
  - defaultAttachmentFolder (GenericObjectDocument)
    - name
    - techType
    - link
    - confidential
    - info
  - requester (Agent -> Person | Organization | PersonInOrganization)
    - contact
      - nickname
      - email
      - phoneNumber
      - website
      - fax
    - basicAddress
      - streetName
      - houseNumber
      - locator
      - zipCode
      - country
      - city
      - fullAddress
    - legalName (indien agent een organisatie is)
    - kboNumber (indien agent een organisatie is)
    - vatNumber (indien agent een organisatie is)
    - type (indien agent een organisatie is)
    - identityNumber (indien agent een persoon is)
    - firstName (indien agent een persoon is)
    - familyName (persoon)
    - gender (indien agent een persoon is agent een persoon isn)
    - displayName (indien agent een persoon is)
    - person (indien agent een persoon in een organisatie is)
      - properties van Person...
    - organisation (indien agent een persoon in een organisatie is)
      - properties van Organization...
    - customer1 (Agent)
    - internalAgent (Agent)
    - causer (Agent)
    - registeredPost
    - letterDate
    - stampDate
    - invCurrencySubcode (SubcodeDefinition)
      - code
      - subcodeGroupDefinition (SubcodeGroupDefinition)
        code
    - invTypeSubcode (SubcodeDefinition)
      - code
      - subcodeGroupDefinition (SubcodeGroupDefinition)
        code
    - invNetTotal
    - invVatTotal
    - invTotal
    - invOrderReference
    - invStructuredAnnouncement
    - invDueDays
    - invVatType
    - medicalDescription
    - medicalAttachmentFolder (GenericObjectDocument)
    - chargeCosts
    - openReason
    - closeReason
    - communicationPreference
    - externalReference
    - distributed3rdActor
    - signer (Signer)
      - name
      - entityLegalName
      - entityKboNumber
      - entityAddressStreetName
      - entityAddressZipcode
      - entityAddressCity
      - entityAddressCountry
      - entityEmail
      - entityPhoneNumber
      - entityFax
      - entityWebsite
      - entityLogoentityLogoName
      - signer1FirstName
      - signer1LastName
      - signer1Function
      - signer1Signature
      - signer1SignatureName
      - signer2FirstName
      - signer2LastName
      - signer2Function
      - signer2Signature
      - signer2SingatureName
      - addressPosition (PortalListItem)
        name
        value
        position
    - mailContent
- formDataFlexesMap (FormDataFlex velden)
  - agent (Agent)
  - groupDefinitionId
  - fieldDefinitionId
  - stringValue
  - longValue
  - doubleValue
  - dateValue
  - clobValue
  - booleanValue
  - userValue (user)
  - groupValue (group)
  - signerValue (signer)
  - documentValue (genericObjectDocument)
  - value (geeft 1 van bovenstaande values terug wanneer deze ingevuld is) (${s.form.formDataFlexesMap.get('phone_number').value})
  - label
  - displayValue
- formBlobVersion
internalState
externalState
genericObjectDocumentFolder (GenericObjectDocument)
taskFormFromLastRunMap (TaskForm velden)
- jbpmTaskId
- jpbmTaskName
- formReference
- formType
- formDataFlexesMap (FormDataFlex velden)
  - value (als bvb signerValue is ingevuld)
    - signer1FirstName (${s.taskFormsFromLastRunMap['naam_vd_taak'].formDataFlexesMap['ondertekenaar_vraag_id'].value.signer1FirstName})
    - ...
  - …
creator
createdDate
modifier
modifiedDate
id
version

Het ophalen van waardes door middel van Juel en Velocity is gelijkaardig. De grootste verschillen kunnen als volgt samengevat worden:

	Juel	Velocity
prefix van de variabel	$s	s

Door in velocity een uitroepteken achter de dollar te zetten, printen we steeds een lege string af indien de effectieve waarde van het object null is. Anders wordt het script zelf afgeprint.Bijvoorbeeld: ${s.subject} print ${s.subject} af indien de waarde leeg is van subject op element ’s', $!{s.subject} print een lege string indien de waarde null is van subject op element ’s'.

Om waardes van een zaak of contactmoment op te halen, gebruik je de object graph. Je begint steeds bij de zaak of het contactmoment dewelke geïdentificeerd wordt als ‘het subject’.

Een groot verschil tussen Juel en Velocity is het gebruik van accolades en dollarteken.

In velocity wordt met het dollarteken de variabele aangegeven en met de accolades bepaald tot hoever deze variabele reikt. Je kan de accolades dus rond de hele variabelenaam zetten maar het hoeft niet. Vb. ${s.subject} is hetzelfde als $s.subject. Accolades zetten is enkel nuttig om duidelijk aan te geven wat de variabelenaam is, of noodzakelijk in het geval je wil concateneren. Vb. ${s.subject}-${s.reference}. Door in voorgaand voorbeeldje een liggend streepje tussen de variabelen te zetten zonder spatie, is het nodig om accolades te zetten. Anders wordt $s.subject- in zijn geheel met liggend streepje als variabele herkend en deze bestaat uiteraard niet.
In Juel wordt alles tussen het dollarteken gevolgd door accolades als script geëvalueerd. Vb. ${teller > 1}. Geeft true terug indien de teller variabele groter is dan 1

Enkel goed opletten wanneer een waarde uit een map gehaald wordt. Bij velocity wordt de ‘get’ method gebruikt, bij Juel wordt de key tussen vierkante haakjes gezet [‘key'].