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

searchAssets searchassets

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자
  • 관리자

지정된 조건을 기반으로 자산을 검색합니다.

구문

searchAssets: 정보 section-4ad74f12eb754768bf85bd235a7e25f0

searchAssets은(는) IPS 자산을 검색하는 기본 방법입니다. 이 방법은 폴더 계층 구조를 찾아보거나 이름별로 특정 에셋을 찾는 등 다양한 용도로 사용됩니다.

응답 크기

searchAssets은(는) 한 번의 호출로 최대 1000개의 자산을 반환합니다. 호출당 최대 10,000개의 자산을 반환하려면 응답 데이터를 totalRows, name, handle, type 및 subType 필드의 하위 집합으로 제한하십시오. 더 큰 집합을 반환하려면 resultPage 매개 변수를 사용하여 페이징을 설정하십시오.

responseFieldArray 또는 excludeFieldArray로 결과 파일 크기 제한

responseFieldArray 또는 excludFieldArray 매개 변수로 데이터 집합의 크기를 제한하십시오. 이러한 매개 변수는 메모리 사용 및 대역폭을 줄이는 데 도움이 되며 서버 응답 시간을 향상시킬 수 있습니다.

승인된 사용자 유형 section-9c4bc41bb8b4493982197eb13c7cdc55

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalUser
  • ImagePortalContrib
  • ImagePortalContribUser
NOTE
자산을 반환하려면 사용자에게 읽기 액세스 권한이 있어야 합니다.

매개 변수 section-49aabc0600764f55a8b7017d86ded44f

입력(searchAssetsParam)

이름
유형
필수?
설명
companyHandle
xsd:string
예
검색할 자산이 있는 회사에 대한 핸들입니다.
accessUserHandle
xsd:string
아니요
관리자가 다른 사용자로 작업할 수 있습니다.
accessGroupHandle
xsd:string
아니요
관리자가 다른 그룹의 일부로 작업할 수 있습니다.
폴더
xsd:string
아니요
에셋 검색을 위한 루트 경로입니다. 생략하면 회사 루트 폴더가 사용됩니다.
includeSubfolder
xsd:boolean
아니요
하위 폴더를 검색하려면 true(으)로 설정하십시오.
publishState
xsd:string
아니요
Publish 주 선택.
trashState
xsd:string
아니요
휴지통 상태 선택. 기본값은 NotInTrash입니다.
conditionMatchMode
xsd:string
아니요

keywordArray의 결과를 결합하기 위한 검색 일치 모드 선택,

conditionMatchMode

systemFieldConditionArray 및 metadataConditionArray. 기본값은 MatchAll입니다.

keywordArray
형식:StringArray
아니요

참고: 더 이상 사용되지 않는 매개 변수. 사용하지 않는 것이 좋습니다.

일치시킬 키워드의 문자열 배열입니다.

systemFieldMatchMode
xsd:string
아니요

개의 systemFieldCondition 일치 항목을 결합하기 위한 검색 일치 모드 선택 기본값은 MatchAll입니다.

.

systemFieldConditionArray
형식:SystemFieldConditionArray
아니요
시스템 필드 조건의 배열입니다.
tagMatchMode
xsd:string
아니요
일치 모드 문자열 상수를 검색합니다. 기본값은 MatchAll입니다.
tagConditionArray
유형:TagConditionArray
아니요

태그 필드 검색 조건자의 배열입니다.

술어는 tagMatchMode 설정에 따라 결합된 다음 conditionMatchMode 설정에 따라 keywordArray, systemFieldConditionArray 및 metadataConditionArray의 모든 용어와 결합됩니다.

metadataMatchMode
xsd:string
아니요
개의 metadataCondition 일치 항목을 결합하기 위한 일치 모드 검색. 기본값은 MatchAll입니다.
metadataConditionArray
형식:MetadataConditionArray
아니요
메타데이터 필드 검색 조건의 배열입니다.
assetTypeArray
형식:StringArray
아니요
검색에 포함할 에셋 유형의 배열입니다.
excludeAssetTypeArray
형식:StringArray
아니요
검색에서 제외할 자산 유형 배열.
assetSubTypeArray
형식:StringArray
아니요
필터링할 하위 유형 이름 목록입니다.
strictSubTypeCheck
xsd:boolean
아니요
true 및 assetSubTypeArray이(가) 비어 있지 않으면 하위 형식이 assetSubTypeArray에 있는 자산만 반환됩니다. false(기본값)이면 정의된 하위 형식이 없는 자산이 반환됩니다.
excludeByproducts
xsd:boolean
아니요
true인 경우 리핑된 PDF 페이지 이미지와 같은 기본 에셋 수집 중에 생성된 부산물 에셋은 검색 결과에서 제외됩니다. 기본값은 false입니다.
excludVappicArray
형식:ExcludeBupgetArray
아니요
검색 결과에서 제외할 부산물 자산 생성 조건의 배열입니다. 존재하는 경우 이 매개 변수는 excludeByproducts 설정을 무시합니다.
projectHandle
xsd:ststing
아니요
검색할 자산이 포함된 프로젝트 핸들입니다.
recordsPerPage
xsd:int
아니요
반환할 최대 결과 수.
resultsPage
xsd:int
아니요
개의 recordsPerPage 페이지 크기를 기준으로 반환할 결과 페이지를 지정합니다.
정렬 기준
xsd:string
아니요
에셋 정렬 필드 선택.
sortDirection
xsd:string
아니요
정렬 방향 선택.
responseFieldArray
형식:StringArray
아니요
응답에 포함할 필드 및 하위 필드 목록을 포함합니다.
excludeFieldArray
형식:StringArray
아니요
응답에서 제외할 필드 및 하위 필드 목록을 포함합니다.

출력(searchAssetsReturn)

이름
유형
필수
설명
합계 행 수
xsd:int
아니요
페이지당 레코드가 제한되지 않을 때 검색이 반환하는 행 수입니다.
assetArray
types:AssetArray
아니요
Assets을 검색합니다.

예제 section-725484cc09b54772a838ad2cc930b94b

이 코드 샘플은 특정 회사에 속하는 이미지 에셋을 검색합니다. 응답은 간결성을 위해 잘립니다.

요청

<ns1:searchAssetsParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:includeSubfolders>true</ns1:includeSubfolders>
   <ns1:assetTypeArray>
      <ns1:items>Image</ns1:items>
   </ns1:assetTypeArray>
</ns1:searchAssetsParam>

응답

<searchAssetsReturn xmlns="http://www.scene7.com/IpsApi/xsd">
   <totalRows>210</totalRows>
   <assetArray>
      <items>
         <assetHandle>24265|1|17061</assetHandle>
         <type>Image</type>
         <name>Autumn Leaves</name>
         ...
      </items>
    </assetArray>
</searchAssetsReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681