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