submitActions

Submits the specified list of actions for later synchronization and the order of the actions in the array is significant. If an action is rejected during validation no operations are executed. If a failure occurs executing a valid action, processing stops at that point.

For Java:

Copy 
String[] submitActions(WalletId walletId, Action[] actions, String owner)
throws NoSuchWalletException, NoSuchSecurityModuleException, SecurityModuleNotBoundException, InvalidActionException, SessionException, ManagementException, LocalizedRemoteException;

For C++:

Copy 
TStringVector *submitActions(WalletId *walletId, ActionVector *actions, TString owner);

Parameters:

  • walletId—Unique identifier of the wallet on which the actions are to be performed.

  • actions—List of actions to be performed. See type in Wallet Manager Classes for a list of the action types.

    • List of runtime parameters:

    • ACTION_RUNTIME_PARAM_PIN— device PIN used for ISSUANCE, PRODUCE and PINUNLOCK action type

    • ACTION_RUNTIME_PARAM_REASON—remplacement reason used for ISSUANCE or PRODUCE action type

  • owner—(unused).

Runtime Parameters

The device produce action type can perform GlobalPlatform device locking at the end of a security module production. This optional capability is controlled using an optional runtime parameter. The parameter name/value pair should be one of the following:

  • ACTION_RUNTIME_PARAM_LOCK = ACTION_RUNTIME_PARAM_VALUE_TRUE

or

  • ACTION_RUNTIME_PARAM_LOCK = ACTION_RUNTIME_PARAM_VALUE_FALSE

If no ACTION_RUNTIME_PARAM_LOCK parameter is supplied at action submission time, then the default behavior is to not lock the security module.

Returns:

  • List of wallet action IDs for the actions created.

If an action concerns the issuance or post-issuance of a MOBILE device, its corresponding string is supplemented by the URL to call to issue the mobile device. That URL is separated from the action identifier by a semicolon.

Exceptions:

  • NoSuchWalletException— if the wallet ID specified does not identify a valid wallet.

  • NoSuchSecurityModuleException— if one or more of the action(s)’ specified security module(s) that were not found.

  • SecurityModuleNotBoundException— if one or more of the action(s)’ specified security module(s) were not bound to the specified wallet.

  • InvalidActionException— if either the enrollment data or parameters of an action were invalid.

  • SessionException— if there is no valid session (such as session not opened or timed out).

  • ManagementException— if an internal failure occurs.

  • LocalizedRemoteException— (thrown by the Web service layer) only when the most severe, unexpected, SOAP-level failures occur.