新しい追加と変更

IPS API v4.0の新しい変更と実装された変更について説明します。

APIバージョンを並べて実装し、WSDLとスキーマの名前空間を個別に実装しました。

  • 以前のAPIバージョン:IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd.
  • SPS 4.0バージョン:IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15.

PostScriptOptions/alphaフィールドを追加しました。

getProperty操作のVideoRootUrlおよびSwfRootUrlプロパティを追加しました。

呼び出し元のアプリケーションを追跡するために、オプションのappNameパラメーターとappVersionパラメーターをauthHeaderに追加しました。 ipsApiService.logにログを追加しました。

オプションのserviceUrlパラメーターがWSDL生成サーブレットに追加されました。 これは、デバッグプロキシに特に役立ちます。 例:http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081

getZipEntries操作を実装しました。

システムフィールド条件に検索範囲と型指定比較値を実装しました。

主にクロスアセットメタデータフィールドを許可するために、アセットタイプの文字列定数'Asset'を追加しました。

searchAssetstrashStateパラメーターを実装しました。

getAssetPublishHistory操作を実装しました。

Flexでの障害処理を有効にするため、オプションのfaultHttpStatusCode SOAPヘッダーを追加しました。 Flexの場合は、<faultHttpStatusCode>200</faultHttpStatusCode>を使用します。 障害応答のデフォルトのステータスコードは500 (Internal Server Error)です。

ごみ箱からアセットを復元し、ごみ箱からアセットを空にする操作を追加しました。

CRUD操作を実装しました。

ImageMap型とsaveImageMap操作にenabledフラグを追加しました。

残りのファイルを最適化ジョブのサポートを追加しました。

一括公開状態更新のためにsetAssetsPublishStateを追加しました。

ImageServingPublishSettingsgetImageServingPublishSettingssetImageServingPublishSettingsを追加しました。

新しいcreateMetadataField操作とupdateMetadataField操作に代わって、saveMetadataField操作が廃止されました。

deleteAssetsParamバッチ削除操作を実装しました。

moveAssetsParamバッチ移動操作を実装しました。

deleteMetadataField操作を実装しました。

get/setImageRenderingPublishSettingsget/set/create/updateVignettePublishFormat操作を実装。

getAssetCountsを実装。

setImageSetMembersに、ImageSetアセットにRenderSetメンバーを含めるサポートを追加しました。

replaceImage操作を追加しました。

copyImage操作を追加しました。

LayerViewInfoTemplateInfoおよびWatermarkInfosetUrlModifier操作とurlModifier/urlPostApplyModifierフィールドを追加しました。

createDerivedAsset操作を追加しました。 現在、ownerHandleは画像アセットを参照し、タイプはAdjustedViewまたはLayerViewにする必要があります。

createTemplate操作を追加しました。 現在は、これを呼び出して、テンプレートアセットまたは透かしアセットを作成できます。

IPS会社の設定CompanySettingsをWebサービスAPIに移植。

excludeByproductsフィルターフラグをsearchAssets操作に追加しました。 このフラグをtrueに設定すると、画像とPDFの切り取られた画像が実行されます。PSDlayer

getGenerationInfo操作を追加しました。

SystemMessageプロパティ名をgetProperty操作に追加しました。

一部のアセットタイプ文字列定数を変更し、対応するAsset Infoフィールドに一致するようにしました。

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

成功、警告およびエラーを要約するために、バッチ操作の結果の形式を変更しました。

batchSetAssetMetadataバッチメタデータ操作を実装しました。

アプリ固有のデータのサポートを実装。

Photoshop処理のプロセスを制御するためのアップロードジョブのcreateTemplateextendLayersおよびextractTextのブール型フラグのサポートを実装しました(追加ファイルのアップロードの変更と同様)。

setImageMaps操作とsetZoomTargets操作を実装。

ViewerPreset操作を実装しました。 次のタイプが認識されます。

  • VideoPlayer (ビデオでは、これらのビューアのみを公開しています)。
  • Brochure
  • BasicZoom
  • AdvancedZoom
  • Spin
  • Custom types

