新しい追加と変更 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 操作に VideoRootUrlSwfRootUrl のプロパティを追加しました。

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

WSDL 生成サーブレットにオプションの serviceUrl パラメーターを追加しました。 このパラメーターはデバッグプロキシで役立ちます。 例: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 操作に有効フラグを追加しました。

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

一括公開状態アップデート用に setAssetsPublishState を追加しました。

ImageServingPublishSettingsgetImageServingPublishSettingssetImageServingPublishSettings を追加しました。

新しい createMetadataField および updateMetadataField の操作に置き換えて、saveMetadataField の操作を非推奨(廃止予定)としました。

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

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

操作 deleteMetadataField 実装しました。

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

実装 getAssetCounts

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

操作 replaceImage 追加しました。

操作 copyImage 追加しました。

LayerViewInfoTemplateInfoWatermarkInfosetUrlModifier 操作フィールドと 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 実装しました。

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

アップロードジョブの createTemplateextendLayersextractText のブールフラグのサポートを実装して、Photoshop処理のプロセス(ファイルのアップロードを追加する場合の変更と同様)を制御できるようになりました。

setImageMaps および setZoomTargets の操作を実装しました。

ViewerPreset 操作を実装しました。 認識されるタイプは次のとおりです。

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

ビューアスキンは、skinFgskinBg の 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 ヘッダーのサポートを実装しました。

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

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

  • すべてのフィールドタイプで、値は文字列比較演算子(Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith)で渡すことができます
  • ブール値フィールドの場合、boolValEquals の 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 を渡すことができます。

説明、jobSubTypeoriginalJobName の各フィールドを JobLog タイプに追加しました。

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

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

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

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

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

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

searchAssetsexcludeAssetTypeArray フィルターを追加しました。

MaskInfo タイプを Asset に追加しました。

IPS で管理する新しいアセットタイプを追加しました。

アセットタイプ
説明
Illustrator
Adobe Illustrator ファイル。
PostScript
EPS ファイルとPostScript ファイル。
WordDoc
.doc で終わるファイルのMicrosoft® Word ドキュメント。
ExcelDoc
.xls で終わるファイルのMicrosoft® Excel ドキュメント。
PowerPointDoc
.ppt で終わるファイルのMicrosoft® PowerPoint ドキュメント
RTFDoc
.rtf で終わるアップロードされたファイルの RTF ファイル。

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

フィールド
パラメータ
説明
PostScriptOptions
process
  • None

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

  • アセットを管理するだけです。アップロード時に派生画像を作成しません。

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

alpha

オプション。

<boolean>
ファイルを画像にラスタライズするときに有効になります。 元のファイルがロゴのオーバーレイ用にこのように定義されている場合、透明な背景が作成されます。
IllustratorOptions
process
  • None
  • Rasterize (デフォルト)
  • アセットを管理するだけです。アップロード時に派生画像を作成しません。

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

resolution
<integer>
ラスタライズの解像度。
colorspace
レンダリングのターゲットカラースペース。

alpha

オプション。

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

  • Rasterize (デフォルト)

  • アセットを管理するだけです。アップロード時に派生画像を作成しません。

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

resolution
<integer>
ラスタライズの解像度。
colorspace
レンダリングのターゲットカラースペース。
pdfCatalog
<boolean>
レンダリング後に複数ページのPDFを eCatalog に結合するかどうかを定義します(デフォルトは true)。
extractSearchWords
<boolean>
後で検索サーバーに提供するために、PDFの単語を DB に抽出するかどうかを指定します(デフォルトは false)。

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

webservice.gzip.response 設定プロパティを変更して、次のいずれかの値を取るようになりました。

説明
never
応答を gzip 形式で圧縮しないでください。
soap
authHeader/gzipResponse が true の場合にのみ gzip 応答を返します。
accept
Gzip :authHeader/gzipResponse が true の場合、または gzipResponse ヘッダーが存在せず、HTTP Accept-Encoding ヘッダーに gzip が含まれている場合。 (デフォルト)。
always
ヘッダー値に関係なく、常に gzip 応答。 この値はデバッグ目的でのみ使用してください。
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681