getAssociatedAssets

지정된 자산과 연관된 자산 및 해당 관계에 대한 세부 사항을 가져옵니다.

구문

인증된 사용자 유형

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

매개 변수

입력(getAssociatedAssetsParam)

이름

유형

필수

설명

companyHandle

xsd:문자열

자산을 소유한 회사에 대해 취급합니다.

assetHandle

xsd:문자열

자산 핸들.

responseFieldArray

types:StringArray

아니요

원하는 응답 필드의 배열입니다. 소개 내용에서 response- FieldArray/excludeFieldArray를 참조하십시오.

excludeFieldArray

types:StringArray

아니요

제외된 응답 필드의 배열입니다. 소개 내용에서 response- FieldArray/excludeFieldArray를 참조하십시오.

출력(getAssociatedAssetsReturn)

이름

유형

필수

설명

containerArray 유형:AssetArray

아니요

지정된 자산이 포함된 세트 및 템플릿 자산의 배열입니다.

memberArray 유형:AssetArray

아니요

지정된 세트 또는 템플릿 자산에 포함된 자산의 배열입니다.

layerReferenceArray 유형:AssetArray

아니요

레이어 또는 템플릿 URL에서 참조되는 자산의 배열입니다.

ownerArray 유형:AssetArray

아니요

지정된 자산을 소유하는 자산의 배열입니다.

derivedArray 유형:AssetArray

아니요

지정된 자산을 생성하는 데 사용된 자산의 배열입니다.

generatorArray types:GenerationInfoArray

아니요

generatorArray에는 이 에셋을 만든 방법이 나열됩니다. 예를 들어 assetHandler가 PDF의 이미지 페이지인 경우 PDF 프로세서 도구가 포함되고 PdfFile 에셋을 참조합니다.

generatedArray types:GenerationInfoArray

아니요

generatedArray는 이 에셋을 만든 방법을 반전합니다. 예를 들어 generatedArray에는 이 assetHandler에서 생성된 이미지 목록이 포함될 수 있습니다(PdfFile 자산인 경우).

thumbAsset 유형:에셋

아니요

요청 자산과 연결된 축소판 자산 정보. 축소판 자산이 할당되지 않은 경우 응답에서 필드가 생략됩니다.

매개 변수 responseFieldArray 또는 excludeFieldArray을 사용하여 응답 크기를 제한할 수 있습니다. 특히 generatorArray 또는 generatedArray에서 반환되는 GenerationInfo 항목은 기본적으로 작성자와 생성된 에셋 레코드를 모두 포함합니다. PDF 에셋 유형의 경우 이 비헤이비어는 응답에 "작성자" PDF 에셋 레코드의 원치 않는 여러 사본을 생성합니다. generatedArray/items/originator을(를) excludeFieldArray에 추가하여 이 문제를 제거할 수 있습니다. 또는 responseFieldArray에 포함할 명시적 응답 필드 목록을 지정할 수 있습니다.

예제

다음 기본 예는 PDF에서 추출된 이미지에 대한 생성기 핸들의 요청입니다. 여기에는 PDF의 assetHandle을 포함하는 항목이 있는 길이 1의 containerArray이 포함됩니다.

요청

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

응답

없음.

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now