getAssociatedAssets

마지막 업데이트: 2023-05-22
  • 작성 대상:
  • Developer
    Admin

지정된 에셋과 연결된 에셋 및 해당 관계에 대한 세부 정보를 가져옵니다.

구문

승인된 사용자 유형

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

매개 변수

입력(getAssociatedAssetsParam)

이름

유형

필수

설명

company핸들

xsd:string

자산을 소유하는 회사에 대해 을(를) 처리합니다.

assetHandle

xsd:string

에셋 핸들.

responseFieldArray

types:StringArray

아니요

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

exclude필드 배열

types: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 PdfFile 자산인 경우

thumbAsset 유형:에셋

아니요

요청 에셋과 연결된 썸네일 에셋 정보. 썸네일 자산이 지정되지 않은 경우 응답에서 필드가 생략됩니다.

매개 변수를 사용할 수 있습니다 responseFieldArray 또는 excludeFieldArray 응답 크기를 제한합니다. 특히 GenerationInfo 반환된 항목 generatorArray 또는 generatedArray 원본과 생성된 에셋 레코드를 모두 포함하는 기본값입니다. PDF 에셋 유형의 경우, 이 동작으로 인해 응답에 "작성자" PDF 에셋 레코드의 복사본이 원치 않게 여러 개 표시됩니다. 을 추가하여 이 문제를 제거할 수 있습니다. generatedArray/items/originatorexcludeFieldArray. 또는 포함할 응답 필드의 명시적 목록을 지정할 수 있습니다 responseFieldArray.

예제

다음의 기본 예는 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>

응답

없음.

이 페이지에서는