ビューアスキンでは、次の2つのパラメータがサポートされています。skinFgskinBgが表示されます。 バックエンドコードは、後方互換性を維持するために必要なすべての処理を実行します。

getAssociatedAssets操作を実装しました。

PDFの取り込みや画像の再最適化を含む、以前にアップロードしたプライマリソースファイルの再処理を許可するReprocessAssetsジョブタイプが追加されました。

PropertySetTypeフィールドタイプの名前をpropertyTypeに変更しました。 これはcreatePropertySetTypeパラメーターとgetPropertySetType/getPropertySetTypes応答に影響します。

画像ユーザーデータやその他の編集可能な画像フィールドの設定をサポートするために、 batchSetImageFields操作を実装しました。

47様々なアセット情報タイプにfileSizeフィールドを追加しました。

  • 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

getActivePublishContexts操作を実装しました。 この操作は、指定した会社のアクティブなパブリッシュサーバーを持つパブリッシュコンテキスト名の配列を返します。 現在のパブリッシュコンテキスト名は次のとおりです。

  • ImageServing
  • ImageRendering
  • Video

getSearchStrings操作を実装しました。 指定されたアセットの検索文字列の配列を返します。

ジョブのロケールパラメーターと、API操作のロケールを設定するメカニズムを追加しました。 ロケール文字列は<language_code>[-<country_code>]の形式にする必要があります。 言語コードは、ISO-639で指定された小文字の2文字のコードで、オプションの国コードは、ISO-3166で指定された大文字の2文字のコードです。

API操作のロケールを設定するために、オプションのロケールパラメーターをauthHeader SOAPヘッダーに追加しました。 このパラメーターがない場合は、HTTPヘッダーAccept-Languageが使用されます。 このヘッダーも存在しない場合は、IPSサーバのデフォルトロケールが使用されます。

厳密に型指定されたメタデータフィールドに対するget/setのサポートを追加しました。

gzip応答制御用にSOAPおよびHTTPヘッダーのサポートを実装しました。

gzipResponseフラグをauthHeaderに追加しました。 存在しない場合、APIはHTTP Accept-Encodingヘッダーも確認します。

厳密に型指定されたメタデータフィールド条件に対するsearchAssetsのサポートを追加しました。

  • すべてのフィールドタイプに対して、文字列比較演算子(Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith)を使用して値を渡すことができます。
  • ブール値フィールドの場合、boolValEquals演算子と共に渡すことができます。
  • Intフィールドの場合、longValは数値比較演算子(Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals)で渡すことも、minLong/maxLongは数値範囲演算(Between, NotBetween)で渡すこともできます。
  • Floatフィールドの場合、doubleValは数値比較演算子(Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals)で渡すことも、minDouble/maxDoubleは数値範囲演算(Between, NotBetween)で渡すこともできます。
  • 日付フィールドには、dateValを数値比較演算子(Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals)で渡すか、minDate/maxDateを数値範囲演算(Between, NotBetween)で渡すことができます。

JobLog型に説明、jobSubTypeoriginalJobNameフィールドを追加しました。

  • originalJobName に送信されるジョブ名で submitJob す(一意性のサフィックスや後続のジョブ名を除く)。
  • jobSubType は、現在、ジョブ( ImageServingPublishJob またはのいずれか)でのみ使 full用さ increment, fullwithsearch, れます fulloverride
  • description は、現在、すべてのジョブタイプに対して空の文字列ですが、最終的には、アップロードパスなどの概要ジョブ情報が含まれます。

また、次のフィールドはgetJobLogsgetJobLogDetailsの両方に含まれません。 以前のバージョンでは、getJobLogDetailsでのみ使用できました。

  • endDate (ジョブが完了した場合)。
  • fileDuplicateCount (以前は常にを使用してい 0 まし getJobLogsた)
  • fileUpdateCount (以前は常にに付属し、 0 に含ま getJobLogs れていまし fileSuccessCountた)。現在は、別々のフィールドに分割されます)。

