/
Content by Label Macro

Content by Label Macro

Owned by 이병욱
Last updated: 2017-09-04

특정 라벨이 있는 페이지, 블로그 게시물 또는 첨부 파일 목록을 표시하는데 사용. 관련 페이지를 모으고 보고싶지 않은 콘텐츠를 필터링하는데 적합하다.

예를 들어, 이 매크로를 사용하면 'feature-shipped'라벨이 있고 'Blueprint'라는 단어가 포함된 모든 페이지 목록을 표시하거나 이전에 있었던 'meeting-notes'라벨이 있는 페이지를 나열할 수 있다.


페이지에서 매크로가 표시되는 방식은 다음과 같다.

매크로 브라우저에서 설정하는 방법은 다음과 같다.

Content by Label Macro 사용

Content by Label 매크로를 페이지에 추가하려면 :

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

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

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


CQL 필터

CQL(Confluence Query Language)은 Confluence용으로 개발된 쿼리 언어로, 일부 매크로와 Confluence검색에서 사용할 수 있다.

Confluence검색 및 CQL기반 매크로를 사용하면 필터를 추가하여 검색 쿼리를 작성하고 검색 결과의 범위를 좁히는데 필요한 만큼의 필터를 추가할 수 있다.

필터 추가 링크를 사용하여 쿼리에 필터를 추가

 AND, OR 및 NOT 연산자 사용
  • OR검색의 경우 동일한 필드에 여러 값을 지정. 따라서 'label-a', 'label-b'또는 둘 다로 페이지를 표시하려면 'Label-a'와 'label-b'를 같은 Label필드에 입력.
  • AND검색의 경우 둘 이상의 필터를 추가하고 각각에 단일 값을 지정.
    label-a와 label-b가 있는 페이지만 표시하려면 'label-a'를 한 Label필드에 넣은 다음 두번째 Label필드를 매크로에 추가하고 두번째 Label필드에 'label-b'를 입력.

    간단히 말해 OR값은 동일한 필터에 입력되고 AND값은 다른 필터에 입력된다. 일부 필터만 AND를 지원. 필터가 AND연산자를 지원하지 않으면 해당 필터를 두 번 이상 추가할 수 없다.
  • NOT검색의 경우 Label앞에 마이너스 기호 (-)를 입력. 해당 Label이 있는 모든 항목이 제외된다.

 

다음 CQL필터를 사용하여 쿼리를 작성할 수 있다.

필터설명연산자
Label*이 레이블이 있는 페이지, 블로그 게시물 또는 첨부 파일 포함

OR (동일한 필터의 여러 값)
AND (다중 레이블 필터)

With ancestor

이 페이지의 하위 페이지를 포함

매크로를 단일 페이지 트리로 제한할 수 있다

OR (동일한 필터의 여러 값)
Contributor**이 작성자가 작성하거나 편집한 페이지 또는 블로그 게시물 포함OR (동일한 필터의 여러 값)
Creator이 작성자가 만든 항목을 포함OR (동일한 필터의 여러 값)
Mentioning user이 작성자가 사용하는 페이지 및 블로그 게시물 포함OR (동일한 필터의 여러 값)
With parent이 페이지의 직계 하위 페이지만 포함 (추가 하위 페이지는 포함되지 않음)EQUALS (한 페이지만)
In space**해당 공간에 있는 아이템 포함OR (동일한 필터의 여러 값)
Including text**이 텍스트가 포함된 항목 포함CONTAINS (단일 단어 또는 구)
With title이 텍스트를 제목에 포함하는 항목 포함CONTAINS (단일 단어 또는 구)
Of type**페이지, 블로그 또는 첨부 파일만 포함OR (동일한 필터의 여러 값)

*이 필터는 CQL 기반 매크로에 필요하다.

** 이러한 필터는 CQL 기반 매크로에 추가할 수 있지만 검색시 표준 검색 필터의 일부이므로 필터 추가 메뉴에 나타나지 않는다.

 

매크로 표시 옵션

이 옵션은 페이지에 매크로가 표시되는 방식을 제어한다.

매개변수기본값설명
정렬 방식수정

제목, 만든 날짜 또는 마지막으로 수정한 날짜별로 목록을 정렬.

옵션을 선택하지 않으면 관련성에 따른 CQL 기본 순서가 사용

역순 정렬False오름차순 대신 내림차순 정렬 (Z - A, 가장 빠름 - 최신)
최대 페이지 수15목록에 포함할 항목 수 제한. 최대 500 페이지까지 가능
목록 제목Blank매크로의 선택적 제목 포함
각 페이지의 레이블 표시True각 항목에 적용된 레이블 표시 또는 숨기기
각 페이지의 공간 이름 표시True각 항목의 공간 이름 표시 또는 숨기기
발췌 내용 표시False

목록의 각 페이지 아래에 짧은 발췌록 포함 가능. 다음 중에서 선택 :

  • None - 발췌 부분이 표시되지 않는다.
  • Simple - Excerpt 매크로에 의해 반환된 페이지 중 하나에 포함된 첫 번째 텍스트 줄을 표시. 페이지에 발췌 매크로가 없으면 아무 것도 표시되지 않는다.
  • 서식있는 콘텐츠 - Excerpt 매크로의 내용을 표시하거나 페이지에 Excerpt 매크로가없는 경우 이미지 및 일부 매크로를 포함하여 서식있는 텍스트로 페이지 콘텐츠의 첫 번째 부분을 표시