文件Dynamic Media Image Production System API

getAssociatedAssets getassociatedassets

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
  • 管理員

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

語法

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

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

參數 section-d11d0dab59e94e89b466123a0ebfa82e

輸入(getAssociatedAssetsParam)

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

輸出(getAssociatedAssetsReturn)

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

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

範例 section-8946ea4b9cb94912a8408249c897f192

下列基本範例是針對從PDF擷取之影像的產生器控制代碼的要求。 它包含長度為containerArray的專案，其中包含PDF的assetHandle。

要求

<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