getFolders

Devuelve todas las carpetas y subcarpetas, empezando por la ruta de carpeta. La respuesta getFolders devuelve un máximo de 100 000 carpetas.

Finalidad de las carpetas

Una carpeta permite organizar subcarpetas y recursos. Todos los nombres de carpetas y recursos deben ser únicos. Las carpetas y recursos que comparten el mismo nombre causarán un conflicto de área de nombres, incluso si están en jerarquías de carpetas diferentes.
Sintaxis

Tipos de usuarios autorizados

IpsUser
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
TrialSiteUser
ImagePortalAdmin
ImagePortalUser
ImagePortalContrib
ImagePortalContribUser

NOTA

El usuario debe tener acceso de lectura a la carpeta para devolver datos sobre ella.

Parámetros

Entrada (getFoldersParam)

Nombre	Tipo	Obligatorio	Descripción
companyHandle	`xsd:string`	Sí	El identificador de la compañía.
accessUserHandle	`xsd:string`	No	Los administradores los utilizan para suplantar a un usuario específico.
accessGroupHandle	`xsd:string`	No	Filtre por un grupo específico.
folderPath	`xsd:string`	No	La carpeta raíz para recuperar carpetas y todas las subcarpetas al nivel de hoja. Si se excluye, se utiliza la raíz de la empresa.
assetTypeArray	`types:StringArray`	No	Devuelve carpetas que solo contienen tipos de recursos especificados.
responseFieldArray	`types:StringArray`	No	Contiene una lista de los campos que desea incluir en la respuesta.
excludeFieldArray	`types:StringArray`	No	Contiene una lista de los campos que desea excluir de la respuesta.

Salida (getFoldersReturn)

Nombre	Tipo	Obligatorio	Descripción
folderArray	`types:FolderArray`	No	Matriz de carpetas que coinciden con los criterios de filtro. La respuesta está limitada a un máximo de 100 000 carpetas.
permissionsSetArray	`types:PermissionSetArray`

Ejemplos

Este ejemplo de código devuelve una matriz que contiene todas las carpetas de una compañía junto con información específica sobre cada carpeta.

Solicitar

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

Respuesta

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