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 causano un conflitto di namespace, anche se si trovano in gerarchie di cartelle diverse.
Sintassi

Tipi di utenti autorizzati

IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser

NOTA

Per restituire i dati contenuti nella cartella, l’utente deve disporre dell’accesso in lettura.

Parametri

Input (getFoldersParam)

Nome	Tipo	Obbligatorio	Descrizione
companyHandle	`xsd:string`	Sì	Il manico per l'azienda.
accessUserHandle	`xsd:string`	No	Utilizzato dagli amministratori per rappresentare un utente specifico.
accessGroupHandle	`xsd:string`	No	Filtrare per un gruppo specifico.
folderPath	`xsd:string`	No	Cartella principale per recuperare cartelle e sottocartelle a livello foglia. Se viene esclusa, viene utilizzata la radice della società.
assetTypeArray	`types:StringArray`	No	Restituisce cartelle che contengono solo 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 da escludere dalla risposta.

Output (getFoldersReturn)

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

Esempi

Questo esempio di codice restituisce un array contenente 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>