AI_PollForAssetMetaData

The AI_PollForAssetMetaData web service polls the status of a request for the metadata and entitlement status of one or more assets. It uses the handle returned by a prior call to either of the following:

• AI_InitiateAssetMetaData
• AI_GetMultipleAssetMetaData

If the asset metadata request is completed, AI_PollForAssetMetaData returns an HTTP-based URL to a ZIP file that contains the information. You can then retrieve the actual ZIP file using an HTTP request.

A ZIP file created by a call to AI_InitiateAssetMetaData remains available until AI_AcknowledgeAssetMetaData is called using the same handle. This allows you to retrieve the ZIP file again if an error occurs during transit.

However, a ZIP file created by a call to AI_GetMultipleAssetMetaData always remains available until it is manually deleted. AI_AcknowledgeAssetMetaData does not operate on files with handles generated by AI_GetMultipleAssetMetaData.

Inputs

• customerId - A String that identifies the customer of the OLSA environment. This is the company short name (sname) provided by SkillSoft.
• handle - The handle of the asset metadata request for which to poll the status.

  If you want to poll for the results of a call to AI_GetMultipleAssetMetaData, this parameter is required. If you want to poll for the results of a call to AI_InitiateAssetMetaData, this parameter is optional.

  If you do not specify a value for this parameter, the web service polls for the status of the last call to AI_InitiateAssetMetaData. If no such call exists (in a submitted, running, or completed state), an exception is thrown.

Outputs

• HTTP-based URL to a ZIP file

Faults

The following table lists additional faults this service may produce, along with the error condition that causes the fault.