Skip to main content
Skip table of contents

Card Production - Standard service tasks in Identity Manager

This article includes updates for Smart ID 23.04.2.

Card Production: Nexus GO Cards get info

Description

Use this task to perform "GET requests" towards the Nexus GO Cards ordering API and extract any attributes from the response.

Configuration

To use this task, configure the following delegate expression in your service task:

CODE
${caasRestClientAction}

The parameters in the examples below can be configured in Identity Manager Admin.

Nexus GO Cards Ordering API

All the attributes that you want to extract have to match the Nexus GO Cards schema exactly. See Nexus GO Cards ordering for more information.

Important details

  • All parameters that are included in the URL, for example {cardId}, {orderId}, {email}, must be defined with the prefix "param_" since some of these values are also returned in the server response. This variable will not be written to the process map.

  • All query parameters that you want to define must be prefixed with "queryParam_". If not defined, the default will be used. This variable will not be written to the process map.

Get order info:

Parameter

Mandatory

Value

Description

URL

(tick) 

/api/order/{orderId}

The endpoint to call.

param_orderId

(tick) 

(for this endpoint)

Example value:

  • OD123

Will replace the {orderId} value from the URL.

costCentre

-

Example value:

  • costCentre_Output

Will add the variable with the name costCentre_Output to the process map. The value will be taken from the response body.

orderer.email

-

Example value:

  • ordererEmail_Output

Will add the variable with the name ordererEmail_Output to the process map. The value will be taken from the response body.

cardIds

-

Example value:

  • cardIds_Output

Will add the variable with the name cardIds_Output to the process map as a list. The value will be taken from the response body.

accessories.articleId

-

Example value:

  • accessories_articleIds_Output

Will add the variable with the name accessories_articleIds_Output to the process map as a list. The value will be taken from the response body.

Get available accessories:

Example: /api/accessory

Parameter

Mandatory

Value

Description

URL

(tick) 

/api/accessory

The endpoint to call.

queryParam_showDetails

-

Valid values:

  • true (default)

  • false

You can override the default query parameters by setting them yourself, or keep the default.

queryParam_languageId

-

Valid values:

  • DE

  • EN (default)

  • FR

  • SV

You can override the default query parameters by setting them yourself, or keep the default.

articleId

-

Example value:

  • articleId_Output

Will add the variable with the name articleId_Output to the process map as a list. The value will be taken from the response body.

price

-

Example value:

  • price_Output

Will add the variable with the name price to the process map as a list. The value will be taken from the response body.

Error cases

There are three major error cases:

  • Wrong URL

  • Mandatory parameter not defined, for example {cardId}

  • Resource not found, for example {cardId} does not exist

For these three error cases you will find two variables in the process map that describe what happened:

  • HTTP_STATUS_CODE

  • requestErrorMessage

You can use these variables to adjust your process flow accordingly.

Card Production: Server Side Card Operation

Description

Use this task to execute card productions on the server side. The service tasks supports execution of encodings via Card SDK or the JPKIEncoder integrated in Identity Manager. Printing is not supported.

Configuration

To use this task, configure the following delegate expression in your service task:

CODE
${serverSideCardOperationTask}

The following parameters can be configured in Identity Manager Admin:

Parameter

Mandatory

Value

Description

encodingName

(tick) 

Example value:

PcmEncProduceEmployeeCard

Name of the encoding description to be executed

cardSDK

-

Valid values:

  • true (default)

  • false

Flag to configure if the encoding should be executed through the Identity Manager server directly or through Card SDK. Default is true, which means that the encoding is executed through Card SDK.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.