Nouveaux ajouts et modifications

Dernière mise à jour : 2022-11-11
  • Créé pour :
  • Developer
    Admin

Décrit les modifications nouvelles et mises en oeuvre pour l’API IPS v4.0.

Mise en oeuvre de versions d’API côte à côte avec des WSDL et des espaces de noms de schéma distincts.

  • Versions d’API précédentes : 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 champ .

Ajout VideoRootUrl et SwfRootUrl propriétés pour getProperty opération.

Ajout du paramètre facultatif appName et appVersion params vers authHeader pour effectuer le suivi de l’appel de l’application. Ajout de la connexion à ipsApiService.log.

Ajout d’une serviceUrl paramètre du servlet de génération WSDL. Ce paramètre est utile pour le débogage des proxys. Par exemple: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081

Implémenté getZipEntries opération.

Mise en oeuvre de plages de recherche et de valeurs de comparaison saisies pour les conditions de champ système.

Ajout 'Asset' Constante de chaîne de type de ressource, principalement pour autoriser les champs de métadonnées interressources.

Implémenté trashState param pour searchAssets.

Implémenté getAssetPublishHistory opération.

Ajout du paramètre facultatif faultHttpStatusCode En-tête SOAP pour activer 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 ressources de la corbeille et les ressources vides de la corbeille.

Mise en oeuvre des opérations CRUD.

Ajout de l’indicateur activé à ImageMap type et saveImageMap opération.

Ajout de la prise en charge des tâches Optimiser les fichiers restants.

Ajout setAssetsPublishState pour les mises à jour de l’état de publication en bloc.

Ajout ImageServingPublishSettings, getImageServingPublishSettings, setImageServingPublishSettings.

Obsolète saveMetadataField opération en faveur d'une nouvelle createMetadataField et updateMetadataField opérations.

Implémenté deleteAssetsParam opération de suppression par lots.

Implémenté moveAssetsParam opération de déplacement par lots.

Implémenté deleteMetadataField opération.

Implémenté get/setImageRenderingPublishSettings, get/set/create/updateVignettePublishFormat opérations.

Implémenté getAssetCounts.

Ajout de la prise en charge de setImageSetMembers pour inclure RenderSet membres dans ImageSet ressources.

Ajout replaceImage opération.

Ajout copyImage opération.

Ajout setUrlModifier operation et urlModifier/urlPostApplyModifier champs pour LayerViewInfo, TemplateInfo, et WatermarkInfo.

Ajout createDerivedAsset opération. Actuellement, la variable ownerHandle doit référencer une ressource Image et le type peut être AdjustedView ou LayerView.

Ajout createTemplate opération. Appelez pour créer des ressources de modèle ou de filigrane.

Paramètres de la société IPS, CompanySettings, porté à l’API des services Web.

Ajout excludeByproducts Indicateur de filtre sur searchAssets opération. La définition de cet indicateur sur true s’exécute PSDlayer images et images arrachées par le PDF.

Ajout getGenerationInfo opération.

Ajout SystemMessage nom de la propriété à getProperty opération.

Modification de certaines constantes de chaîne de type de ressource pour qu’elles correspondent aux champs Asset Info correspondants.

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

Format de résultat modifié des opérations par lots pour résumer les succès, les avertissements et les erreurs.

Implémenté batchSetAssetMetadata opération de métadonnées de lot.

Mise en oeuvre de la prise en charge des données spécifiques à l’application.

Mise en oeuvre de la prise en charge des indicateurs booléens pour createTemplate, extendLayers, et extractText pour les tâches de chargement afin de contrôler le processus de traitement Photoshop (comme les modifications pour les chargements de fichiers supplémentaires).

Implémenté setImageMaps et setZoomTargets opérations.

Implémenté ViewerPreset opérations. Les types reconnus sont les suivants :

  • VideoPlayer (La vidéo publie uniquement ces visionneuses.)
  • Brochure
  • BasicZoom
  • AdvancedZoom
  • Spin
  • Custom types

