searchAssets

지정된 기준에 따라 자산을 검색합니다.

구문

searchAssets: 정보

searchAssets 는 IPS 자산을 검색하는 기본 방법입니다. 이 메서드는 폴더 계층 구조를 탐색하거나 이름으로 특정 자산을 찾는 등 다양한 목적으로 사용됩니다.

응답 크기

searchAssets 단일 호출에서 최대 1,000개의 자산을 반환합니다. 호출당 최대 10,000개의 에셋을 반환하려면 응답 데이터를 totalRows, name, handle, typesubType 필드의 하위 집합으로 제한합니다. 큰 세트를 반환하려면 resultPage 매개 변수로 페이징 설정을 설정합니다.

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

데이터 세트의 크기를 responseFieldArray 또는 excludFieldArray 매개 변수로 제한합니다. 이러한 매개 변수는 메모리 사용 및 대역폭을 줄이고 서버 응답 시간을 개선하는 데 도움이 됩니다.

인증된 사용자 유형

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

사용자에게 자산 반환 액세스 권한이 있어야 합니다.

매개 변수

입력(searchAssetsParam)

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

keywordArray 결과를 결합할 검색 일치 모드 선택,

conditionMatchMode

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

keywordArray types:StringArray 아니요

참고: 사용되지 않는 매개 변수입니다. 그것을 사용하지 않는 것이 좋다.

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

systemFieldMatchMode xsd:문자열 아니요

systemFieldCondition과 일치하는 검색 일치 모드 선택 기본값은 MatchAll입니다.

.

systemFieldConditionArray

types:SystemFieldConditionArray

아니요 시스템 필드 조건의 배열입니다.
tagMatchMode xsd:문자열 아니요 검색 일치 모드 문자열 상수입니다. 기본값은 MatchAll입니다.
tagConditionArray types:TagConditionArray 아니요

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

예측자는 tagMatchMode 설정에 따라 결합된 다음 keywordArray, systemFieldConditionArray metadataConditionArray에 있는 모든 용어와 결합합니다. conditionMatch 모드 설정.

metadataMatchMode xsd:문자열 아니요 검색 일치 모드를 사용하여 metadataCondition 일치 항목을 결합합니다. 기본값은 MatchAll입니다.
metadataConditionArray

types:MetadataConditionArray

아니요 메타데이터 필드 검색 조건 배열입니다.
assetTypeArray types:StringArray 아니요 검색에 포함할 자산 유형 배열입니다.
excludeAssetTypeArray types:StringArray 아니요 검색에서 제외할 자산 유형 배열입니다.
assetSubTypeArray types:StringArray 아니요 필터링할 하위 유형 이름 목록입니다.
strictSubTypeCheck xsd:boolean 아니요 true assetSubTypeArray이(가) 비어 있지 않으면 하위 유형이 assetSubTypeArray에 있는 자산만 반환됩니다. false(기본값)이면 정의된 하위 유형이 없는 자산이 반환됩니다.
excludeByproducts xsd:boolean 아니요 true인 경우 리핑된 PDF 페이지 이미지와 같은 기본 자산을 수집하는 동안 생성된 부산물 자산은 검색 결과에서 제외됩니다. 기본값은 false입니다.
excludMozillaArray

types:ExcludeMozillaArray

아니요 검색 결과에서 제외할 부산물 자산 생성 조건의 배열입니다. 이 매개 변수가 있으면 excludeByproducts 설정을 무시합니다.
projectHandle xsd:문자열 아니요 검색할 에셋이 포함된 프로젝트를 처리합니다.
recordsPerPage xsd:int 아니요 반환할 최대 결과 수입니다.
resultsPage xsd:int 아니요 recordsPerPage 페이지 크기를 기준으로 반환할 결과 페이지를 지정합니다.
sortBy xsd:문자열 아니요 자산 정렬 필드 선택
sortDirection xsd:문자열 아니요 정렬 방향 선택
responseFieldArray types:StringArray 아니요 응답에 포함할 필드 및 하위 필드 목록을 포함합니다.
excludeFieldArray types:StringArray 아니요 응답에서 제외하기 위한 필드 및 하위 필드 목록을 포함합니다.

출력(searchAssetsReturn)

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

예제

이 코드 샘플은 특정 회사에 속하는 이미지 자산을 검색합니다. 잠시 동안 응답이 잘립니다.

요청

<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>

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now