- Created by Ann Base, last modified on Mar 15, 2023
This article includes updates for Smart ID 22.04.2.
Expand/Collapse All
Use this task to create a request for the IN Groupe connector and place it in the process map. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Example value: Example value: Example value: statusAfterExport - Example value: - Example value: The configuration file is needed for Identity Manager to know which tag of the IN Groupe request schema should be mapped with the corresponding value from the core object. Format the configuration file as a .properties file. To set the value of a tag, specify the type name of the parent tag and the tag you want to modify, for example: The value can also be a juel expression which is available in the process map. If the expression can not be resolved it will result in an empty string. Expressions that are always available: To set the "reference" attribute that is needed for, for example, "DataType", configure as follows: The part after the "|" symbol represents the reference value. Use this task to read all IN Groupe report files from a folder and update any cards found inside. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Example value: Example value: Example value: ConfigurationFilePath Example value: Example value: Example value: The name of the field that references a map, containing all the available mappings between a request status and a card status. Note: The card status values must be present in the state graph, and the transitions from one state to another must be valid. The configuration file is needed for Identity Manager to know, which field of the IN Groupe report schema should be mapped with the corresponding value from the core object. The configuration file has to be formatted as a .properties file. To set the value of a tag, you specify the type name of the parent tag and the tag you want to modify (EntRecType_unRef in the example below). And, on the right side of the equals we have the datapool and the field where the value needs to be written (Card_UniqueReference in the example below). In the import mapping you also have constructs referring to complex objects from a list. To set the "reference" attribute that is needed for, for example, "InfoType", configure as follows: The left part of the "|" symbol shows the "InfoType" tag, which is a list containing some complex objects. The right part of the "|" symbol identifies which complex objects you will take the value from, for example "Serial_Number_CT". The value will then be added to the "CardNumber" field of the Card datapool. Use this task to create an .ics file and store it in the data map. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Value Example value: Valid values: See following example as a reference: Use this task to create a pdf and store it in the datamap. The pdf will be generated from a Jasper Reports template. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: The name of the Jasper Report. Must be available in Identity Manager Admin. It can also be a JUEL Expression (for example, ${myDatapool_myReportNameField}. In this way, the template names from the process map are used dynamically. Use this task to take a valid URL from the datamap and generate a QR code from it. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: QRCodeLinkField Example value: QRCodeOutputField Example value: Use this task to export a binary file from the datamap into a file location on the hard drive (Server side). To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Example value: Example value: Example value: Use this task to export an image from the datamap into a file location on the hard drive (Server side). The file extension will be automatically set depending on the image format. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Example value: Example value: Example value: Use this task to define a ParametrizedAction which is capable of downsizing pictures inside of a Process. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Defines the maximum size the output file shall be. When the resize doesn't lead to the desired size, the action will perform a quality shrink (defined by spring parameter "qualityStep") as long as the size matches the size given by this parameter. Valid values: Boolean flag which indicates weather the aspect ratio of the image should be kept or not. This is a flowchart of the task: Use this task to import all rows from a CSV file as core objects. The following must apply: Whenever there is a problem with the import, no objects will be imported at all. An exception will be thrown with a message identifying the row or even the cell that caused the problem. This message will be logged, too. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Valid values:: The core template name which should be used for the new core objects. This should be based on a DAO based Datapool. This can be used to limit the number of core objects. If it's set and there are more entries in the CSV, an Exception will be thrown. Same as for createdCoreObjectDescriptorListVarName except that the list will contain the modified core objects. When you configure the same name as for createdCoreObjectDescriptorListVarName the resulting list will contain descriptors for both types of core objects: newly created as well as modified. Specifying a mapping provides manifold possibilities to configure the content of the CSV file. Without a mapping the following restrictions apply: The delimiter must be a comma. The format for dates must be dd-mm-yyyy. Also consider this: If you need to use this service task, please contact Nexus. Use this task to validate the uploaded photos. This task is compatible with FaceVACS-SDK 9.4.0. Follow these steps: To use this task, configure the following delegate expression in your service task: The FRSDK configuration file have to be configured in the faceVACSObjectsCreater bean (needed at runtime). This file can be located in "%INSTALLDIR%/etc/frsdk.cfg". The following parameters can be configured in Identity Manager Admin: Valid values: Valid values: Valid values: Valid values: Valid values: Valid values: Valid values: Valid values: Valid values: Use this task to call a rest endpoint from a BPMN process in Identity Manager, for example, to push certificate, card or user data to a REST end point of a third party system. This service task will always send a POST request. The service task will compile the resolved data into an XML, similar to the format used in the REST Process API: Only the extra parameters of the service task will be added to the request body (see the table below). You need to add the fields you want to export as parameters by clicking the + button next to the service task and adding the parameters with values. The password field will be hidden with dots in Identity Manager Admin. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Url Any String or JUEL expression username Any String or JUEL expression The username for the HttpBasicAuth. password Any String or JUEL expression This will be a secret field containing the password for the HttpBasicAuth. myfield01 Any String or JUEL expression This parameter is added as shown in the example above and will be added to the request body. myCertificate01 Any String or JUEL expression This parameter is added as shown in the example above and will be added to the request body. These are the accepted status codes and reactions: 202 and 204 are not recognized as success and cause an exception. Use this task to generate a random GUID and store it in the data pool. To use this task, configure the following delegate expression in your service task: The following parameters can be configured in Identity Manager Admin: Example value:Description
Configuration
${createINGroupeRequestParameterizedTask}
Parameter Mandatory Value Description CoreObjectListFieldName Name of the variable in the process map, which contains a list of CoreObjectDescriptors, that should be used to create the request. OutputFieldName Name of the variable in the process map, where the request xml should be output to. ConfigurationFilePath Absolute file path of the configuration file, that should be used to create the request. The configuration file needs to be encoded in UTF-8, to ensure language specific characters are displayed correctly. Status that a card can take when the exporting was successfully done. statusOnError Status that a card can take when the exporting was not successfully done. Configuration file
BatchRequestType_globalSchema = DEMANDES_2.1.XSD
CardType_DataType|Numero_carte = 123456789
Description
Configuration
${importINGroupeReportsParameterizedTask}
Parameter Mandatory Value Description InputFolder The folder which contains all the XML files. ImportedFolder The folder which stores already imported XML files. ProblemFolder The folder which contains XML files that could not be imported. The absolute path to the mapping file. UniqueFieldName The name of the field by which each card can be identified. StatusMappingFieldName Configuration file
EntRecType_unRef = Card_UniqueReference
InfoType|Serial_Number_CT = Card_CardNumber
Description
Configuration
${createIcsFileParametrizedTask}
Parameter Mandatory Description subject The subject of the event. location The location of the event. startTime The start time of the event. endTime The end time of the event. targetField - Specified where the .ics file shall be stored in the data map. allDayEvent - If set to "true" the event will be shown as an allDay event. content Defines the content of the event. Description
Configuration
${generatePdfParametrizedTask}
Parameter Mandatory Value Description reportName fieldName The datamap field to which the pdf will be stored (as a byte[]). Description
Configuration
${generateQRCodeTask}
Parameter Mandatory Value Description Describes the data map field in which the link is stored to create a QR code from. The name of the output field to which the QR code ("jpg", byte[]) will be stored. Description
Configuration
${exportBinaryParametrizedTask}
Parameter Mandatory Value Description exportFilePath Defines the folder into which the binary file shall be exported. exportFileName Defines the name of the exported binary. exportDataMapTargetField Defines the datamap field from which the action should export the binary file. Description
Configuration
${exportImageJavaDelegate}
Parameter Mandatory Value Description exportFilePath Defines the folder into which the image shall be exported. exportFileBaseName Defines the base of the exported image. The export will append a time stamp so that it will result in, for example: John_Doe_2019-11-20_10-52-19.jpg exportDataMapTargetField Defines the datamap field from which the action should export the image. Description
Configuration
${resizeImageJavaDelegate}
Parameter Mandatory Default value Description dataPoolSourceField The datapool field in which the source image is stored. dataPoolTargetField The datapool field in which the target image shall be stored. imageWidthInPx The desired image width of the target image in px. imageHeightInPx The desired image height of the target image in px. maxBinarySizeInKB - keepRatio qualityDescreaseStep - 0.05 Indicates the quality decrease step when trying to minimize the quality to reach the desired maxBinarySizeInKB. Description
Configuration
${importIdentitiesFromCSVTask}
Parameter Mandatory Value Description csvField The field which contains the CSV file as byte array. You can use a Binary Field or a Variable Binary Field. targetCoreTemplateName commaSeparatedListOfUniqueIdentifiers Comma separated list of the fields which identify one unique core object. maxNumberOfEntriesInCSV createdCoreObjectDescriptorListVarName When used, the variable with the configured name will contain a list of CoreObjectDescriptors after the execution. The list describes the core objects that had been newly created by the action. Thus it's possible to perform subsequent operations on those core objects later in the process. updatedCoreObjectDescriptorListVarName mapping errorMessageField ErrorMessage If this field is provided and an error occurs, a message containing the cause is not only logged but additionally put into the variable with the specified name. Description
Configuration
${cognitecFaceVACSValidationParametrizedTask}
<bean id="cognitecFaceVACSValidationParametrizedAction" class="de.vps.act.action.photo.validation.CognitecFaceVACSValidationParametrizedAction">
<property name="faceVACSChecker">
<bean class="de.vps.act.action.photo.validation.FaceVACSChecker">
<property name="faceVACSObjectsCreator" ref="faceVACSObjectsCreator" />
</bean>
</property>
</bean>
<bean id="faceVACSObjectsCreator" class="de.vps.act.action.photo.validation.FaceVACSObjectsCreator">
<constructor-arg value="C:/FVSDK_9_4_0/etc/frsdk.cfg" />
</bean>
Parameter Mandatory Value Description outputFieldName On which variable the result of checking will be available in data map. photoFieldName Photo field name in data map. checkColor - Returns true if the portrait characteristics are based on color and false if they are based on Gray scale (intensity) image. checkNaturalSkinColour - Natural colours in face region. Returns true if the face region has natural colors, otherwise false. checkFrontal - The face is considered frontal if the rotation of the head is less than +/-5 degrees from frontal for yaw and pitch and if roll angle of head is less then +/-8 degrees. checkEyesOpen - Returns true if both eyes of the person are open. checkEyesGazeFrontal - Returns true if the person’s eyes are looking frontal to the camera. checkEyesNotRed - Returns true if both eyes pupils are not detected as red. checkNoTintedGlasses - According to ISO 19794-5:2005 section 7.2.11 and best recommendations glasses should not be tinted. checkSharp - Returns true if the face area (from chin to crown and from left to right ear) fits the focus and depth in field characteristics(see ISO 19794-5:2005 section 7.3.3). checkMouthClosed - Returns true if mouth is closed according to ISO 19794-5:2005 section 7.2.3 and appendix A 2.2.1 Description
<data>
<field name="myField01">value01</field>
<field name="myCertificate01">Base64EncodedBinary01</field>
</data>
Configuration
${restCallTask}
Parameter Mandatory Value Description The URL endpoint where the data will be sent. Accepted status codes
Status code Reaction 200 Success 300 No exception and no reaction inside code 400 Throws Htppclientexception 500 Throws BPMNError Description
Configuration
${generateGUIDForEntityParameterizedTask}
Parameter Mandatory Value Description GuidDataPoolField Which data pool field to store the GUID in.