getFolders

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

Objetivo 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 provocarán un conflicto en el área de nombres, incluso si se encuentran 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.

Parámetros

Entrada (getFoldersParam)

Nombre Tipo Obligatorio Descripción
companyHandle xsd:string Sí El identificador de la empresa.
accessUserHandle xsd:string No Utilizado por los administradores para suplantar a un usuario específico.
accessGroupHandle xsd:string No Filtrar por un grupo específico.
folderPath xsd:string No La carpeta raíz para recuperar carpetas y todas las subcarpetas en el 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 campos que desea incluir en la respuesta.
excludeFieldArray types:StringArray No Contiene una lista de 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 del 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 empresa 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>

En esta página