JobLogDetailタイプにassetHandleフィールドを追加しました。

オプションの説明パラメーターをsubmitJobに追加しました。 getScheduledJobsgetActiveJobsgetJobLogsで取得するために渡されます。

「 SKUシステム」フィールドを非推奨(廃止予定) フィールドがSystemFieldConditionとしてsearchAssetsに渡される場合、このフィールドは無視されます。

excludeAssetTypeArrayフィルターをsearchAssetsに追加しました。

MaskInfo型をAssetに追加しました。

IPSによる管理のための新しいアセットタイプを追加しました。

アセットタイプ

説明

Illustrator

Adobe Illustratorファイル。

PostScript

EPSファイルとPostScriptファイル。

WordDoc

.docで終わるファイル用のMicrosoft Wordドキュメント。

ExcelDoc

.xlsで終わるファイルに関するMicrosoft Excelドキュメント。

PowerPointDoc

.pptで終わるファイル用のMicrosoft PowerPointドキュメント。

RTFDoc

.rtfで終わるファイルのRTFファイル。

UploadDirectoryJobUploadUrlsJobに、Postscript、Illustrator、PDFファイルの処理を個別に制御するオプションを追加しました。 既存のジョブはすべて、現在のとおりに機能するように、3つの処理パイプラインのそれぞれに必要なパラメーターを提供します。 元のPostScriptOptionsブロックを使用して、IllustratorおよびEPS/PSファイルの処理を設定します。 オプションで、処理を指定するために特定のファイルオプションブロックを指定できます。 変更点のリストには、次のものが含まれます。

フィールド

パラメータ

説明

PostScriptOptions

プロセス

  • なし

  • ラスタラ イズ(デフォルト)

  • アセットの管理のみを行い、アップロード時に派生物を作成しないでください。

  • EPSファイルとPostScriptファイルを、所定の解像度とカラースペースで画像にレンダリングします。

alpha

(オプション)

<ブール>

ファイルをイメージにラスタライズするときに有効になります。 元のファイルがこの方法でロゴのオーバーレイ用に定義されている場合、透明な背景が作成されます。

IllustratorOptions

プロセス

  • なし
  • ラスタラ イズ(デフォルト)

  • アセットの管理のみを行い、アップロード時に派生物を作成しないでください。

  • 所定の解像度とカラースペースでファイルを画像にレンダリングします。

resolution

<整数>

解像度をラスタライズする。

カラースペース

レンダリングのターゲットカラースペース

alpha

(オプション)

ファイルをイメージにラスタライズすると、影響を受けます。 元のファイルがこの方法で定義されている場合、透明な背景を作成して、ロゴをオーバーレイします。

PDFOptions

プロセス

  • なし

  • ラスタラ イズ(デフォルト)

  • アセットの管理のみを行い、アップロード時に派生物を作成しないでください。

  • 所定の解像度とカラースペースでファイルを画像にレンダリングします。

resolution

<整数>

解像度をラスタライズする。

カラースペース

レンダリングのターゲットカラースペース

pdfCatalog

<ブール>

レンダリング後に、複数ページのPDFをeCatalogに結合するかどうかを定義します(デフォルトはtrue)。

extractSearchWords

<ブール>

後で検索サーバーに提供するために、PDFからの単語をDBに抽出するかどうかを定義します(デフォルトはfalse)。

getScheduledJobsからクエリを実行することもできます。

webservice.gzip.response設定プロパティを次のいずれかの値に変更しました。

説明

決してない

応答をgzipにしないでください。

SOAP

authHeader/gzipResponseがtrueの場合にのみGzipが応答します。

受��入れる

authHeader/gzipResponseがtrueの場合、またはgzipResponseヘッダーが存在せず、HTTP Accept-Encodingヘッダーにgzipが含まれている場合は、Gzipを使用します。 (初期設定).

いつも

ヘッダー値に関係なく、常にgzip応答。 この値は、デバッグ目的でのみ使用します。

このページ