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>

응답

없음.