Nuevas adiciones y cambios new-additions-and-changes
Describe cambios nuevos e implementados para la API IPS 4.0.
Se han implementado versiones de API en paralelo con WSDL y áreas de nombres de esquema independientes.
- Versiones de API anteriores:
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
. - Versión de SPS 4.0:
IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.
Se agregó el campo PostScriptOptions/alpha
.
Se agregaron las propiedades VideoRootUrl
y SwfRootUrl
para la operación getProperty
.
Se agregaron appName
y appVersion
parámetros opcionales a authHeader
para realizar el seguimiento de la aplicación que realiza la llamada. Se agregó el registro a ipsApiService.log
.
Se ha agregado un parámetro serviceUrl
opcional al servlet de generación de WSDL. Este parámetro es útil para depurar proxies. Por ejemplo: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Se implementó la operación getZipEntries
.
Se implementaron rangos de búsqueda y valores de comparación ingresados para las condiciones de campo del sistema.
Se agregó 'Asset'
constante de cadena de tipo de recurso, principalmente para permitir campos de metadatos entre recursos.
Se implementó el parámetro trashState
para searchAssets
.
Se implementó la operación getAssetPublishHistory
.
SOAP Se ha agregado el encabezado opcional faultHttpStatusCode
de la para habilitar la administración de errores en Flex. Para Flex, use <faultHttpStatusCode>200</faultHttpStatusCode>
. El código de estado predeterminado para las respuestas de errores es 500 (Internal Server Error)
.
Se han añadido operaciones para restaurar recursos de la papelera y vaciar recursos de la papelera.
Implementó operaciones de CRUD.
Se agregó la marca habilitada al tipo ImageMap
y a la operación saveImageMap
.
Se ha agregado compatibilidad con los trabajos de Optimizar archivos restantes.
Se agregó setAssetsPublishState
para actualizaciones de estado de publicación en lotes.
Se agregó ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
.
Operación saveMetadataField
obsoleta en favor de nuevas operaciones createMetadataField
y updateMetadataField
.
Se implementó deleteAssetsParam
operación de eliminación por lotes.
Se implementó la operación de movimiento por lotes de moveAssetsParam
.
Se implementó la operación deleteMetadataField
.
Se implementaron get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
operaciones.
Se implementó getAssetCounts
.
Se agregó compatibilidad con setImageSetMembers
para incluir RenderSet
miembros en ImageSet
recursos.
Se agregó la operación replaceImage
.
Se agregó la operación copyImage
.
Se agregaron la operación setUrlModifier
y urlModifier/urlPostApplyModifier
campos para LayerViewInfo
, TemplateInfo
y WatermarkInfo
.
Se agregó la operación createDerivedAsset
. Actualmente, ownerHandle
debe hacer referencia a un recurso de imagen y el tipo puede ser AdjustedView
o LayerView
.
Se agregó la operación createTemplate
. Llame a para crear recursos de plantilla o marca de agua.
Configuración de empresa de IPS, CompanySettings
, transferida a la API de servicios web.
Se agregó el indicador de filtro excludeByproducts
a la operación searchAssets
. Si se establece este indicador como verdadero, se ejecutan PSDlayer
imágenes y el PDF copió imágenes.
Se agregó la operación getGenerationInfo
.
Se agregó el nombre de propiedad SystemMessage
a la operación getProperty
.
Se han modificado algunas constantes de cadena de tipo de recurso para que coincidan con los campos de información de recurso correspondientes.
- WordDoc: Word
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: Rtf
Se ha modificado el formato de resultado de las operaciones por lotes para resumir el éxito, las advertencias y los errores.
Se implementó la operación de metadatos por lotes batchSetAssetMetadata
.
Se ha implementado compatibilidad con datos específicos de la aplicación.
Se ha implementado compatibilidad con indicadores booleanos para createTemplate
, extendLayers
y extractText
para trabajos de carga para controlar el proceso de procesamiento de Photoshop (similar a los cambios para agregar cargas de archivos).
Se implementaron setImageMaps
y setZoomTargets
operaciones.
Se implementaron ViewerPreset
operaciones. Los tipos reconocidos son:
VideoPlayer
(el vídeo solo publica estos visores).Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
Las máscaras del visor admiten dos parámetros: skinFg
y skinBg
. El código back-end realiza todo el procesamiento necesario para mantener la compatibilidad con versiones anteriores.
Se implementó la operación getAssociatedAssets
.
Se ha agregado el tipo de trabajo ReprocessAssets
para permitir el reprocesamiento de archivos de origen principales cargados anteriormente, incluida la reextracción de PDF y la reoptimización de imágenes.
Se cambió el nombre del tipo de campo PropertySetType
a propertyType
. Este cambio de nombre afecta al parámetro createPropertySetType
y a la respuesta getPropertySetType/getPropertySetTypes
.
Se implementó la operación batchSetImageFields
para admitir la configuración de datos de usuario de imagen y otros campos de imagen editables.
47 Se ha agregado el campo fileSize a varios tipos de información de recursos:
VignetteInfo
CabinetInfo
WindowCoveringInfo
IccProfileInfo
FontInfo
XslInfo
ViewerSwfInfo
XmlInfo
SvgInfo
ZipInfo
VideoInfo
AcoInfo
PdfInfo
PsdInfo
FlashInfo
InDesignInfo
PostScriptInfo
IllustratorInfo
WordInfo
ExcelInfo
PowerPointInfo
IllustratorInfo
WordInfo
ExcelInfo
PowerPointInfo
RTFInfo
Se implementó la operación getActivePublishContexts
. Esta operación devuelve una matriz de nombres de contexto de publicación con servidores de publicación activos para la empresa especificada. Los nombres de contexto de publicación actuales son:
ImageServing
ImageRendering
Video
Se implementó la operación getSearchStrings
. Devuelve una matriz de cadenas de búsqueda para el recurso determinado.
Se han agregado parámetros de configuración regional para trabajos y un mecanismo para establecer la configuración regional de operaciones de API. La cadena de configuración regional debe tener el formato <language_code>[-<country_code>]
. El código de idioma es un código en minúsculas de dos letras como se especifica en la norma ISO-639, y el código de país opcional es un código en mayúsculas de dos letras como se especifica en la norma ISO-3166.
SOAP Se ha agregado un parámetro de configuración regional opcional al encabezado authHeader
para establecer la configuración regional para las operaciones de la API. Si este parámetro no está presente, se utiliza el encabezado HTTP Accept-Language
. Si este encabezado tampoco está presente, se utilizará la configuración regional predeterminada del servidor IPS.
Se ha agregado la compatibilidad de obtener/establecer para campos de metadatos con establecimiento inflexible de tipos.
SOAP Se ha implementado compatibilidad con encabezados HTTP y de para el control de respuesta gzip.
Se agregó la marca gzipResponse
a authHeader
. Si no está presente, la API comprueba el encabezado HTTP Accept-Encoding
.
Se ha agregado compatibilidad para buscar recursos en condiciones de campo de metadatos con establecimiento inflexible de tipos.
- Para todos los tipos de campo, el valor se puede pasar con un operador de comparación de cadenas (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
) - Para los campos booleanos,
boolVal
se puede pasar con la operaciónEquals
. - Para los campos Ent,
longVal
se puede pasar con un operador de comparación numérica (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ominLong/maxLong
con operaciones de intervalo numérico (Between, NotBetween
). - Para los campos Flotante,
doubleVal
se puede pasar con un operador de comparación numérica (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ominDouble/maxDouble
con operaciones de intervalo numérico (Between, NotBetween
). - Para los campos Fecha, puede pasar
dateVal
con un operador de comparación numérica (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) o minDate/maxDate con operaciones de intervalo numérico (Between, NotBetween
).
Se agregaron los campos de descripción jobSubType
y originalJobName
al tipo JobLog
.
originalJobName
es el nombre de trabajo enviado asubmitJob
(sin sufijos de exclusividad ni nombres de trabajo de seguimiento).jobSubType
solo lo usanImageServingPublishJob
trabajos (donde es uno defull
,increment, fullwithsearch,
ofulloverride
).description
es una cadena vacía para todos los tipos de trabajos, pero finalmente contiene información de trabajo de resumen, como la ruta de carga.
Además, los campos siguientes no se incluyen con getJobLogs
y getJobLogDetails
. En versiones anteriores, solo estaban disponibles con getJobLogDetails
.
endDate
(si el trabajo se ha completado).fileDuplicateCount
(anteriormente siempre era0
congetJobLogs
)fileUpdateCount
(anteriormente era siempre0
congetJobLogs
e incluido enfileSuccessCount
; ahora se divide en campos separados).
Se agregó el campo assetHandle al tipo JobLogDetail
.
Se agregó un parámetro de descripción opcional a submitJob
. Este parámetro se pasó para su recuperación en getScheduledJobs
, getActiveJobs
y getJobLogs
.
Obsoleto en el campo del sistema SKU. El campo se omitirá si se pasa como SystemFieldCondition
a searchAssets
.
Se agregó el filtro excludeAssetTypeArray
a searchAssets
.
Se agregó el tipo MaskInfo
a Asset
.
Se agregaron nuevos tipos de recursos para la administración por IPS:
Se agregaron opciones adicionales a UploadDirectoryJob
y UploadUrlsJob
para controlar el procesamiento de archivos Postscript, Illustrator y PDF de forma independiente. Todos los trabajos existentes proporcionan los parámetros necesarios a cada una de las tres canalizaciones de procesamiento para que funcionen exactamente como se hacen hoy. El bloque PostScriptOptions
original se usa para establecer el procesamiento de los archivos de Illustrator y EPS/PS. De forma opcional, se pueden proporcionar bloques de opciones de archivo específicas para especificar el procesamiento. La lista de cambios incluye:
-
Ninguno
-
Rasterizar (predeterminado)
-
Administre únicamente el recurso y no cree ningún derivado al cargar.
-
Procese el archivo EPS y PostScript en una imagen con la resolución y el espacio de color prescritos.
alfa
Opcional.
- Ninguno
- Rasterizar (predeterminado)
-
Administre únicamente el recurso y no cree ningún derivado al cargar.
-
Procese el archivo en una imagen con la resolución y el espacio de color prescritos.
alfa
Opcional.
-
Ninguno
-
Rasterizar (predeterminado)
-
Administre únicamente el recurso y no cree ningún derivado al cargar.
-
Procese el archivo en una imagen con la resolución y el espacio de color prescritos.
También puede realizar consultas desde getScheduledJobs
.
Se ha modificado la propiedad de configuración webservice.gzip.response
para que tome uno de los siguientes valores: