Skip to main content
Skip table of contents

Error handling and extended error mode in Identity Manager

This article describes how you create descriptions for error handling.

An encoding description contains the information for the electronic personalization of a card. You import the encoding description from a file. This can be used in Smart ID Identity Manager

When an error occurs during an encoding, the default behaviour is to abort the encoding process. In this case, the JPKIEncoder will not return the field list with read values (like chip serial number, Integrated Circuit Card Serial Numbers (ICCSN), generated keys or certificates) but an error response, consisting of a numeric identifier and a description. However, in some use cases, the calling application needs to know the progress of the encoding process prior to the error. In this case, the Extended Error Mode can be activated and configured in the encoding description.

Using the extended error mode has the following effects in case of an error:

  • The JPKIEncoder returns a Success status response
  • Any values from the field list that were already set during the encoding are returned
  • The following additional information can be returned:
    • The status/error code
    • The status/error message
    • All steps expected to execute
    • The steps actually executed

Using this extended error mode does not return an error response as usual, but returns a success instead and the actual error as fields in the JPKIEncoder's field list.

  • Define like this in the encoding description:

    CODE
    [Fields]
    ResponseStatusId=
    ResponseStatusText=
    EncodingStepsAll=
    EncodingStepsDone=
     
    [Description]
    ExtendedErrorMode=APPLY_ON_APP_ERRORS_ONLY
    ResponseStatusIdField=ResponseStatusId
    ResponseStatusTextField=ResponseStatusText
    EncodingStepsAllField=EncodingStepsAll
    EncodingStepsDoneField=EncodingStepsDone
     
    [Application_A]
    EncodingStep=WriteAuthCert
     
    [Application_B]
    EncodingStep=WriteCertList

    Description of the elements:

    ElementDescription
    ExtendedErrorModeActivates the extended error mode. Possible values are:
    • APPLY_ON_ALL_ERRORS apply the mode on any error.
    • APPLY_ON_APP_ERRORS_ONLY do only apply the extended error mode, when the error occurs when writing an application. There are some typical errors like finding no card or error on initializing the card which are handled by the Identity Manager framework in typical ways. The extended error mode's primary intention is even the detection of partially valid cards which must be recognized and handled by the application.

    ResponseStatusIdField

    The field to hold the error code. In case of success, the field value is never set, but only if an actual error happens.

    ResponseStatusTextField

    The field to hold the description text of the error.
    EncodingStepsAllFieldThe field to hold all steps expected to execute, separated by commas.
    EncodingStepsDoneFieldThe field to hold all steps that actually executed, separated by commas. In case of success, the value will be the same as in EncodingStepsAllField.
    EncodingStepThe name under which each application will appear in the EncodingStepsAllField and EncodingStepsDoneField.

Related information

JavaScript errors detected

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

If this problem persists, please contact our support.