Les habillages de visionneuse prennent en charge deux paramètres : skinFg et skinBg. Le code principal effectue tout le traitement nécessaire pour maintenir la compatibilité ascendante.

Implémenté getAssociatedAssets opération.

Ajout ReprocessAssets type de tâche pour permettre le retraitement des fichiers source Principaux précédemment téléchargés, y compris la réactualisation des PDF et la réoptimisation des images.

Renommé PropertySetType type de champ à propertyType. Ce changement de nom affecte le createPropertySetType et getPropertySetType/getPropertySetTypes réponse.

Implémenté batchSetImageFields pour prendre en charge la définition des données utilisateur de l’image et d’autres champs d’image modifiables.

47 Ajout du champ fileSize à divers types d’informations sur les ressources :

  • 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

Implémenté getActivePublishContexts opération. Cette opération renvoie un tableau de noms de contexte de publication avec des serveurs de publication principaux pour la société spécifiée. Les noms de contexte de publication actuels sont les suivants :

  • ImageServing
  • ImageRendering
  • Video

Implémenté getSearchStrings opération. 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 pour définir les paramètres régionaux des opérations de l’API. La chaîne locale doit être formatée en tant que <language_code>[-<country_code>]. Le code de langue est un code à deux lettres minuscules, comme spécifié par la norme ISO-639, et le code de pays facultatif est un code à deux lettres majuscules, comme spécifié par la norme ISO-3166.

Ajout du paramètre régional facultatif à la variable authHeader En-tête SOAP pour définir les paramètres régionaux des opérations API. Si ce paramètre n’est pas présent, l’en-tête HTTP Accept-Language est utilisée. 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 de la fonction get/set pour les champs de métadonnées fortement tapés.

Mise en oeuvre de la prise en charge des en-têtes SOAP et HTTP pour le contrôle de réponse gzip.

Ajout gzipResponse indicateur pour authHeader. S’il n’est pas présent, l’API vérifie le HTTP Accept-Encoding en-tête .

Ajout de la prise en charge des conditions de champ de métadonnées de recherche de ressources fortement typées.

  • Pour tous les types de champ, 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, boolVal peut être transmis avec la variable Equals op.
  • Pour les champs Int, longVal peut être transmis avec un opérateur de comparaison numérique ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) ou minLong/maxLong peut être transmis avec des opérations de plage numérique ( Between, NotBetween).
  • Pour les champs flottants, doubleVal peut être transmis avec un opérateur de comparaison numérique ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) ou minDouble/maxDouble peut être transmis avec des opérations de plage numérique ( Between, NotBetween).
  • Pour les champs Date, vous pouvez transmettre dateVal avec un opérateur de comparaison numérique ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) ou vous pouvez transmettre minDate/maxDate avec des opérations de plage numérique ( Between, NotBetween).

Ajout d’une description, jobSubType, et originalJobName champs à JobLog type.

  • originalJobName est le nom de la tâche envoyé à submitJob (sans suffixes d’unicité ni noms de tâches consécutifs).
  • jobSubType est utilisé uniquement par ImageServingPublishJob tâches (où il s’agit de l’une des tâches full, increment, fullwithsearch, ou fulloverride).
  • description est une chaîne vide pour tous les types de tâche, mais contient éventuellement des informations de tâche récapitulatives, telles que le chemin de chargement.

En outre, les champs suivants ne sont pas inclus avec les deux getJobLogs et getJobLogDetails. Dans les versions précédentes, elles n’étaient disponibles qu’avec getJobLogDetails.

  • endDate (si la tâche est terminée).
  • fileDuplicateCount (auparavant, il était toujours 0 avec getJobLogs)
  • fileUpdateCount (auparavant, 0 avec getJobLogs et inclus dans fileSuccessCount; il est maintenant divisé en champs distincts).

Ajout du champ assetHandle à JobLogDetail type.

