Essentials 검색 search-essentials

개요 overview

검색 기능은 Adobe Experience Manager(AEM) 커뮤니티의 필수 기능입니다. 이외에도 AEM 플랫폼 검색 기능, AEM Communities은 UGC 검색 API 사용자 생성 컨텐츠(UGC) 검색 UGC는 다른 AEM 콘텐츠 및 사용자 데이터와 별도로 입력 및 저장되므로 고유한 속성을 갖습니다.

Communities에서 일반적으로 검색되는 두 가지 사항은 다음과 같습니다.

  • 커뮤니티 회원이 게시한 컨텐츠

    • AEM Communities의 UGC 검색 API를 사용합니다.
  • 사용자 및 사용자 그룹(사용자 데이터)

    • AEM platform 검색 기능을 사용합니다.

설명서의 이 섹션은 UGC를 만들거나 관리하는 사용자 지정 구성 요소를 만드는 개발자의 관심사입니다.

보안 및 섀도우 노드 security-and-shadow-nodes

사용자 지정 구성 요소의 경우 소셜 리소스 유틸리티 메서드를 사용합니다. UGC를 만들고 검색하는 유틸리티 메서드는 필요한 를 설정합니다 그림자 노드 및 구성원이 요청에 대해 올바른 권한을 가지고 있는지 확인합니다.

SRP 유틸리티를 통해 관리되지 않는 것은 중재와 관련된 속성입니다.

다음을 참조하십시오 SRP 및 UGC 필수 패키지 ugc 및 ACL 섀도우 노드에 액세스하는 데 사용되는 유틸리티 방법에 대한 정보를 제공합니다.

UGC 검색 API ugc-search-api

다음 UGC 공용 스토어 는 다양한 SRP(저장소 리소스 제공자) 중 하나에서 제공하며, 각각은 서로 다른 기본 쿼리 언어를 가질 수 있습니다. 따라서 선택한 SRP에 관계없이 사용자 지정 코드에서는 UGC API 패키지 (com.adobe.cq.social.ugc.api) 선택한 SRP에 적합한 쿼리 언어를 호출합니다.

ASRP 검색 asrp-searches

대상 ASRP, UGC는 Adobe 클라우드에 저장됩니다. UGC가 CRX에 표시되지 않지만, 중재 는 작성자 및 게시 환경 모두에서 사용할 수 있습니다. 사용 UGC 검색 API 다른 SRP와 동일한 ASRP에서 작동합니다.

ASRP 검색 관리를 위한 도구가 현재 없습니다.

검색할 수 있는 사용자 지정 속성을 만들 때 다음을 준수해야 합니다 이름 지정 요구 사항.

MSRP 검색 msrp-searches

대상 MSRP, UGC는 검색에 Solr을 사용하도록 구성된 MongoDB에 저장됩니다. UGC가 CRX에 표시되지 않지만 중재 는 작성자 및 게시 환경 모두에서 사용할 수 있습니다.

MSRP 및 Solr 관련 사항:

  • AEM 플랫폼용 내장 Solr은 MSRP에 사용되지 않습니다.
  • AEM 플랫폼용 원격 Solr을 사용하는 경우 MSRP와 공유할 수 있지만 서로 다른 컬렉션을 사용해야 합니다.
  • Solr은 표준 검색 또는 다국어 검색(MLS)에 대해 구성될 수 있다.
  • 구성에 대한 자세한 내용은 Solr 구성 MSRP용

사용자 정의 검색 기능은 UGC 검색 API.

검색할 수 있는 사용자 지정 속성을 만들 때 다음을 준수해야 합니다 이름 지정 요구 사항.

JSRP 검색 jsrp-searches

대상 JSRP, UGC는에 저장됩니다. Oak 및 는 입력한 AEM Author 또는 Publish 인스턴스의 저장소에서만 볼 수 있습니다.

UGC는 일반적으로 게시 환경에 입력되므로 다중 게시자 프로덕션 시스템의 경우 를 구성해야 합니다 클러스터 게시: 모든 게시자에서 볼 수 있도록 입력한 컨텐츠가 게시 팜이 아닙니다.

JSRP의 경우 게시 환경에 입력된 UGC는 작성 환경에 표시되지 않습니다. 따라서 모두 중재 작업은 게시 환경에서 수행됩니다.

사용자 정의 검색 기능은 UGC 검색 API.

Oak 색인화 oak-indexing

AEM 플랫폼 검색에 대해 Oak 색인은 자동으로 만들어지지 않지만 AEM 6.2부터는 AEM Communities에 추가되어 성능을 향상시키고 UGC 검색 결과를 표시할 때 페이지 매김을 지원합니다.

사용자 지정 속성이 사용 중이고 검색 속도가 느린 경우 사용자 지정 속성에 대한 추가 색인을 만들어야 성능이 향상됩니다. 휴대성을 유지하려면 다음을 준수하십시오. 이름 지정 요구 사항 검색할 수 있는 사용자 지정 속성을 만들 때.

기존 색인을 수정하거나 사용자 정의 색인을 만들려면 다음을 참조하십시오. Oak 쿼리 및 색인 지정.

