Restituisce tutte le cartelle e le sottocartelle, a partire dal percorso della cartella. La risposta getFolders restituisce un massimo di 100.000 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
IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser
Per restituire i dati contenuti nella cartella, l’utente deve disporre dell’accesso in lettura.
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 |
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>