commitCredentialTransaction

Note: Make sure that the transaction is valid and that all steps in the credential transaction processing have been completed before calling this method.

This completes the credential transaction specified by supplied transaction ID. This is done by committing a credential transaction to complete the creation/update of the credential associated with the specified transaction. The final call in the offline-unlock process is commitCredentialTransaction().

For the offline-unlock process, each CredentialID in the array returned from the commit is the identifier of a credential with the following attributes set:

  • id—Matches the CredentialId passed in to the original operateCredential method.

  • credentialElements—Empty array (not null).

  • profileId—ConfigurationId used to represent a CredentialProfileId.

  • description—String.

For Java:

Copy 
CredentialId[] commitCredentialTransaction(TransactionId txId)
throws NoSuchTransactionException, TransactionIncompleteException, SessionException, ManagementException, LocalizedRemoteException

For C++:

Copy 
CredentialIdVector *commitCredentialTransaction( TransactionId *txId)

Parameters:

txId—transaction identifier within which the credential was created/updated.

Returns:

A list with one or more credential identifiers depending upon how the transaction was initiated.

Exceptions:

  • NoSuchTransactionException—if the specified transaction identifier is not found.

  • TransactionIncompleteException—if the transaction was not completed.

  • 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.