searchAssetsByMetadata

Cerca nell'archivio dell'indice dei metadati i termini di ricerca specificati. Restituisce i dati delle risorse come il metodo searchAssets.

Quando searchAssetsByMetadata consente di eseguire ricerche nei campi metadati definiti dall’utente, ma tali campi non vengono restituiti se sono specificati nel campo responseMetadataArray. Per illustrare questo punto, nell'esempio di codice seguente:

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

restituisce un valore null:

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

Per risolvere questo problema, puoi utilizzare il fieldHandles delle risorse restituite dalla ricerca da eseguire getAssets (vedi anche getAssets). Questo metodo ottiene i valori dei campi definiti dall'utente per le risorse in questione. Utilizza il seguente esempio di sintassi per cercare nei campi metadati definiti dall'utente:

<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>

Tipi di utenti autorizzati

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

Parametri

Input (searchAssetsByMetadataParam)

Nome Tipo Obbligatorio Descrizione

companyHandle

xsd:string

Il manico per l'azienda.

Filtro

tipo:SearchFilter

No

Filtri che consentono di definire i criteri di ricerca.

Vedi SearchFilter.

metadataConditionArray

tipo:MetadataConditionArray

No

Condizioni che definiscono i criteri di ricerca. Per ulteriori informazioni, consulta di seguito.

responseMetadataArray

type:StringArray

No

Campi aggiuntivi da compilare nella risposta nel riepilogo risorse. I campi devono essere specificati nel formato normalizzato.

recordsPerPage

xsd:int

No

Numero di risorse restituite dalla risposta. Il valore predefinito è 1000.

resultPage

xsd:int

No

Specifica la pagina dei risultati da restituire, in base a recordsPerPage dimensioni della pagina.

sortBy

xsd:string

No

Ordina per campo risorsa selezionato.

sortDirection

xsd:string

No

Scelta del tipo di direzione. Crescente è l'impostazione predefinita.

Output (searchAssetsByMetadataReturn)

Nome Tipo Obbligatorio Descrizione
totalRows xsd:int No Numero di corrispondenze.
assetArray types:AssetArray No Array di risorse restituite dalla ricerca.

Dettagli metadataConditionArray

Struttura dell'articolo

metadataConditionArray la struttura è la seguente:

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

Valori

field_handle è la chiave di ricerca dei metadati. Può contenere la notazione del punto. I valori possibili sono:

  • asset_id (senza prefisso)

  • name

  • folder_path

  • type

  • file_name

  • description

  • comment

  • user_data

  • sku

  • modified_at

  • modified_by

  • created_at (uguale a modified_at (Data nel modulo: 25 luglio 2014 22:13:45 GMT-0500 (CDT))

  • created_by

Operatori consentiti

La operator definisce come confrontare il valore e includere:

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

La comparison_value è il termine da cercare.

Esempi

Questo esempio di codice esegue una ricerca con i seguenti criteri di metadati:

  • name contiene 1000801.

  • dc.rights campo uguale a Per Jessen Schmidt.

Request Contents (Richiesta contenuto)

<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>

Risposta

<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>

In questa pagina