Obtém ativos associados a um ativo especificado e detalhes sobre seu relacionamento.
Sintaxe
IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser
Entrada (getAssociatedAssetsParam)
Nome |
Tipo |
Obrigatório |
Descrição |
---|---|---|---|
companyHandle |
xsd:string |
Sim |
Lidar com a empresa proprietária do ativo. |
assetHandle |
xsd:string |
Sim |
Identificador de ativos. |
responseFieldArray |
tipos:StringArray |
Não |
A matriz de campos de resposta desejada. Consulte response- FieldArray/excludeFieldArray na introdução. |
excludeFieldArray |
tipos:StringArray |
Não |
A matriz de campos de resposta excluídos. Consulte response- FieldArray/excludeFieldArray na introdução. |
Saída (getAssociatedAssetsReturn)
Nome |
Tipo |
Obrigatório |
Descrição |
---|---|---|---|
containerArray | tipos:AssetArray | Não |
Matriz de ativos de conjunto e modelo que contêm o ativo especificado. |
memberArray | tipos:AssetArray | Não |
Matriz de ativos contidos pelo conjunto ou ativo de modelo especificado. |
layerReferenceArray | tipos:AssetArray | Não |
Matriz de ativos referenciados em uma camada ou URL de modelo. |
ownerArray | tipos:AssetArray | Não |
Matriz de ativos proprietários do ativo especificado. |
derivadoArray | tipos:AssetArray | Não |
Matriz de ativos que foram usados para gerar o ativo especificado. |
generatorArray | tipos:GenerationInfoArray | Não |
O geradorArray lista a forma como este ativo foi criado. Por exemplo, se assetHandler fosse uma página de imagem de um PDF, isso conteria a ferramenta de processador PDF e referenciaria o ativo PdfFile. |
generateArray | tipos:GenerationInfoArray | Não |
O generateArray inverte a forma como este ativo foi criado. Por exemplo, generateArray poderia conter a lista de imagens geradas a partir deste assetHandler se esse fosse um ativo PdfFile. |
thumbAsset | tipos:Ativo | Não |
As informações do ativo miniatura associadas ao ativo de solicitação. Se nenhum ativo de miniatura for atribuído, o campo será omitido na resposta. |
Você pode usar os parâmetros responseFieldArray
ou excludeFieldArray
para limitar o tamanho da resposta. Especificamente, os itens GenerationInfo
retornados no padrão generatorArray
ou generatedArray
para incluir os registros do originador e do ativo gerado. Para um tipo de ativo PDF, esse comportamento resulta em várias cópias indesejadas do registro de ativo PDF "originador" na resposta. Você pode eliminar esse problema adicionando generatedArray/items/originator
a excludeFieldArray
. Ou você pode especificar uma lista explícita dos campos de resposta que deseja incluir em responseFieldArray
.
O exemplo básico a seguir é uma solicitação para o identificador do gerador para uma imagem extraída de um PDF. Inclui um containerArray
de comprimento um com um item que inclui o assetHandle
do PDF.
Solicitação
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:beta="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
<soap:Body>
<beta:getAssociatedAssetsParam>
<beta:companyHandle>c|11</beta:companyHandle>
<beta:assetHandle>a|197</beta:assetHandle>
<beta:responseFieldArray>
<beta:items>containerArray/items/assetHandle</beta:items>
</beta:responseFieldArray>
</beta:getAssociatedAssetsParam>
</soap:Body>
</soap:Envelope>
Resposta
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
<soapenv:Body>
<getAssociatedAssetsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
<containerArray>
<items>
<assetHandle>a|207</assetHandle>
</items>
</containerArray>
</getAssociatedAssetsReturn>
</soapenv:Body>
</soapenv:Envelope>
O inverso do exemplo acima é o seguinte:
Solicitação
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:beta="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
<soap:Body>
<beta:getAssociatedAssetsParam>
<beta:companyHandle>c|11</beta:companyHandle>
<beta:assetHandle>a|177</beta:assetHandle>
<beta:responseFieldArray>
<beta:items>generatedArray/items/originator/assetHandle</beta:items>
</beta:responseFieldArray>
</beta:getAssociatedAssetsParam>
</soap:Body>
</soap:Envelope>
Resposta
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
<soapenv:Body>
<getAssociatedAssetsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
<generatedArray>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
<items>
<originator>
<assetHandle>a|177</assetHandle>
</originator>
</items>
</generatedArray>
</getAssociatedAssetsReturn>
</soapenv:Body>
</soapenv:Envelope>
Neste próximo exemplo, um grupo é adicionado a uma empresa com groupHandleArray
. Este exemplo usa apenas um grupo.
Solicitação
<ns1:addGroupMembershipParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
<ns1:companyHandle>47</ns1:companyHandle>
<ns1:groupHandleArray><ns1:items>225</ns1:items></ns1:groupHandleArray>
</ns1:addGroupMembershipParam>
Resposta
Nenhum.