Nouveaux ajouts et modifications new-additions-and-changes
Décrit les modifications nouvelles et implémentées pour l’API IPS v4.0.
Versions d’API côte à côte implémentées avec des WSDL et des espaces de noms de schéma distincts.
- Versions précédentes de l’API :
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd. - Version SPS 4.0 :
IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15.
Ajout PostScriptOptions/alpha d’un champ.
Ajout VideoRootUrl de propriétés pour SwfRootUrl getProperty l’opération.
Ajout d’options appName et appVersion de paramètres pour authHeader effectuer le suivi de l’application appelante. Ajout de la journalisation à ipsApiService.log.
Ajout d’un paramètre facultatif serviceUrl au servlet de génération WSDL. Ce paramètre est utile pour les proxys de débogage. Par exemple: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Opération mise en œuvre getZipEntries .
Mise en œuvre de plages de recherche et de valeurs de comparaison saisies pour les conditions de champ système.
Ajout 'Asset' d’une constante de chaîne de type de ressource, principalement pour autoriser les champs de métadonnées inter-ressources.
Paramètre trashState implémenté pour searchAssets.
Opération mise en œuvre getAssetPublishHistory .
Ajout d’un en-tête SOAP facultatif faultHttpStatusCode pour permettre la gestion des erreurs dans Flex. Pour Flex, utilisez <faultHttpStatusCode>200</faultHttpStatusCode>. Le code d’état par défaut pour les réponses d’erreur est 500 (Internal Server Error).
Ajout d’opérations pour restaurer les fichiers de la corbeille et les fichiers vidés de la corbeille.
Mise en œuvre des opérations CRUD.
Ajout d’un indicateur activé pour le type de ImageMap et l’opération de saveImageMap.
Ajout de la prise en charge des tâches d’optimisation des fichiers restants.
Ajout de setAssetsPublishState pour les mises à jour de l’état de publication en bloc.
Ajout de ImageServingPublishSettings, getImageServingPublishSettings et setImageServingPublishSettings.
Opération saveMetadataField obsolète au profit de nouvelles opérations createMetadataField et updateMetadataField.
Implémentation de deleteAssetsParam opération de suppression par lots.
Mise en œuvre moveAssetsParam opération de déplacement par lots.
Mise en œuvre de l’opération deleteMetadataField.
Mise en œuvre get/setImageRenderingPublishSettings opérations get/set/create/updateVignettePublishFormat.
Mise en œuvre de getAssetCounts.
Ajout de la prise en charge des setImageSetMembers pour l’inclusion de membres RenderSet dans les ressources ImageSet.
Ajout replaceImage d’une opération.
Ajout copyImage d’une opération.
Ajout setUrlModifier d’une opération et urlModifier/urlPostApplyModifier de champs pour LayerViewInfo, TemplateInfoet WatermarkInfo.
Ajout createDerivedAsset d’une opération. Actuellement, le ownerHandle fichier doit référencer un fichier d’image et le type peut être AdjustedView ou LayerView.
Ajout createTemplate d’une opération. Appel pour créer des ressources de modèle ou de filigrane.
Paramètres de la société IPS, CompanySettings, transférés vers l’API de services Web.
Ajout excludeByproducts d’un indicateur de filtre à l’opération searchAssets . La définition de cet indicateur sur true exécute les PSDlayer images et les images PDF extraites.
Ajout getGenerationInfo d’une opération.
Ajout SystemMessage d’un nom de propriété à l’opération getProperty .
Modification de certaines constantes de chaîne de type de ressource pour les faire correspondre aux champs Informations sur les ressources correspondants.
- WordDoc : Word
- ExcelDoc : Excel
- PowerPointDoc : PowerPoint
- RTFDoc : Rtf
Modification du format des résultats des opérations par lots pour résumer les succès, les avertissements et les erreurs.
Implémentation batchSetAssetMetadata de l’opération de métadonnées par lot.
Mise en œuvre de la prise en charge des données spécifiques à l’application.
Mise en œuvre de la prise en charge des indicateurs booléens pour createTemplate, extendLayerset extractText des tâches de téléchargement pour contrôler le processus de traitement des Photoshop (similaire aux modifications pour les téléchargements d’ajout de fichiers).
Mis en œuvre setImageMaps et setZoomTargets opérations.
Opérations mises en œuvre ViewerPreset . Les types reconnus sont :
VideoPlayer(la vidéo ne publie que ces visionneuses.)BrochureBasicZoomAdvancedZoomSpinCustom types
Les enveloppes de visionneuse prennent en charge deux paramètres : skinFg et skinBg. Le code du serveur principal effectue tout le traitement nécessaire pour maintenir la rétrocompatibilité.
Opération mise en œuvre getAssociatedAssets .
Ajout ReprocessAssets d’un type de tâche pour permettre le retraitement des fichiers source primaires précédemment téléchargés, y compris la réextraction de fichiers PDF et la ré-optimisation des images.
Le type de champ a été renommé PropertySetType en propertyType. Ce changement de nom affecte le paramètre createPropertySetType et la réponse getPropertySetType/getPropertySetTypes.
Implémentation d’une opération batchSetImageFields pour prendre en charge la définition des données utilisateur d’image et d’autres champs d’image modifiables.
47 Ajout du champ fileSize à divers types d’informations sur les ressources :
VignetteInfoCabinetInfoWindowCoveringInfoIccProfileInfoFontInfoXslInfoViewerSwfInfoXmlInfoSvgInfoZipInfoVideoInfoAcoInfoPdfInfoPsdInfoFlashInfoInDesignInfoPostScriptInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoRTFInfo
Mise en œuvre de l’opération getActivePublishContexts. Cette opération renvoie un tableau de noms de contexte de publication avec des serveurs de publication actifs pour la société spécifiée. Les noms actuels du contexte de publication sont les suivants :
ImageServingImageRenderingVideo
Mise en œuvre de l’opération getSearchStrings. Elle renvoie un tableau de chaînes de recherche pour la ressource donnée.
Ajout de paramètres régionaux pour les tâches et d’un mécanisme permettant de définir les paramètres régionaux des opérations d’API. La chaîne du paramètre régional doit être formatée sous la forme <language_code>[-<country_code>]. Le code de langue est un code minuscule à deux lettres comme spécifié par ISO-639, et le code de pays facultatif est un code majuscule à deux lettres comme spécifié par ISO-3166.
Ajout d’un paramètre local facultatif à l’en-tête SOAP pour définir les paramètres régionaux des opérations d’API authHeader . Si ce paramètre n’est pas présent, l’en-tête Accept-Language HTTP est utilisé. Si cet en-tête n’est pas non plus présent, le paramètre régional par défaut du serveur IPS est utilisé.
Ajout de la prise en charge get/set pour les champs de métadonnées fortement typés.
Mise en œuvre de la prise en charge des en-têtes SOAP et HTTP pour le contrôle de réponse gzip.
Ajout gzipResponse d’un drapeau à l’objet authHeader. Si elle n’est pas présente, l’API vérifie l’en-tête HTTP Accept-Encoding .
Ajout de la prise en charge de searchAssets pour les conditions de champ de métadonnées fortement typées.
- Pour tous les types de champs, la valeur peut être transmise avec un opérateur de comparaison de chaînes (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith) - Pour les champs booléens,
boolValpeut être transmis avec l’opEquals. - Pour les champs Int, les
longValpeuvent être transmises avec un opérateur de comparaison numérique (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) ou lesminLong/maxLongpeuvent être transmises avec des opérations de plage numérique (Between, NotBetween). - Pour les champs flottants,
doubleValpeut être transmise avec un opérateur de comparaison numérique (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) ouminDouble/maxDoubleavec une opération de plage numérique (Between, NotBetween). - Pour les champs de date, vous pouvez transmettre
dateValavec un opérateur de comparaison numérique (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) ou vous pouvez transmettre minDate/maxDate avec une opération de plage numérique (Between, NotBetween).
Ajout d’une description, jobSubTypeainsi que originalJobName de champs à saisir JobLog .
originalJobNameest le nom de la tâche auquel il est envoyésubmitJob(sans suffixes d’unicité ni noms de tâche ultérieurs).jobSubTypen’est utilisé que par les tâches deImageServingPublishJob(lorsqu’il s’agit d’une tâchefull,increment, fullwithsearch,oufulloverride).descriptionest une chaîne vide pour tous les types de tâche, mais elle contient finalement des informations récapitulatives sur la tâche, telles que le chemin de chargement.
En outre, les champs suivants ne sont pas inclus à la fois dans getJobLogs et getJobLogDetails. Dans les versions précédentes, ils n’étaient disponibles qu’avec getJobLogDetails.
endDate(si le traitement est terminé).fileDuplicateCount(auparavant, il était toujours0avecgetJobLogs)fileUpdateCount(auparavant, il était toujours0avecgetJobLogset inclus dansfileSuccessCount; il est désormais divisé en champs distincts).
Ajout du champ assetHandle au type de JobLogDetail.
Ajout d’un paramètre de description facultatif à submitJob. Ce paramètre est transmis pour récupération dans getScheduledJobs, getActiveJobs et getJobLogs.
Champ système de SKU obsolète. Le champ est ignoré s’il est transmis en tant que SystemFieldCondition à searchAssets.
Ajout d’un filtre excludeAssetTypeArray à searchAssets.
Ajout MaskInfo d’un type à Asset.
Ajout de nouveaux types de ressources pour la gestion par IPS :
Ajout d’options supplémentaires pour UploadDirectoryJob contrôler le UploadUrlsJob traitement des fichiers Postscript, Illustrator et PDF indépendamment. Toutes les tâches existantes fournissent les paramètres nécessaires à chacun des trois pipelines de traitement afin qu’ils fonctionnent exactement comme aujourd’hui. Le bloc d’origine PostScriptOptions est utilisé pour définir le traitement des fichiers Illustrator et EPS/PS. En option, des blocs d’options de fichier spécifiques peuvent être fournis pour spécifier le traitement. La liste des modifications comprend :
-
Aucune
-
Pixelliser (par défaut)
-
Gérez uniquement la ressource et ne créez aucun dérivé lors du téléchargement.
-
Effectuez le rendu des fichiers EPS et PostScript dans une image à la résolution et à l’espace colorimétrique prescrits.
alpha
Facultatif.
- Aucun
- Pixelliser (par défaut)
-
Gérez uniquement la ressource et ne créez aucun dérivé lors du téléchargement.
-
Effectuez le rendu du fichier dans une image à la résolution et dans l’espace colorimétrique prescrits.
alpha
Facultatif.
-
Aucun
-
Pixelliser (par défaut)
-
Gérez uniquement la ressource et ne créez aucun dérivé lors du téléchargement.
-
Effectuez le rendu du fichier dans une image à la résolution et dans l’espace colorimétrique prescrits.
Vous pouvez également effectuer une requête à partir de getScheduledJobs.
Modification de la webservice.gzip.response propriété de configuration afin qu’elle prenne l’une des valeurs suivantes :