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.
Ett valfritt faultHttpStatusCode SOAP-huvud 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 PDF rensade bilder.
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.)BrochureBasicZoomAdvancedZoomSpinCustom 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 återgivning av PDF-filer 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:
VignetteInfoCabinetInfoWindowCoveringInfoIccProfileInfoFontInfoXslInfoViewerSwfInfoXmlInfoSvgInfoZipInfoVideoInfoAcoInfoPdfInfoPsdInfoFlashInfoInDesignInfoPostScriptInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoRTFInfo
Å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:
ImageServingImageRenderingVideo
Å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åkområdesparameter har lagts till i SOAP-huvudet authHeader för att ange språkområdet 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.
Stöd för SOAP- och HTTP-huvuden för GZIP-svarskontroll har implementerats.
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
boolValskickas medEquals-operatorn. - För Int-fält kan
longValskickas med en numerisk jämförelseoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) eller så kanminLong/maxLongskickas med en numerisk intervallåtgärd (Between, NotBetween). - För flyttalsfält kan
doubleValskickas med en numerisk jämförelseoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) eller så kanminDouble/maxDoubleskickas med en numerisk intervallåtgärd (Between, NotBetween). - För datumfält kan du skicka
dateValmed 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).jobSubTypeanvänds bara avImageServingPublishJobjobb (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 alltid0medgetJobLogs)fileUpdateCount(tidigare var alltid0medgetJobLogsoch 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: