文件Dynamic Media Image Production System API

getAssociatedAssets getassociatedassets

Last update: Fri May 26 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
  • Admin

取得與指定資產相關聯的資產以及與其關係的詳細資訊。

語法

授權的使用者型別 section-453cc706400345778713cda249bfac16

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalUser
  • ImagePortalContrib
  • ImagePortalContribUser

參數 section-d11d0dab59e94e89b466123a0ebfa82e

輸入(getAssociatedAssetsParam)

名稱
類型
必要
說明
companyHandle
xsd:string
是
處理擁有資產的公司。
assetHandle
xsd:string
是
資產控點。
responseFieldArray
型別：StringArray
否
所需的回應欄位陣列。 請參閱簡介中的response- FieldArray/excludeFieldArray 。
excludeFieldArray
型別：StringArray
否
排除的回應欄位陣列。 請參閱簡介中的response- FieldArray/excludeFieldArray 。

輸出(getAssociatedAssetsReturn)

名稱
類型
必要
說明
containerArray
型別：AssetArray
否
包含指定資產的集合與範本資產陣列。
memberArray
型別：AssetArray
否
指定集或範本資產所包含的資產陣列。
layerReferenceArray
型別：AssetArray
否
圖層或範本URL中參照的資產陣列。
ownerArray
型別：AssetArray
否
擁有指定資產的資產陣列。
derivedArray
型別：AssetArray
否
用來產生指定資產的資產陣列。
generatorarray
型別：GenerationInfoArray
否
此 generatorarray 列出建立此資產的方式。 例如，如果 assetHandler 是PDF的影像頁面，則其中會包含PDF處理器工具並參照PdfFile資產。
generatedArray
型別：GenerationInfoArray
否
此 generatedArray 反轉建立此資產的方式。 例如， generatedArray 可以包含由此產生的影像清單 assetHandler 如果這是Pdf檔案資產。
thumbAsset
型別：資產
否
與請求資產相關聯的縮圖資產資訊。 如果未指派縮圖資產，回應中會忽略欄位。

您可以使用引數 responseFieldArray 或 excludeFieldArray 以限制回應大小。 尤其是 GenerationInfo 專案傳回 generatorArray 或 generatedArray 預設為同時包含建立者和產生的資產記錄。 對於PDF資產型別，此行為會在回應中導致不需要的「創作者」PDF資產記錄多個副本。 您可以透過新增以下專案來消除此問題 generatedArray/items/originator 至 excludeFieldArray. 或者，您可以指定要加入的明確回應欄位清單 responseFieldArray.

範例 section-8946ea4b9cb94912a8408249c897f192

以下基本範例是為從PDF擷取的影像要求產生器的控制代碼。 它包含 containerArray 長度為1，且專案包含 assetHandle PDF的。

請求

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:beta="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
   <soap:Body>
      <beta:getAssociatedAssetsParam>
         <beta:companyHandle>c|11</beta:companyHandle>
         <beta:assetHandle>a|197</beta:assetHandle>
         <beta:responseFieldArray>
            <beta:items>containerArray/items/assetHandle</beta:items>
         </beta:responseFieldArray>
      </beta:getAssociatedAssetsParam>
   </soap:Body>
</soap:Envelope>

回答

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <getAssociatedAssetsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
         <containerArray>
            <items>
               <assetHandle>a|207</assetHandle>
            </items>
         </containerArray>
      </getAssociatedAssetsReturn>
   </soapenv:Body>
</soapenv:Envelope>

上述範例的相反情況如下：

請求

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:beta="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
   <soap:Body>
      <beta:getAssociatedAssetsParam>
         <beta:companyHandle>c|11</beta:companyHandle>
         <beta:assetHandle>a|177</beta:assetHandle>
        <beta:responseFieldArray>
           <beta:items>generatedArray/items/originator/assetHandle</beta:items>
         </beta:responseFieldArray>
      </beta:getAssociatedAssetsParam>
   </soap:Body>
</soap:Envelope>

回答

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <getAssociatedAssetsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2013-08-29-beta">
         <generatedArray>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
            <items>
               <originator>
                  <assetHandle>a|177</assetHandle>
               </originator>
            </items>
         </generatedArray>
      </getAssociatedAssetsReturn>
   </soapenv:Body>
</soapenv:Envelope>

在下個範例中，群組會新增至公司，具有 groupHandleArray. 此範例僅使用一個群組。

請求

<ns1:addGroupMembershipParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:groupHandleArray><ns1:items>225</ns1:items></ns1:groupHandleArray>
</ns1:addGroupMembershipParam>

回答

無。

recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681