getAssociatedAssets

지정된 자산과 연결된 자산 및 해당 관계의 세부 정보를 가져옵니다.

구문

인증된 사용자 유형

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

매개 변수

입력(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은(는) 이 assetHandler에서 생성된 이미지 목록이 PdfFile 자산인 경우 포함할 수 있습니다.

thumbAsset 유형:자산

아니요

요청 자산과 연관된 경험 자산 정보입니다. 엄지손가락 자산이 할당되지 않은 경우 응답에서 필드가 생략됩니다.

매개 변수 responseFieldArray 또는 excludeFieldArray을 사용하여 응답 크기를 제한할 수 있습니다. 특히 generatorArray 또는 generatedArray에서 반환되는 GenerationInfo 항목은 기본적으로 작성자와 생성된 자산 레코드를 모두 포함합니다. PDF 자산 유형의 경우, 이 동작으로 응답에 "작성자" PDF 자산 레코드의 여러 복사본이 원치 않게 됩니다. excludeFieldArraygeneratedArray/items/originator을 추가하여 이 문제를 제거할 수 있습니다. 또는 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>

응답

없음.

이 페이지에서는