setAssetSetDefinition
Updates the set definition for an existing Asset Set.
Syntax
Authorized User Types
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
Parameters
Input (setAssetDefinitionParam)
xsd:string
xsd:string
xsd:string
Output (setAssetSetDefinitionReturn)
The IPS API does not return a response for this operation.
setDefinition Parameter: About
setDefinition Functions
Specify setDefinition
substitution functions in-line. These are resolved during a catalog lookup or on publication. Substitution strings have the format ${<substitution_func>}
, and include the following:
([])
. The text outside of a substitution string gets copied to the output string during resolution.Catalog ID. Applies to image-based assets (Image, Adjusted View, Layer View).
For other assets, returns the thumb asset's catalog ID (if any). If no thumb asset is associated with the asset, the function returns an empty string.
setDefinition Examples
This media set definition string:
${getCatalogId([a|1664|22|1664])};${getCatalogId([a|1664|22|1664])};
1,${getFilePath([a|1036|19|144])};${getCatalogId([a|452|1|433])};2;
${getMetadata([a|1036|19|144], [m|1|ASSET|SharedDateField])}
Resolves to the following at lookup or publication time:
jcompany/myRenderSet;jcompany/myRenderSet;
1,jcompany/Videos/N08275_flv.flv;jcompany/myimg-1;2;20090703 10:05:53
Examples
Request
<setAssetSetDefinitionParam xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
<companyHandle>c|1</companyHandle>
<assetHandle>a|1802|44|1802</assetHandle>
<setDefinition>${getCatalogId([a|1553|1|1176])};${getCatalogId([a|1553|1|1176])};1;img1,
${getCatalogId([a|632|1|452])};${getCatalogId([a|632|1|452])};1,${getCatalogId([a|1664|22|1664])};
${getCatalogId([a|1664|22|1664])};1,${getFilePath([a|1036|19|144])};${getCatalogId([ a|452|1|433])};
2;${getMetadata([a1036|19|144], [m|1|ASSET|SharedDateField])}</setDefinition>
</setAssetSetDefinitionParam>
Response
None.