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.
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
.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.
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.
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
)boolVal
peut être transmis avec la variable Equals
op.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
).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
).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 |
|
|
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 |
|
|
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 |
|
|
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. |