Search Results Macro

매크로 매개변수에 지정된 검색어를 기반으로 Confluence 사이트를 검색하고 결과를 wiki 페이지에 표시한다.

 

Search Results Macro 사용

Search Results Macro를 페이지에 추가하려면 :

  1. Confluence 편집기에서 삽입 > 다른 매크로 선택
  2. 필요한 매크로 찾기 및 선택

자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.

기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.

 

매개변수

매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션. 

Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용된 레이블과 다른 경우, 아래에 대괄호 ( example) 로 표시된다.

 

매개변수

기본값

설명

검색 조건(query

없음

결과를 생성하는데 사용할 검색어. 'AND' 및 'OR' 과 같은 연산자를 사용하여 검색어를 구체화할 수 있다. 예 :my_query1 AND my_query2

더 자세한 정보는 Confluence 검색 구문 문서 참조.

최대 결과 수(maxLimit

10

표시된 검색 결과의 수를 제한

이 스페이스 키로 제한

all

공간 이름을 입력하여 공간을 찾거나 검색할 공간의 키를 지정. 키는 대소 문자를 구분한다.

콘텐츠 유형(type

all

내용 유형을 지정. 컨텐츠 유형은 pagecommentblogpostattachmentuserinfo(사용자 프로파일의 컨텐츠만) 및 spacedesc(스페이스 설명의 컨텐츠만)이다.

마지막으로 수정됨 
(lastModified

all

해당 기간 내에 수정된 내용을 보려면 주, 일, 시간 및/또는 분 단위로 기간을 지정

사용할 수 있는 값은 다음과 같다.
  • w = 주
  • d = 일
  • h = 시간
  • m = 분

예 :

  • 2h 35m
  • 3d 30m

노트:

  • 시간 범주를 지정하지 않으면 Confluence는 분을 가정한다.
  • 둘 이상의 기간 (예 : 주와 일)을 지정하는 경우 공백으로 마침표를 구분해야한다. 순서에 관계없이 넣을 수 있다.
  • 시간 범주는 대소 문자를 구분하지 않는다. 예를 들어 '4d'는 '4D'와 동일하다.

이 사용자 이름으로 제한(contributor

all

해당 사용자가 생성하거나 업데이트한 컨텐트만 표시하려면 Confluence 사용자의 사용자 이름을 지정

 

노트

사용 권한 : 사용자가 검색 결과 매크로가 포함된 페이지를 볼 때 검색 결과에는 사용자에게 '보기' 권한이 있는 페이지 및 기타 콘텐츠 유형만 표시된다.

 

위키 마크 업 예제

이 예제는 편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로) 유용

매크로 이름 : search

매크로 본문 :  없음

{search:lastModified=3w|query=choc|contributor=admin|maxLimit=10|type=page|spacekey=ds}