Novas Adições e Alterações new-additions-and-changes
Descreve as alterações novas e implementadas para a API do IPS v4.0.
Versões da API lado a lado implementadas com WSDLs e namespaces de esquema separados.
- Versões anteriores da API:
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
. - Versão do SPS 4.0:
IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.
Adição do campo PostScriptOptions/alpha
.
Adicionadas as propriedades VideoRootUrl
e SwfRootUrl
da operação getProperty
.
Adicionados parâmetros appName
e appVersion
opcionais a authHeader
para rastrear o aplicativo de chamada. Adição de log a ipsApiService.log
.
Adição de um parâmetro serviceUrl
opcional ao servlet de geração WSDL. Esse parâmetro é útil para proxies de depuração. Por exemplo: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Implementou a operação getZipEntries
.
Intervalos de pesquisa implementados e valores de comparação digitados para condições de campo do sistema.
Adição da constante de cadeia de caracteres de tipo de ativo 'Asset'
, principalmente para permitir campos de metadados entre ativos.
Implementou o parâmetro trashState
para searchAssets
.
Implementou a operação getAssetPublishHistory
.
Adição do cabeçalho SOAP faultHttpStatusCode
opcional para habilitar o tratamento de falhas no Flex. Para Flex, use <faultHttpStatusCode>200</faultHttpStatusCode>
. O código de status padrão para respostas de falha é 500 (Internal Server Error)
.
Adição de operações para restaurar ativos da lixeira e esvaziar ativos da lixeira.
Operações CRUD implementadas.
Adição do sinalizador habilitado ao tipo ImageMap
e operação saveImageMap
.
Adição de suporte para os trabalhos Otimizar arquivos restantes.
Adicionado setAssetsPublishState
para atualizações de estado de publicação em massa.
Adicionado ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
.
Operação saveMetadataField
descontinuada em favor de novas operações createMetadataField
e updateMetadataField
.
Implementou a operação de exclusão em lote deleteAssetsParam
.
Implementou a operação de movimentação em lote moveAssetsParam
.
Implementou a operação deleteMetadataField
.
Implementou get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
operações.
Implementado getAssetCounts
.
Adicionado suporte a setImageSetMembers
para inclusão de RenderSet
membros em ImageSet
ativos.
Adicionada a operação replaceImage
.
Adicionada a operação copyImage
.
Adicionada a operação setUrlModifier
e os campos urlModifier/urlPostApplyModifier
para LayerViewInfo
, TemplateInfo
e WatermarkInfo
.
Adicionada a operação createDerivedAsset
. Atualmente, o ownerHandle
deve fazer referência a um ativo de imagem e o tipo pode ser AdjustedView
ou LayerView
.
Adicionada a operação createTemplate
. Chamada para criar ativos de Modelo ou Marca d'água.
Configurações da empresa de IPS, CompanySettings
, transferidas para a API de serviços da Web.
Adicionado o sinalizador de filtro excludeByproducts
à operação searchAssets
. Configurar este sinalizador como verdadeiro executa PSDlayer
imagens e PDF imagens extraídas.
Adicionada a operação getGenerationInfo
.
Adição do nome da propriedade SystemMessage
à operação getProperty
.
Foram modificadas algumas constantes da sequência de caracteres do tipo de ativo para corresponder aos campos de Informações do ativo correspondentes.
- WordDoc: palavra
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: Rtf
Formato de resultado modificado de operações em lote para resumir êxito, avisos e erros.
Implementou a operação de metadados em lote batchSetAssetMetadata
.
Implementação de suporte para dados específicos do aplicativo.
Implementação de suporte para sinalizadores booleanos para createTemplate
, extendLayers
e extractText
para trabalhos de carregamento para controlar o processo de processamento do Photoshop (semelhante a alterações para adicionar carregamentos de arquivo).
Implementou setImageMaps
e setZoomTargets
operações.
ViewerPreset
operações implementadas. Os tipos reconhecidos são:
VideoPlayer
(O vídeo só publica esses visualizadores.)Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
As capas do visualizador dão suporte a dois parâmetros: skinFg
e skinBg
. O código de backend faz todo o processamento necessário para manter a compatibilidade com versões anteriores.
Implementou a operação getAssociatedAssets
.
Adição do tipo de trabalho ReprocessAssets
para permitir o reprocessamento de arquivos de origem primários carregados anteriormente, incluindo a nova cópia de PDF e a reotimização de imagens.
Tipo de campo PropertySetType
renomeado para propertyType
. Essa renomeação afeta o parâmetro createPropertySetType
e a resposta getPropertySetType/getPropertySetTypes
.
Implementação da operação batchSetImageFields
para oferecer suporte à configuração de dados de usuário de imagem e outros campos de imagem editáveis.
47 Adição do campo fileSize a vários tipos de informações do ativo:
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
Implementou a operação getActivePublishContexts
. Esta operação retorna uma matriz de nomes de contexto de publicação com servidores de publicação ativos para a empresa especificada. Os nomes do contexto de publicação atual são:
ImageServing
ImageRendering
Video
Implementou a operação getSearchStrings
. Ele retorna uma matriz de sequências de caracteres de pesquisa para o ativo fornecido.
Adição de parâmetros de localidade para trabalhos e um mecanismo para definir a localidade para operações de API. A cadeia de caracteres local deve ser formatada como <language_code>[-<country_code>]
. O código de idioma é um código de duas letras em minúsculas, conforme especificado pela ISO-639, e o código opcional de país é um código de duas letras em maiúsculas, conforme especificado pela ISO-3166.
Adição do parâmetro de localidade opcional ao cabeçalho SOAP authHeader
para definir a localidade para operações de API. Se este parâmetro não estiver presente, o cabeçalho HTTP Accept-Language
será usado. Se esse cabeçalho também não estiver presente, o local padrão do servidor IPS será usado.
Adição de suporte get/set para campos de metadados fortemente tipados.
Implementação de suporte a cabeçalho SOAP e HTTP para controle de resposta gzip.
Adicionou o sinalizador gzipResponse
a authHeader
. Se não estiver presente, a API verificará o cabeçalho HTTP Accept-Encoding
.
Adição de suporte a searchAssets para condições de campo de metadados fortemente tipados.
- Para todos os tipos de campo, o valor pode ser passado com um operador de comparação de sequência (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
) - Para campos booleanos,
boolVal
pode ser passado com aEquals
op. - Para campos Int,
longVal
pode ser passado com um operador de comparação numérica (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ouminLong/maxLong
pode ser passado com operações de intervalo numérico (Between, NotBetween
). - Para campos flutuantes,
doubleVal
pode ser passado com um operador de comparação numérica (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ouminDouble/maxDouble
pode ser passado com operações de intervalo numérico (Between, NotBetween
). - Para campos de Data, você pode passar
dateVal
com um operador de comparação numérica (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ou minDate/maxDate com operações de intervalo numérico (Between, NotBetween
).
Adição dos campos descrição, jobSubType
e originalJobName
ao tipo JobLog
.
originalJobName
é o nome do trabalho enviado asubmitJob
(sem nenhum sufixo de exclusividade ou nome de trabalho de acompanhamento).jobSubType
é usado somente porImageServingPublishJob
trabalhos (em que é um defull
,increment, fullwithsearch,
oufulloverride
).description
é uma cadeia de caracteres vazia para todos os tipos de trabalho, mas eventualmente contém informações resumidas do trabalho, como o caminho de carregamento.
Além disso, os campos a seguir não estão incluídos com getJobLogs
e getJobLogDetails
. Em versões anteriores, eles só estavam disponíveis com getJobLogDetails
.
endDate
(se o trabalho foi concluído).fileDuplicateCount
(anteriormente era sempre0
comgetJobLogs
)fileUpdateCount
(anteriormente era sempre0
comgetJobLogs
e incluído emfileSuccessCount
; agora está dividido em campos separados).
Adição do campo assetHandle ao tipo JobLogDetail
.
Adição do parâmetro de descrição opcional a submitJob
. Este parâmetro é passado para recuperação em getScheduledJobs
, getActiveJobs
e getJobLogs
.
O campo do sistema SKU foi descontinuado. O campo será ignorado se for passado como SystemFieldCondition
para searchAssets
.
Adicionado o filtro excludeAssetTypeArray
a searchAssets
.
Adição do tipo MaskInfo
a Asset
.
Adição de novos Tipos de ativos para gerenciamento por IPS:
Adicionadas opções adicionais a UploadDirectoryJob
e UploadUrlsJob
para controlar o processamento de arquivos Postscript, Illustrator e PDF independentemente. Todas as tarefas existentes fornecem os parâmetros necessários para cada um dos três pipelines de processamento, para que funcionem exatamente como hoje. O bloco PostScriptOptions
original é usado para definir o processamento de arquivos Illustrator e EPS/PS. Opcionalmente, blocos de opções de arquivo específicos podem ser fornecidos para especificar o processamento. A lista de alterações inclui:
-
Nenhum
-
Rasterizar (padrão)
-
Gerencie somente o ativo e não crie derivados após o upload.
-
Renderize o arquivo EPS e PostScript em uma imagem com a resolução e o espaço de cor prescritos.
alfa
Opcional.
- Nenhum
- Rasterizar (padrão)
-
Gerencie somente o ativo e não crie derivados após o upload.
-
Renderize o arquivo em uma imagem com a resolução e o espaço de cor prescritos.
alfa
Opcional.
-
Nenhum
-
Rasterizar (padrão)
-
Gerencie somente o ativo e não crie derivados após o upload.
-
Renderize o arquivo em uma imagem com a resolução e o espaço de cor prescritos.
Você também pode consultar de getScheduledJobs
.
A propriedade de configuração webservice.gzip.response
foi modificada para assumir um dos seguintes valores: