Novas Adições e Alterações

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.

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

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.

• WordDoc: Word
• ExcelDoc: Excel
• PowerPointDoc: PowerPoint
• RTFDoc: Rtf

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.

• Para todos os tipos de campo, o valor pode ser transmitido com um operador de comparação de string ( Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith)
• Para campos booleanos, boolVal pode ser transmitido com a operação Equals.
• Para campos Int, 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).
• Para campos flutuantes, 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).
• Para campos de Data, você pode passar 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 fullou 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	Nenhum Rasterizar (padrão)	Gerenciar somente o ativo e não criar nenhum derivado após o upload. Renderize o arquivo EPS e PostScript em uma imagem na resolução e no espaço de cores prescritas.
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	Nenhum Rasterizar (padrão)	Gerenciar somente o ativo e não criar nenhum derivado após o upload. Renderize o arquivo em uma imagem com a resolução e o espaço de cor prescritos.
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	Nenhum Rasterizar (padrão)	Gerenciar somente o ativo e não criar nenhum derivado após o upload. Renderize o arquivo em uma imagem com a resolução e o espaço de cor prescritos.
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.