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 med Equals-operatorn.
  • För Int-fält kan longVal skickas med en numerisk jämförelseoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) eller så kan minLong/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å kan minDouble/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 till submitJob (utan unika suffix eller efterföljande jobbnamn).
  • jobSubType används bara av ImageServingPublishJob jobb (där det är något av full, increment, fullwithsearch, eller fulloverride).
  • 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 alltid 0 med getJobLogs)
  • fileUpdateCount (tidigare var alltid 0 med getJobLogs och inkluderad i fileSuccessCount; 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:

Tillgångstyp
Beskrivning
Illustrator
Adobe Illustrator.
PostScript
EPS och PostScript.
WordDoc
Microsoft® Word för filer som slutar med .doc.
ExcelDoc
Microsoft® Excel-dokument för filer som slutar med .xls.
PowerPointDoc
Microsoft® PowerPoint-dokument för filer som slutar med .ppt.
RTFDoc
RTF-fil för filer som överförts och som slutar med .rtf.

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:

Fält
Parameter
Värde
Beskrivning
PostScriptOptions
process
  • 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.

<boolesk>
Börjar gälla när filen rastreras till en bild. En genomskinlig bakgrund skapas om originalfilen definieras på det här sättet för att täcka över logotyper.
IllustratorOptions
process
  • 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.

resolution
<heltal>
Rastrerar upplösningen.
colorspace
Målfärgrymd för återgivning.

alfa

Valfritt.

Börjar gälla när filen rastreras till en bild. Skapar en genomskinlig bakgrund om originalfilen definieras på det här sättet för att skapa överliggande logotyper.
PDFOptions
process
  • 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.

resolution
<heltal>
Rastrerar upplösningen.
colorspace
Målfärgrymd för återgivning.
pdfCatalog
<boolesk>
Definierar om en flersidig PDF ska kombineras i en e-katalog efter återgivningen (standardvärdet är true).
extractSearchWords
<boolesk>
Definierar om ord från PDF ska extraheras till databasen för att senare skickas till en sökserver (standardvärdet är false).

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:

Värde
Beskrivning
never
Gzip-svar får inte ges.
soap
Gzip-svar endast om authHeader/gzipResponse är true.
accept
Gzip om authHeader/gzipResponse är true, eller ingen gzipResponse-rubrik finns och HTTP Accept-Encoding-huvudet innehåller gzip. (Standard).
always
Gzip-svar alltid, oavsett rubrikvärden. Använd det här värdet endast i felsökningssyfte.
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681