DocumentatieDynamic Media Image Production System API

getFolderTree

Laatst bijgewerkt: 8 maart 2022
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
  • Beheerder

Retourneert mappen en submappen in een hiërarchische boomstructuur. De reactie getFolderTree is beperkt tot maximaal 100.000 mappen

Syntaxis

Geautoriseerde gebruikerstypen

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalContrib
  • ImagePortalContribUser
OPMERKING
De gebruiker moet lees toegang tot de omslag hebben om gegevens op het terug te keren.

Parameters

Input (getFolderTreeParam)

NaamTypeVereistBeschrijving
companyHandlexsd:stringJaDe handgreep aan het bedrijf.
accessUserHandlexsd:stringNeeWordt alleen door beheerders gebruikt om zich voor te doen als een specifieke gebruiker.
accessGroupHandlexsd:stringNeeWordt gebruikt om te filteren op een specifieke groep, inclusief een groep waartoe het bedrijf behoort.
folderPathxsd:stringNeeDe hoofdmap om mappen en alle submappen op te halen naar bladniveau. Indien uitgesloten, wordt de bedrijfwortel gebruikt.
dieptexsd:intJaBij de waarde nul wordt de map op hoofdniveau opgehaald. Elke andere waarde geeft de diepte aan die in de boomstructuur moet afnemen.
assetTypeArraytypes:StringArrayNeeRetourneert mappen die alleen opgegeven elementtypen bevatten.
responseFieldArraytypes:StringArrayNeeBevat een lijst met velden die u wilt opnemen in het antwoord.
excludeFieldArraytypes:StringArrayNeeBevat een lijst met velden die u wilt uitsluiten in het antwoord.

Output (getFolderTreeReturn)

NaamTypeVereistBeschrijving
mappentypes:foldersNeeDe hiërarchie van mappen in een boomstructuur. De reactie is beperkt tot maximaal 100.000 mappen.
permissionSetArraytypes:PermissionSetArray

Voorbeelden

Deze codesteekproef gebruikt een bedrijfshandvat en een diepteparameter om het niveau van diepte te bepalen de reactie zou moeten terugkeren. Het antwoord bevat mappen en submappenarrays met verwante items. Stel de dieptewaarde in op een kleiner getal om dieper in de mapstructuur te zoeken.

Verzoek

<ns1:getFolderTreeParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:depth>-1</ns1:depth>
</ns1:getFolderTreeParam>

Antwoord

<getFolderTreeReturn xmlns="http://www.scene7.com/IpsApi/xsd/">
  <folders>
    <items>
      <folderHandle>f|sampleFolder/uploadTestDir/</folderHandle>
      <path>MyCompany/uploadTestDir/</path>
      <lastModified>2011-11-14T11:19:59.031-08:00</lastModified>
      <childLastModified>2011-11-14T11:19:59.031-08:00</childLastModified>
      <permissionSetHandle>pm|2</permissionSetHandle>
      <hasSubfolders>true</hasSubfolders>
      <subfolderArray>
        <items>
          <folderHandle>f|MyCompany/uploadTestDir/SubFolder/</folderHandle>
          <path>DevanCo/uploadTestDir/SubFolder/</path>
          <lastModified>2011-11-14T11:19:59.032-08:00</lastModified>
          <childLastModified>2011-11-14T11:19:59.032-08:00</childLastModified>
          <permissionSetHandle>pm|2</permissionSetHandle>
          <hasSubfolders>true</hasSubfolders>
          <subfolderArray>
            <items>
              <folderHandle>f|MyCompany/uploadTestDir/SubFolder/10/</folderHandle>
              <path>DevanCo/uploadTestDir/SubFolder/10/</path>
              <lastModified>2011-11-14T11:19:59.033-08:00</lastModified>
              <childLastModified>2011-11-14T15:06:58.563-08:00</childLastModified>
              <permissionSetHandle>pm|2</permissionSetHandle>
              <hasSubfolders>false</hasSubfolders>
            </items>
          </subfolderArray>
        </items>
      </subfolderArray>
    </items>
  </folders>
  <permissionSetArray>
    <items>
      <permissionSetHandle>pm|2</permissionSetHandle>
      <permissionArray>
        <items>
          <groupHandle>g|1</groupHandle>
          <groupName>Asset Download Group</groupName>
          <permissionType>Read</permissionType>
          <isAllowed>true</isAllowed>
          <isOverride>false</isOverride>
        </items>
        <items>
          <groupHandle>g|2</groupHandle>
          <groupName>Asset Upload Group</groupName>
          <permissionType>Read</permissionType>
          <isAllowed>true</isAllowed>
          <isOverride>true</isOverride>
        </items>
        <items>
          <groupHandle>g|2</groupHandle>
          <groupName>Asset Upload Group</groupName>
          <permissionType>Write</permissionType>
          <isAllowed>true</isAllowed>
          <isOverride>true</isOverride>
        </items>
      </permissionArray>
    </items>
  <permissionSetArray>
</getFolderTreeReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681