Documentación API del sistema de producción de imágenes Dynamic Media

batchSetImageFields

Última actualización: 22 de julio de 2024

Temas:

Creado para:

Desarrollador
Administrador

Establece campos específicos de la imagen para uno o varios recursos de imagen.

Sintaxis

Tipos de usuarios autorizados

IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser

Parámetros

Entrada (batchSetImageFields)

Nombre	Tipo	Obligatorio	Descripción
companyHandle	`xsd:string`	Sí	El identificador de la compañía que contiene los recursos de imagen.
updateArray	`types:ImageFieldUpdateArray`	Sí	La matriz de actualizaciones de campo de imagen.

Salida (batchSetImageFields)

Nombre	Tipo	Obligatorio	Descripción
successCount	`xsd:int`	Sí	El número de campos de imagen definidos correctamente.
warningCount	`xsd:int`	Sí	El número de advertencias generadas cuando la operación intentó establecer los campos de imagen.
errorCount	`xsd:int`	Sí	El número de errores generados cuando la operación intentó establecer los campos de imagen.
warningDetailArray	`types:AssetOperationFaultArray`	No	Matriz de detalles asociados con los recursos que generaron advertencias cuando la operación intentó aplicar las actualizaciones.
errorDetailArray	`types:AssetOperationFaultArray`	No	Matriz de detalles asociados con los recursos que generaron errores cuando la operación intentó aplicar las actualizaciones.

Ejemplos

En este ejemplo se establecen los datos de los campos de dos imágenes de una matriz de actualización. En la matriz, las imágenes se especifican mediante sus controladores de recursos y contienen resolución en píxeles, coordenadas de anclaje de posición x e y y datos de usuario. La respuesta indica que los campos de ambas imágenes se configuraron correctamente.

Solicitud

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

Respuesta

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

recommendation-more-help