다음 Oak 색인 관리자 는 ACS AEM Commons에서 사용할 수 있습니다. 다음을 제공합니다.

  • 기존 인덱스 보기.
  • 리인덱싱을 시작할 수 있습니다.

에서 기존 Oak 인덱스를 보려면 CRXDE Lite를 검색하는 경우 위치는 다음과 같습니다.

  • /oak:index/socialLucene

social-lucene

인덱싱된 검색 속성 indexed-search-properties

기본 검색 속성 default-search-properties

다음은 다양한 Communities 기능에 사용되는 검색 가능한 속성 중 일부입니다.

속성
데이터 형식
플래그 지정됨
부울
isSpam
부울
읽기
부울
영향
부울
첨부 파일
부울
감정
플래그 지정됨
부울
추가됨
날짜
modifiedDate
날짜
상태
문자열
userIdentifier
문자열
답글
jcr:title
문자열
jcr:description
문자열
sling:resourceType
문자열
allowThreadReply
부울
초안
부울
publishDate
날짜
publishJobId
문자열
답변됨
부울
chosenanted
부울
태그
문자열
cq:Tag
문자열
author_display_name
문자열
location_t
문자열
parentPath
문자열
parentTitle
문자열

사용자 지정 속성 이름 지정 naming-of-custom-properties

사용자 지정 속성을 추가할 때 로 만든 정렬 및 검색에 해당 속성이 표시되도록 하려면 UGC 검색 API, 입니다. 필수 속성 이름에 접미사를 추가합니다.

접미사는 스키마를 사용하는 쿼리 언어용입니다.

  • 속성을 검색 가능한 것으로 식별합니다.
  • 데이터 유형을 식별합니다.

Solr은 스키마를 사용하는 쿼리 언어의 예입니다.

접미어
데이터 형식
_b
부울
_dt
달력
_d
더블
_tl
_s
문자열
_t
텍스트

메모:

  • 텍스트 토큰화된 문자열이며, 문자열 아님. 사용 텍스트 유사(이와 유사한) 검색을 위해.

  • 다중 값 형식의 경우 접미사에 's'를 추가하십시오. 예를 들면 다음과 같습니다.

    • viewDate_dt: 단일 날짜 속성
    • viewDates_dts: 날짜 속성 목록

필터 filters

구성 요소. 주석 시스템는 종단점 외에 필터 매개 변수를 지원합니다.

AND 및 OR 논리에 대한 필터 구문은 다음과 같이 표현됩니다(URL로 인코딩되기 전에 표시됨).

  • OR을 지정하려면 쉼표로 구분된 값으로 하나의 필터 매개 변수를 사용합니다.

    • filter=name eq 'Jennifer',name eq 'Jen'
  • 여러 필터 매개 변수를 지정하고 사용하려면 다음을 수행합니다.

    • filter = name eq 'Jackson'&filter=message eq 'testing'

의 기본 구현 구성 요소 검색 에서 검색 결과 페이지를 여는 URL에 표시되는 것과 같이 이 구문을 사용합니다. 커뮤니티 구성 요소 안내서. 실험하려면 다음 위치로 이동하십시오. http://localhost:4503/content/community-components/en/search.html.

필터 연산자는 다음과 같습니다.

EQ
equals
NE
같지 않음
LT
보다 작음
LTE
보다 작거나 같음
GE
보다 큼
GTE
크거나 같음
좋아요
유사 일치

URL은 구성 요소가 배치된 페이지가 아니라 Communities 구성 요소(리소스)를 참조해야 합니다.

  • 수정: 포럼 구성 요소
    • /content/community-components/en/forum/jcr:content/content/forum.social.json
  • 잘못됨: 포럼 페이지
    • /content/community-components/en/forum.social.json

SRP 도구 srp-tools

다음을 포함하는 Adobe Experience Cloud GitHub 프로젝트가 있습니다.

AEM Communities SRP 도구

이 저장소에는 SRP에서 데이터를 관리하기 위한 도구가 들어 있습니다.

현재 모든 SRP에서 모든 UGC를 삭제할 수 있는 서블릿이 한 개 있습니다.

예를 들어 ASRP에서 모든 UGC를 삭제하려면 다음을 수행하십시오.

curl -X POST http://localhost:4502/services/social/srp/cleanup?path=/content/usergenerated/asi/cloud -uadmin:admin

문제 해결 troubleshooting

Solr 쿼리 solr-query

Solr 쿼리의 문제를 해결하려면 다음에 대한 DEBUG 로깅을 활성화합니다.

com.adobe.cq.social.srp.impl.SocialSolrConnector

실제 Solr 쿼리는 디버그 로그에 인코딩된 URL로 표시됩니다.

해결 방법 쿼리: sort=timestamp+desc&bl=en&pl=en&start=0&rows=10 &q=%2Btitle_t:(hello)+%2Bprovider_id:\/content/usergenerated/asi/mongo/content/+%2Bresource_type_s:&df=provider_id&trf=verbatim&fq={!cost%3D100}report_suite:mongo

q 매개 변수는 쿼리입니다. URL 인코딩이 디코딩되면 추가적인 디버깅을 위해 Solr Admin Query 도구로 쿼리를 전달할 수 있습니다.

관련 리소스 related-resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791