설명서Dynamic Media 이미지 프로덕션 시스템 API

getAssociatedAssets getassociatedassets

Last update: Mon May 22 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)

이름
유형
필수
설명
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/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