Descreve alterações novas e implementadas para a API IPS v4.0.
Implementadas versões de API lado a lado com WSDLs e namespaces schemas separadas.
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
.IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.Campo PostScriptOptions/alpha
adicionado.
Adicionadas as propriedades VideoRootUrl
e SwfRootUrl
para a operação getProperty
.
Adicionados os parâmetros opcionais appName
e appVersion
a authHeader
para rastrear o aplicativo de chamada. Adicionado o registro em ipsApiService.log
.
Adicionado um parâmetro opcional serviceUrl
ao servlet de geração WSDL. Isso é particularmente útil para depurar proxies. Por exemplo: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Implementação da operação getZipEntries
.
Intervalos de pesquisa implementados e valores de comparação digitados para condições de campo do sistema.
Adicionada a constante 'Asset'
do tipo de ativo, principalmente para permitir campos de metadados entre ativos.
Param trashState
implementado para searchAssets
.
Implementação da operação getAssetPublishHistory
.
Adição do cabeçalho SOAP opcional faultHttpStatusCode
para habilitar a manipulação 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)
.
Foram adicionadas operações para restaurar ativos do lixo e ativos vazios do lixo.
Operações CRUD implementadas.
Sinalizador habilitado adicionado ao tipo ImageMap
e operação saveImageMap
.
Adicionado suporte para Otimizar trabalhos de Arquivos Restantes.
Adicionado setAssetsPublishState
para atualizações de estado de publicação em massa.
Adicionado ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
.
Operação saveMetadataField
obsoleta em favor de novas operações createMetadataField
e updateMetadataField
.
Implementação da operação de exclusão em lote deleteAssetsParam
.
Implementação da operação moveAssetsParam
de movimentação em lote.
Implementação da operação deleteMetadataField
.
Implementadas as operações get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
.
Implementado getAssetCounts
.
Adicionado suporte a setImageSetMembers
para inclusão de RenderSet
membros em ativos ImageSet
.
Adicionada a operação replaceImage
.
Adicionada a operação copyImage
.
Foram adicionados os campos setUrlModifier
operação e urlModifier/urlPostApplyModifier
para LayerViewInfo
, TemplateInfo
e WatermarkInfo
.
Adicionada a operação createDerivedAsset
. Atualmente, ownerHandle
deve fazer referência a um ativo de Imagem e o tipo pode ser AdjustedView
ou LayerView
.
Adicionada a operação createTemplate
. Atualmente, isso pode ser chamado para criar ativos de Modelo ou Marca d'água.
Configurações de empresa IPS, CompanySettings
, portadas para a API de serviços da Web.
Sinalizador de filtro excludeByproducts
adicionado à operação searchAssets
. Configurar esse sinalizador para verdadeiro executa PSDlayer
imagens e imagens rasgadas de PDF.
Adicionada a operação getGenerationInfo
.
Adição do nome da propriedade SystemMessage
à operação getProperty
.
Foram modificadas algumas constantes de string de tipo de ativo para corresponder aos campos de Informações do ativo correspondentes.
Formato de resultado modificado de operações em lote para resumir o sucesso, os avisos e os erros.
Implementação da operação batchSetAssetMetadata
de metadados em lote.
Suporte implementado para dados específicos do aplicativo.
Suporte implementado para sinalizadores booleanos para createTemplate
, extendLayers
e extractText
para trabalhos de upload para controlar o processo de processamento do Photoshop (semelhante às alterações para uploads de arquivos adicionados).
Implementadas as operações setImageMaps
e setZoomTargets
.
Operações ViewerPreset
implementadas. Os tipos reconhecidos são:
VideoPlayer
(O vídeo só publica esses visualizadores.)Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
As capas do visualizador suportam dois parâmetros: skinFg
e skinBg
. O código backend executará todo o processamento necessário para manter a compatibilidade com versões anteriores.
Implementação da operação getAssociatedAssets
.
Adicionado o tipo de trabalho ReprocessAssets
para permitir o reprocessamento de arquivos de origem primária carregados anteriormente, incluindo a repetição de PDFs e a reotimização de imagens.
Tipo de campo PropertySetType
renomeado para propertyType
. Isso afeta o parâmetro createPropertySetType
e a resposta getPropertySetType/getPropertySetTypes
.
A operação batchSetImageFields
foi implementada para suportar a configuração de dados do usuário da imagem e outros campos de imagem editáveis.
47 Adição do campo fileSize a vários tipos de informações de ativos:
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
Implementação da 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 de contexto de publicação atuais são:
ImageServing
ImageRendering
Video
Implementação da operação getSearchStrings
. Ele retorna uma matriz de sequências de pesquisa para o ativo em questão.
Foram adicionados parâmetros de localidade para trabalhos e um mecanismo para definir a localidade para operações de API. A cadeia de caracteres de localidade deve ser formatada como <language_code>[-<country_code>]
. O código de idioma é um código de duas letras minúsculas, conforme especificado pela ISO-639, e o código de país opcional é um código de duas letras maiúsculas, conforme especificado pela ISO-3166.
Foi adicionado um parâmetro de localidade opcional ao cabeçalho SOAP authHeader
para definir a localidade para operações de API. Se esse parâmetro não estiver presente, o cabeçalho HTTP Accept-Language
será usado. Se esse cabeçalho também não estiver presente, a localidade padrão do servidor IPS será usada.
Adição do suporte a get/set para campos de metadados digitados fortemente.
Suporte a SOAP e cabeçalho HTTP implementado para controle de resposta gzip.
Sinalizador gzipResponse
adicionado a authHeader
. Se não estiver presente, a API também verificará o cabeçalho HTTP Accept-Encoding
.
Adição de suporte ao SearchAssets para condições de campo de metadados digitados fortemente.
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
)boolVal
pode ser transmitido com a operação Equals
.longVal
pode ser transmitido com um operador de comparação numérica ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ou minLong/maxLong
pode ser transmitido com operações de intervalo numérico ( Between, NotBetween
).doubleVal
pode ser transmitido com um operador de comparação numérica ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ou minDouble/maxDouble
pode ser transmitido com operações de intervalo numérico ( Between, NotBetween
).dateVal
com um operador de comparação numérica ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ou pode passar minDate/maxDate com operações de intervalo numérico ( Between, NotBetween
).Adicionados os campos de descrição, jobSubType
e originalJobName
ao tipo JobLog
.
originalJobName
é o nome do serviço enviado submitJob
(sem sufixos de exclusividade ou nomes de trabalhos de continuação).jobSubType
atualmente é usado apenas por ImageServingPublishJob
trabalhos (onde é um full
ou increment, fullwithsearch,
fulloverride
).description
no momento, é uma string vazia para todos os tipos de trabalho, mas eventualmente conterá informações de trabalho resumidas, como o caminho de upload.Além disso, os seguintes campos 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 tiver sido concluído).fileDuplicateCount
(antes, sempre estava 0
com getJobLogs
)fileUpdateCount
(anteriormente, estava sempre 0
com getJobLogs
e incluído em fileSuccessCount
; agora é dividido em campos separados).Adição do campo assetHandle ao tipo JobLogDetail
.
Foi adicionado um parâmetro de descrição opcional a submitJob
. Isso é passado para recuperação em getScheduledJobs
, getActiveJobs
e getJobLogs
.
Campo do sistema SKU substituído. O campo será ignorado se for passado como SystemFieldCondition
para searchAssets
.
Adicionado o filtro excludeAssetTypeArray
a searchAssets
.
Adicionado o tipo MaskInfo
para Asset
.
Adicionados novos tipos de ativos para gerenciamento pelo IPS:
Tipo de ativo |
Descrição |
---|---|
Illustrator |
Arquivo Adobe Illustrator. |
PostScript |
Arquivos EPS e PostScript. |
WordDoc |
Documento do Microsoft Word para arquivos que terminam com .doc. |
ExcelDoc |
Documento do Microsoft Excel para arquivos que terminam com .xls. |
PowerPointDoc |
Documento do Microsoft PowerPoint para arquivos que terminam com .ppt. |
RTFDoc |
Arquivo RTF para arquivos carregados terminando com .rtf. |
Adicionadas outras opções para UploadDirectoryJob
e UploadUrlsJob
para controlar o processamento de arquivos Postscript, Illustrator e PDF de forma independente. Todos os trabalhos existentes fornecerão os parâmetros necessários para cada um dos três pipelines de processamento, para que funcionem exatamente como acontece hoje. O bloco original PostScriptOptions
é usado para definir o processamento para arquivos Illustrator e EPS/PS. Como opção, blocos de opções de arquivo específicos podem ser fornecidos para especificar o processamento. A lista de alterações inclui:
Campo |
Parâmetro |
Valor |
Descrição |
---|---|---|---|
PostScriptOptions |
processo |
|
|
alfa Opcional. |
<boolean> |
Tem efeito ao rasterizar o arquivo em uma imagem. Isso criará um fundo transparente se o arquivo original for definido dessa forma para a sobreposição de logotipos. |
|
IllustratorOptions |
processo |
|
|
resolução |
<integer> |
Rasterizando resolução. |
|
colorspace |
|
Espaço de cor do público alvo para renderização. |
|
alfa Opcional. |
|
É afetado ao rasterizar o arquivo em uma imagem. Cria um fundo transparente se o arquivo original for definido dessa forma para a criação de logotipos sobrepostos. |
|
PDFOoptions |
processo |
|
|
resolução |
<integer> |
Rasterizando resolução. |
|
colorspace |
|
Espaço de cor do público alvo para renderização. |
|
pdfCatalog |
<boolean> |
Define se um PDF de várias páginas deve ser combinado em um eCatalog após a renderização (o padrão é true). |
|
extractSearchWords |
<boolean> |
Define se as palavras do PDF são extraídas no DB para posterior fornecimento a um servidor de pesquisa (o padrão é false). |
Você também pode query de getScheduledJobs
.
Modificada a propriedade de configuração webservice.gzip.response
para obter um dos seguintes valores:
Valor |
Descrição |
---|---|
nunca |
Não responda ao gzip. |
sabão |
Resposta de gzip somente se authHeader/gzipResponse for verdadeiro. |
accept |
Gzip se authHeader/gzipResponse for verdadeiro ou se nenhum cabeçalho gzipResponse estiver presente e o cabeçalho HTTP Accept-Encoding incluir gzip. (Padrão). |
always |
Sempre obtenha resposta, independentemente dos valores do cabeçalho. Use esse valor somente para fins de depuração. |