설명서Dynamic Media 이미지 프로덕션 시스템 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
예
자산을 소유하는 회사에 대해 을(를) 처리합니다.
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이(가) PdfFile 자산인 경우 이 assetHandler에서 생성된 이미지 목록을 포함할 수 있습니다.
thumbAsset
유형:Asset
아니요
요청 에셋과 연결된 썸네일 에셋 정보. 썸네일 자산이 지정되지 않은 경우 응답에서 필드가 생략됩니다.

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

예제 section-8946ea4b9cb94912a8408249c897f192

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

응답

없음.

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