文件Dynamic Media Image Production System API

searchAssetsByMetadata searchassetsbymetadata

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
  • 管理員

搜尋指定搜尋詞的中繼資料索引儲存區域。 傳回資產資料，如searchAssets方法。

雖然searchAssetsByMetadata可讓您搜尋使用者定義的中繼資料欄位，但若在responseMetadataArray中指定這些欄位，則不會傳回這些欄位。 為了說明這一點，以下程式碼範例將說明這一點：

<ns:responseMetadataArray>
 <ns:items>custom_attributes.x</ns:items>
</ns:responseMetadataArray>

傳回null值：

<items>
 <name>custom_attributes.x</name>
 <value>null</value>
</items>

若要解決此問題，您可以使用搜尋傳回的資產的fieldHandles來執行getAssets （另請參閱getAssets）。 此方法會取得相關資產的使用者定義欄位值。 使用下列語法範例來搜尋使用者定義的中繼資料欄位：

<ns:metadataConditionArray>
 <ns:items>
  <ns:fieldHandle>custom_attributes.[UDF Field Name]</ns:fieldHandle>
  <ns:op>[Conditional]</ns:op>
  <ns:value>[Value]</ns:value>
 </ns:items>
</ns:metadataConditionArray>

授權的使用者型別 section-9f85dd55ab574104b5fdc0f95aa0a0e2

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalUser
  • ImagePortalContrib
  • ImagePortalContribUser

參數 section-5f1edb9c5b914160ab361f4364b8aa8d

輸入(searchAssetsByMetadataParam)

名稱
類型
必要
說明
companyHandle
xsd：string
是
公司的控制代碼。
篩選器
型別：SearchFilter
否

可協助您定義搜尋條件的篩選器。

請參閱 SearchFilter。

metadataConditionArray
型別：MetadataConditionArray
否
定義搜尋條件的條件。 如需詳細資訊，請參閱下文。
responseMetadataArray
型別：StringArray
否
您要在資產摘要的回應中填入的其他欄位。 欄位必須以標準化格式指定。
recordsPerPage
xsd：int
否
回應傳回的資產數量。 預設值為 1000。
個結果頁面
xsd：int
否
根據 recordsPerPage頁面大小，指定要傳回的結果頁面。
sortBy
xsd：string
否
依選取的資產欄位排序。
sortDirection
xsd：string
否
選擇排序方向。 預設值為升序。

輸出(searchAssetsByMetadataReturn)

名稱
類型
必要
說明
totalRows
xsd:int
否
相符數。
assetArray
types:AssetArray
否
搜尋傳回的資產陣列。

metadataConditionArray詳細資料 section-1af4a4a22f82451eabdf6dfe13d9f27d

專案結構

metadataConditionArray結構如下：

<ns1:items>
   <ns:fieldHandle>field_handle</ns:fieldHandle>
   <ns:op>operator</ns:op>
   <ns:value>comparison_value</ns:value>
</ms1:items>

值

field_handle是中繼資料搜尋索引鍵。 其中可包含點標籤法。 可能的值包括：

  • asset_id （沒有前置詞）

  • name

  • folder_path

  • type

  • file_name

  • description

  • comment

  • user_data

  • sku

  • modified_at

  • modified_by

  • created_at (與modified_at相同(日期格式為：2014年7月25日星期五22:13:45 GMT-0500 (CDT))

  • created_by

允許的運運算元

operator定義如何比較值並包含：

  • Equals
  • NotEquals
  • Contains
  • NotContains
  • StartsWith
  • EndsWith

comparison_value是要搜尋的字詞。

範例 section-53a12b9c023e4e629eddf5719c955ad4

此程式碼範例會使用下列中繼資料條件來執行搜尋：

  • name欄位包含1000801。

  • dc.rights欄位等於Per Jessen Schmidt。

要求

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.scene7.com/IpsApi/xsd"
xmlns:ns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <soapenv:Header>
      <xsd:authHeader>
          <xsd:user>user@adobe.com</xsd:user>
          <xsd:password>topSecret</xsd:password>
      </xsd:authHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ns:searchAssetsByMetadataParam>
         <ns:companyHandle>c|656</ns:companyHandle>
         <ns:metadataConditionArray>
            <ns:items>
               <ns:fieldHandle>name</ns:fieldHandle>
               <ns:op>Contains</ns:op>
               <ns:value>1000801</ns:value>
            </ns:items>
            <ns:items>
               <ns:fieldHandle>dc.rights</ns:fieldHandle>
               <ns:op>Equals</ns:op>
               <ns:value>Per Jessen Schmidt</ns:value>
            </ns:items>
         </ns:metadataConditionArray>
         <ns:responseMetadataArray>
            <ns:items>dc.subject</ns:items>
            <ns:items>xmp.CreatorTool</ns:items>
         </ns:responseMetadataArray>
      </ns:searchAssetsByMetadataParam>
   </soapenv:Body>
</soapenv:Envelope>

回應

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body>
      <searchAssetsByMetadataReturn xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
         <totalRows>1</totalRows>
         <assetSummaryArray>
            <items>
               <assetHandle>a|885289</assetHandle>
               <type>Image</type>
               <name>test9-1000801</name>
               <folder>Extroscope/Test subfolders/</folder>
               <filename>test9-1000801.jpg</filename>
               <created>2009-11-19T07:21:24.252-08:00</created>
               <createUser>pschmidt@adobe.com</createUser>
               <lastModified>2009-11-19T07:21:25.487-08:00</lastModified>
               <lastModifyUser>pschmidt@adobe.com</lastModifyUser>
               <metadataArray>
                  <items>
                     <name>dc.subject</name>
                     <value>[San Fransico, USA</value>
                  </items>
                  <items>
                     <name>xmp.CreatorTool</name>
                     <value>Ver.1.0</value>
                  </items>
               </metadataArray>
            </items>
         </assetSummaryArray>
      </searchAssetsByMetadataReturn>
   </soapenv:Body>
</soapenv:Envelope>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681