Ajout du paramètre de description facultatif à submitJob. Ce paramètre est transmis pour récupération dans getScheduledJobs, getActiveJobs, et getJobLogs.

Le champ du système de SKU a été obsolète. Le champ est ignoré s’il est transmis en tant que SystemFieldCondition to searchAssets.

Ajout excludeAssetTypeArray filtrer sur searchAssets.

Ajout MaskInfo saisir Asset.

Ajout de nouveaux types de ressources pour la gestion par IPS :

Type de fichier

Description

Illustrator

Fichier Adobe Illustrator.

Postscript

Fichiers EPS et PostScript.

WordDoc

Document Microsoft® Word pour les fichiers se terminant par .doc.

ExcelDoc

Document Excel Microsoft® pour les fichiers se terminant par .xls.

PowerPointDoc

Document Microsoft® PowerPoint pour les fichiers se terminant par .ppt.

RTFDoc

Fichier RTF pour les fichiers chargés se terminant par .rtf.

Ajout d’options supplémentaires à UploadDirectoryJob et UploadUrlsJob pour contrôler indépendamment le traitement des fichiers Postscript, Illustrator et PDF. 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. L'original PostScriptOptions block est utilisé pour définir le traitement des fichiers Illustrator et EPS/PS. Vous pouvez éventuellement fournir des blocs d’options de fichier spécifiques pour spécifier le traitement. La liste des modifications comprend :

Champ

Paramètre

Valeur

Description

PostScriptOptions

process

  • Aucun

  • Pixelliser (par défaut)

  • Ne gérez que la ressource et ne créez aucun produit dérivé lors du téléchargement.

  • Effectuez le rendu du fichier EPS et PostScript dans une image à la résolution et à l’espace colorimétrique prescrits.

alpha

Facultatif.

<boolean>

Cet événement est pris en compte lors de la pixellisation du fichier dans une image. Il crée un arrière-plan transparent si le fichier d’origine est défini de cette manière pour superposer des logos.

IllustratorOptions

processus

  • Aucun
  • Pixelliser (par défaut)

  • Ne gérez que la ressource et ne créez aucun produit dérivé lors du téléchargement.

  • Effectuez le rendu du fichier dans une image à la résolution et à l’espace colorimétrique prévus.

resolution

<entier>

Rasterisation de la résolution.

colorspace

Espace colorimétrique cible pour le rendu.

alpha

Facultatif.

Cet événement est pris en compte lors de la pixellisation du fichier dans une image. Crée un arrière-plan transparent si le fichier d’origine est défini de cette manière pour créer des logos superposés.

PDFOptions

processus

  • Aucun

  • Pixelliser (par défaut)

  • Ne gérez que la ressource et ne créez aucun produit dérivé lors du téléchargement.

  • Effectuez le rendu du fichier dans une image à la résolution et à l’espace colorimétrique prévus.

resolution

<entier>

Rasterisation de la résolution.

colorspace

Espace colorimétrique cible pour le rendu.

pdfCatalog

<boolean>

Définit s’il faut combiner plusieurs PDF de page dans un catalogue électronique après le rendu (la valeur par défaut est true).

extractSearchWords

<boolean>

Définit si les mots du PDF sont extraits dans la base de données pour être ensuite fournis à un serveur de recherche (la valeur par défaut est false).

Vous pouvez également effectuer des requêtes à partir de getScheduledJobs.

Modification de la variable webservice.gzip.response pour utiliser l’une des valeurs suivantes :

Valeur

Description

never

Ne répondez pas par gzip.

soap

Réponse Gzip uniquement si authHeader/gzipResponse est vrai.

accept

Gzip si authHeader/gzipResponse est défini sur true ou si aucun en-tête gzipResponse n’est présent et que l’en-tête HTTP Accept-Encoding inclut gzip. (Par défaut).

always

Toujours gzip, quelle que soit la valeur de l’en-tête. Utilisez cette valeur uniquement à des fins de débogage.

Sur cette page