Nya tillägg och ändringar new-additions-and-changes
Beskriver nya och implementerade ändringar för IPS API v4.0.
Implementerade API-versioner sida vid sida med separata WSDL:er och schemanamnutrymmen.
- Tidigare API-versioner:
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
. - SPS 4.0-version:
IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.
PostScriptOptions/alpha
fält har lagts till.
VideoRootUrl
- och SwfRootUrl
-egenskaper för åtgärden getProperty
har lagts till.
Valfria appName
- och appVersion
-parametrar har lagts till i authHeader
för att spåra anropande program. Loggning har lagts till i ipsApiService.log
.
En valfri serviceUrl
-parameter har lagts till i WSDL-genereringstjänsten. Den här parametern är användbar för felsökningsutkast. Till exempel: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Åtgärden getZipEntries
har implementerats.
Implementerade sökintervall och typbestämda jämförelsevärden för systemfältvillkor.
'Asset'
-resurstypsträngskonstant har lagts till, främst för att tillåta metadatafält för korsresurser.
Implementerade trashState
-param för searchAssets
.
Åtgärden getAssetPublishHistory
har implementerats.
Det valfria huvudet faultHttpStatusCode
SOAP har lagts till för att aktivera felhantering i Flex. Använd <faultHttpStatusCode>200</faultHttpStatusCode>
för Flex. Standardstatuskoden för felsvar är 500 (Internal Server Error)
.
Lagt till åtgärder för att återställa resurser från papperskorgen och tomma resurser från papperskorgen.
Implementerade CRUD-åtgärder.
Flagga som är aktiverad har lagts till i åtgärden ImageMap
och saveImageMap
.
Stöd för Optimera återstående filer.
setAssetsPublishState
har lagts till för statusuppdateringar för masspublicering.
ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
har lagts till.
saveMetadataField
-åtgärden har tagits bort till förmån för nya createMetadataField
- och updateMetadataField
-åtgärder.
deleteAssetsParam
batchborttagningsåtgärd har implementerats.
moveAssetsParam
gruppflyttningsåtgärd har implementerats.
Åtgärden deleteMetadataField
har implementerats.
get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
åtgärder har implementerats.
Implementerad getAssetCounts
.
Stöd har lagts till för setImageSetMembers
för att inkludera RenderSet
medlemmar i ImageSet
-resurser.
replaceImage
-åtgärden har lagts till.
copyImage
-åtgärden har lagts till.
setUrlModifier
-åtgärd och urlModifier/urlPostApplyModifier
fält för LayerViewInfo
, TemplateInfo
och WatermarkInfo
har lagts till.
createDerivedAsset
-åtgärden har lagts till. För närvarande måste ownerHandle
referera till en bildresurs och typen kan vara AdjustedView
eller LayerView
.
createTemplate
-åtgärden har lagts till. Anrop om att skapa mall- eller vattenstämpelresurser.
Företagsinställningar för IPS, CompanySettings
, som har porterats till API:t för webbtjänster.
excludeByproducts
filterflagga har lagts till i åtgärden searchAssets
. Om du anger den här flaggan som true körs PSDlayer
bilder och bilder som har rippats i PDF.
getGenerationInfo
-åtgärden har lagts till.
Egenskapsnamnet SystemMessage
har lagts till i åtgärden getProperty
.
Ändrade vissa strängkonstanter för resurstyp så att de matchade fälten för resursinformation.
- WordDoc: Word
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: Rtf
Ändrat resultatformat för gruppåtgärder för att sammanfatta lyckade åtgärder, varningar och fel.
batchSetAssetMetadata
batchmetadataåtgärd har implementerats.
Implementerat stöd för appspecifika data.
Implementerat stöd för booleska flaggor för createTemplate
, extendLayers
och extractText
för överföringsjobb för att styra bearbetningen av Photoshop (på liknande sätt som ändringar för filöverföringar).
Implementerade setImageMaps
- och setZoomTargets
-åtgärder.
ViewerPreset
åtgärder har implementerats. De identifierade typerna är:
VideoPlayer
(Video publicerar bara dessa visningsprogram.)Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
Visningsprogrammets skal har stöd för två parametrar: skinFg
och skinBg
. Backend-koden utför all bearbetning som krävs för att bevara bakåtkompatibilitet.
Åtgärden getAssociatedAssets
har implementerats.
ReprocessAssets
-jobbtypen har lagts till för att tillåta ombearbetning av tidigare överförda primära källfiler, inklusive återställande av PDF och omoptimering av bilder.
Fälttypen PropertySetType
har bytt namn till propertyType
. Namnändringen påverkar parametern createPropertySetType
och svaret på getPropertySetType/getPropertySetTypes
.
Åtgärden batchSetImageFields
har implementerats för att ge stöd för inställning av bildanvändardata och andra redigerbara bildfält.
47 Lagt till filstorleksfält till olika typer av tillgångsinformation:
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
Åtgärden getActivePublishContexts
har implementerats. Den här åtgärden returnerar en array med publiceringskontextnamn med aktiva publiceringsservrar för det angivna företaget. Aktuella publiceringskontextnamn är:
ImageServing
ImageRendering
Video
Åtgärden getSearchStrings
har implementerats. Den returnerar en array med söksträngar för den angivna resursen.
Lagt till språkparametrar för jobb och en mekanism för att ange språkområde för API-åtgärder. Språksträngen ska formateras som <language_code>[-<country_code>]
. Språkkoden är en gemen kod med två bokstäver enligt ISO-639, och den valfria landskoden är en kod med två bokstäver i versaler enligt ISO-3166.
En valfri språkinställningsparameter har lagts till i SOAP authHeader
för att ange språkinställningen för API-åtgärder. Om den här parametern inte finns används HTTP-huvudet Accept-Language
. Om den här rubriken inte finns används standardspråket för IPS-servern.
Stöd för get/set har lagts till för metadatafält med starkt typsnitt.
Implementerat stöd för SOAP och HTTP-huvud för GZIP-svarskontroll.
gzipResponse
-flaggan har lagts till i authHeader
. Om den inte finns kontrollerar API:t HTTP Accept-Encoding
-huvudet.
Stöd har lagts till i searchAssets för väldigt typbestämda villkor för metadatafält.
- För alla fälttyper kan värdet skickas med en strängjämförelseoperator (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
) - För booleska fält kan
boolVal
skickas medEquals
-operatorn. - För Int-fält kan
longVal
skickas med en numerisk jämförelseoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) eller så kanminLong/maxLong
skickas med en numerisk intervallåtgärd (Between, NotBetween
). - För flyttalsfält kan
doubleVal
skickas med en numerisk jämförelseoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) eller så kanminDouble/maxDouble
skickas med en numerisk intervallåtgärd (Between, NotBetween
). - För datumfält kan du skicka
dateVal
med en numerisk jämförelseoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) eller skicka minDate/maxDate med numeriska intervallåtgärder (Between, NotBetween
).
Beskrivnings-, jobSubType
- och originalJobName
-fält har lagts till i typen JobLog
.
originalJobName
är jobbnamnet som skickas tillsubmitJob
(utan unika suffix eller efterföljande jobbnamn).jobSubType
används bara avImageServingPublishJob
jobb (där det är något avfull
,increment, fullwithsearch,
ellerfulloverride
).description
är en tom sträng för alla jobbtyper, men innehåller så småningom information om sammanfattningsjobb, som överföringssökvägen.
Dessutom ingår inte följande fält i både getJobLogs
och getJobLogDetails
. I tidigare versioner var de bara tillgängliga med getJobLogDetails
.
endDate
(om jobbet har slutförts).fileDuplicateCount
(tidigare var det alltid0
medgetJobLogs
)fileUpdateCount
(tidigare var alltid0
medgetJobLogs
och inkluderad ifileSuccessCount
; den delas nu upp i separata fält).
Tillagt AssetHandle-fält till typen JobLogDetail
.
En valfri beskrivningsparameter har lagts till i submitJob
. Den här parametern skickas för hämtning i getScheduledJobs
, getActiveJobs
och getJobLogs
.
SKU-systemfältet är inaktuellt. Fältet ignoreras om det skickas som en SystemFieldCondition
till searchAssets
.
excludeAssetTypeArray
har lagts till i searchAssets
.
MaskInfo
-typen har lagts till i Asset
.
Nya tillgångstyper har lagts till för hantering av IPS:
Ytterligare alternativ har lagts till i UploadDirectoryJob
och UploadUrlsJob
för att styra bearbetningen av PostScript-, Illustrator- och PDF-filer oberoende av varandra. Alla befintliga jobb ger de nödvändiga parametrarna till var och en av de tre bearbetningsledningarna så att de fungerar exakt som i dag. Det ursprungliga PostScriptOptions
-blocket används för att ställa in bearbetningen för Illustrator- och EPS/PS-filer. Alternativt kan du ange speciella filalternativblock för bearbetning. Listan över ändringar innehåller:
-
Ingen
-
Rastrera (standard)
-
Hantera bara tillgången och skapa inga derivat vid överföring.
-
Rendera EPS- och PostScript-filen till en bild med den angivna upplösningen och färgrymden.
alfa
Valfritt.
- Ingen
- Rastrera (standard)
-
Hantera bara tillgången och skapa inga derivat vid överföring.
-
Rendera filen i en bild med den angivna upplösningen och färgrymden.
alfa
Valfritt.
-
Ingen
-
Rastrera (standard)
-
Hantera bara tillgången och skapa inga derivat vid överföring.
-
Rendera filen i en bild med den angivna upplösningen och färgrymden.
Du kan även fråga från getScheduledJobs
.
Konfigurationsegenskapen webservice.gzip.response
har ändrats så att något av följande värden används: