Documentação API do sistema de produção de imagens Dynamic Media

batchSetImageFields

20 de maio de 2023

Tópicos:

Criado para:

Desenvolvedor
Administrador

Define campos específicos de imagem para um ou mais ativos de imagem.

Sintaxe

Tipos de usuário autorizados

IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser

Parâmetros

Entrada (batchSetImageFields)

Nome	Tipo	Obrigatório	Descrição
companyHandle	`xsd:string`	Sim	O identificador da empresa que contém os ativos de imagem.
updateArray	`types:ImageFieldUpdateArray`	Sim	A matriz de atualizações de campo de imagem.

Saída (batchSetImageFields)

Nome	Tipo	Obrigatório	Descrição
successCount	`xsd:int`	Sim	O número de campos de imagem definidos com êxito.
warningCount	`xsd:int`	Sim	O número de avisos gerados quando a operação tentou definir os campos de imagem.
errorCount	`xsd:int`	Sim	O número de erros gerados quando a operação tentou definir os campos de imagem.
warningDetailArray	`types:AssetOperationFaultArray`	Não	A matriz de detalhes associados aos ativos que geraram avisos quando a operação tentou aplicar as atualizações.
errorDetailArray	`types:AssetOperationFaultArray`	Não	A matriz de detalhes associados aos ativos que geraram erros quando a operação tentou aplicar as atualizações.

Exemplos

Este exemplo define dados nos campos de duas imagens em uma matriz de atualização. Na matriz, as imagens são especificadas por seus identificadores de ativos e contêm a resolução em pixels, as coordenadas de âncora de posição x e y e os dados do usuário. A resposta indica que os campos de ambas as imagens foram definidos com êxito.

Solicitação

<batchSetImageFieldsParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <updateArray>
      <items>
         <assetHandle>a|140626|1|102524</assetHandle>
         <resolution>72</resolution>
         <anchorX>50</anchorX>
         <anchorY>100</anchorY>
         <userData>nada1</userData>
      </items>
      <items>
         <assetHandle>a|96680|1|64865</assetHandle>
         <resolution>150</resolution>
         <anchorX>100</anchorX>
         <anchorY>50</anchorY>
         <userData>nada2</userData>
      </items>
   </updateArray>
</batchSetImageFieldsParam>

Resposta

<batchSetImageFieldsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <successCount>2</successCount>
   <warningCount>0</warningCount>
   <errorCount>0</errorCount>
</batchSetImageFieldsReturn>

recommendation-more-help