getFolders

Restituisce tutte le cartelle e le sottocartelle, a partire dal percorso della cartella. La risposta getFolders restituisce un massimo di 100.000 cartelle.

Scopo delle cartelle

Una cartella consente di organizzare sottocartelle e risorse. Tutti i nomi delle cartelle e delle risorse devono essere univoci. Le cartelle e le risorse che condividono lo stesso nome causeranno un conflitto nello spazio dei nomi, anche se si trovano in gerarchie di cartelle diverse.
Sintassi

Tipi di utenti autorizzati

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalUser
  • ImagePortalContrib
  • ImagePortalContribUser
NOTA

L'utente deve disporre dell'accesso in lettura alla cartella per restituire i dati in essa contenuti.

Parametri

Input (getFoldersParam)

Nome Tipo Obbligatorio Descrizione
companyHandle xsd:string La maniglia per l'azienda.
accessUserHandle xsd:string No Utilizzato dagli amministratori per rappresentare un utente specifico.
accessGroupHandle xsd:string No Filtra per un gruppo specifico.
folderPath xsd:string No La cartella principale per recuperare le cartelle e tutte le sottocartelle al livello foglia. Se non specificato, viene utilizzata la directory principale della società.
assetTypeArray types:StringArray No Restituisce cartelle che contengono solo i tipi di risorse specificati.
responseFieldArray types:StringArray No Contiene un elenco di campi che si desidera includere nella risposta.
excludeFieldArray types:StringArray No Contiene un elenco di campi che desideri escludere dalla risposta.

Output (getFoldersReturn)

Nome Tipo Obbligatorio Descrizione
folderArray types:FolderArray No Matrice di cartelle che corrispondono ai criteri di filtro. La risposta è limitata a massimo 100.000 cartelle.
permissionsSetArray types:PermissionSetArray

Esempi

Questo esempio di codice restituisce un array che contiene tutte le cartelle di un’azienda insieme a informazioni specifiche su ciascuna cartella.

Request Contents (Richiesta contenuto)

<ns1:getFoldersParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
</ns1:getFoldersParam>

Risposta

<getFoldersReturn xmlns="http://www.scene7.com/IpsApi/xsd">
   <folderArray>
      <items>
         <folderHandle>MyCompany/</folderHandle>
         <path>MyCompany/</path>
         <hasSubfolders>false</hasSubfolders>
      </items>
      <items>
         <folderHandle>MyCompany/eCatalogs/</folderHandle>
         <path>MyCompany/eCatalogs/</path>
         <hasSubfolders>false</hasSubfolders>
      </items>
      <items>
         <folderHandle>MyCompany/PDF/</folderHandle>
         <path>MyCompany/PDF/</path>
         <hasSubfolders>false</hasSubfolders>
      </items>
   </folderArray>
</getFoldersReturn>

In questa pagina