新しい追加と変更 new-additions-and-changes
IPS API v4.0 の新しい変更点と実装された変更点について説明します。
個別の WSDL とスキーマ名前空間を使用して並列処理された API バージョンを実装しました。
- 以前の 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 追加しました。
VideoRootUrl 操作に SwfRootUrl と getProperty のプロパティを追加しました。
呼び出し元のアプリケーションを追跡するために、オプションの appName パラメーターと appVersion パラメーターを authHeader に追加しました。 ipsApiService.log にログを追加しました。
WSDL 生成サーブレットにオプションの serviceUrl パラメーターを追加しました。 このパラメーターはデバッグプロキシで役立ちます。 例:http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
操作 getZipEntries 実装しました。
システムフィールド条件に検索範囲と型指定された比較値を実装しました。
主 'Asset' クロスアセットメタデータフィールドを許可するために、アセットタイプの文字列定数を追加しました。
trashState 用 searchAssets パラメーターを実装しました。
操作 getAssetPublishHistory 実装しました。
Flexでの障害処理を有効にするためのオプションの faultHttpStatusCode SOAP ヘッダーを追加しました。 Flexの場合は、<faultHttpStatusCode>200</faultHttpStatusCode> を使用します。 障害応答のデフォルトのステータスコードは 500 (Internal Server Error) です。
ごみ箱からアセットを復元したり、ごみ箱から空のアセットを復元したりする操作を追加しました。
CRUD 操作を実装しました。
ImageMap のタイプおよび saveImageMap 操作に有効フラグを追加しました。
残りのファイルジョブの最適化のサポートを追加しました。
一括公開状態アップデート用に setAssetsPublishState を追加しました。
ImageServingPublishSettings、getImageServingPublishSettings、setImageServingPublishSettings を追加しました。
新しい saveMetadataField および createMetadataField の操作に置き換えて、updateMetadataField の操作を非推奨(廃止予定)としました。
バッチ削除操作 deleteAssetsParam 実装しました。
バッチ移動操作 moveAssetsParam 実装しました。
操作 deleteMetadataField 実装しました。
get/setImageRenderingPublishSettings、get/set/create/updateVignettePublishFormat 操作を実装しました。
実装 getAssetCounts。
アセットに setImageSetMembers メンバーを含めるためのサポートを RenderSet に追加 ImageSet ました。
操作 replaceImage 追加しました。
操作 copyImage 追加しました。
setUrlModifier、urlModifier/urlPostApplyModifier、LayerViewInfo に TemplateInfo 操作フィールドと WatermarkInfo フィールドを追加しました。
操作 createDerivedAsset 追加しました。 現在、ownerHandle は画像アセットを参照する必要があり、タイプは AdjustedView または LayerView です。
操作 createTemplate 追加しました。 テンプレートまたは透かしアセットを作成するための呼び出し。
Web サービス API に移植される、CompanySettings の IPS 会社設定。
操作 excludeByproducts フィルターフラグ searchAssets 追加しました。 このフラグを true に設定すると、画像とPDFPSDlayer 取り込まれた画像が実行されます。
操作 getGenerationInfo 追加しました。
操作 SystemMessage プロパティ名を追加 getProperty ました。
一部のアセットタイプ文字列定数を、対応するアセット情報フィールドに一致するように変更しました。
- WordDoc: Word
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: Rtf
成功、警告およびエラーを要約するために、バッチ操作の結果形式を変更しました。
バッチメタデータ操作 batchSetAssetMetadata 実装しました。
アプリ固有のデータのサポートを実装しました。
アップロードジョブの createTemplate、extendLayers、extractText のブールフラグのサポートを実装して、Photoshop処理のプロセス(ファイルのアップロードを追加する場合の変更と同様)を制御できるようになりました。
setImageMaps および setZoomTargets の操作を実装しました。
ViewerPreset 操作を実装しました。 認識されるタイプは次のとおりです。
VideoPlayer(ビデオではこれらのビューアのみが公開されます)。BrochureBasicZoomAdvancedZoomSpinCustom types
ビューアスキンは、skinFg と skinBg の 2 つのパラメーターをサポートしています。 バックエンドコードは、後方互換性を維持するために必要なすべての処理を行います。
操作 getAssociatedAssets 実装しました。
以前 ReprocessAssets アップロードしたプライマリソースファイルの再処理(PDF の再取り込みや画像の再最適化など)を可能にするジョブタイプが追加されました。
PropertySetType フィールドタイプの名前を propertyType に変更しました。 この名前の変更は、createPropertySetType パラメーターと応答 getPropertySetType/getPropertySetTypes 影響します。
画像ユーザーデータやその他の編集可能な画像フィールドの設定をサポートする batchSetImageFields 操作を実装しました。
47 様々なアセット情報タイプに fileSize フィールドを追加しました。
VignetteInfoCabinetInfoWindowCoveringInfoIccProfileInfoFontInfoXslInfoViewerSwfInfoXmlInfoSvgInfoZipInfoVideoInfoAcoInfoPdfInfoPsdInfoFlashInfoInDesignInfoPostScriptInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoRTFInfo
操作 getActivePublishContexts 実装しました。 この操作は、指定された会社のアクティブな公開サーバーを含む公開コンテキスト名の配列を返します。 現在の公開コンテキスト名は次のとおりです。
ImageServingImageRenderingVideo
操作 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)で渡すことができます - ブール値フィールドの場合、
boolValはEqualsの op で渡すことができます。 - 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を渡すか、数値範囲演算子(Between, NotBetween)を使用して minDate/maxDate を渡すことができます。
説明、jobSubType、originalJobName の各フィールドを JobLog タイプに追加しました。
originalJobNameは、submitJobに送信されるジョブ名です(一意性サフィックスまたは後続のジョブ名はありません)。jobSubTypeは、ImageServingPublishJobジョブ(full、increment, fullwithsearch,、fulloverrideのいずれか)でのみ使用されます。descriptionは、すべてのジョブタイプで空の文字列ですが、最終的にはアップロードパスなどの概要ジョブ情報が含まれます。
さらに、次のフィールドは getJobLogs と getJobLogDetails の両方に含まれていません。 以前のバージョンでは、getJobLogDetails でのみ使用できました。
endDate(ジョブが完了した場合)。fileDuplicateCount(以前は常に0とgetJobLogsっていました)fileUpdateCount(以前は常に0とgetJobLogs合され、fileSuccessCountに含まれていましたが、現在は別々のフィールドに分割されています)。
JobLogDetail タイプに assetHandle フィールドを追加しました。
submitJob にオプションの説明パラメーターを追加しました。 このパラメーターは、getScheduledJobs、getActiveJobs、getJobLogs で取得するために渡されます。
「SKU システム」フィールドを非推奨(廃止予定)にしました。 フィールドが SystemFieldCondition に searchAssets として渡された場合、このフィールドは無視されます。
excludeAssetTypeArray に searchAssets フィルターを追加しました。
MaskInfo タイプを Asset に追加しました。
IPS で管理する新しいアセットタイプを追加しました。
UploadDirectoryJob および UploadUrlsJob に、Postscript、Illustrator、PDFの各ファイルの処理を個別に制御するオプションを追加しました。 既存のすべてのジョブは、3 つの処理パイプラインのそれぞれに必要なパラメーターを提供するので、現在どおりに正確に機能します。 元の PostScriptOptions ブロックは、IllustratorおよびEPS/PS ファイルの処理を設定するために使用されます。 オプションで、特定のファイルオプションブロックを指定して、処理を指定できます。 変更のリストには、次が含まれます。
-
None
-
ラスタライズ (デフォルト)
-
アセットを管理するだけです。アップロード時に派生画像を作成しません。
-
EPSおよびPostScript ファイルを所定の解像度とカラースペースで画像にレンダリングします。
alpha
オプション。
- None
- Rasterize (デフォルト)
-
アセットを管理するだけです。アップロード時に派生画像を作成しません。
-
ファイルを所定の解像度とカラースペースでイメージにレンダリングします。
alpha
オプション。
-
None
-
Rasterize (デフォルト)
-
アセットを管理するだけです。アップロード時に派生画像を作成しません。
-
ファイルを所定の解像度とカラースペースでイメージにレンダリングします。
getScheduledJobs からクエリすることもできます。
webservice.gzip.response 設定プロパティを変更して、次のいずれかの値を取るようになりました。