Page Properties Report Macro

Page Properties 및 Page Properties Report 매크로가 함께 작동하여 한 페이지의 요약 정보를 다른 페이지에 표시 할 수 있다.

의사 결정 및 제품 요구 사항 블루프린트에서 이 두 매크로의 예를 보여준다.

이 매크로는 이전에는 세부 정보 요약 매크로라고 불리었다.

Page Properties Report 매크로를 페이지에 추가하려면 :

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

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

페이지에 여러 페이지 속성 매크로를 추가하고 보고서에 모든 매크로 또는 특정 매크로만 포함할지 여부를 선택할 수 있다.

페이지 속성 매크로에는 특정 페이지 속성 매크로를 식별하는데 사용할 수 있는 선택적 ID 매개변수가 포함되어 있다.

내용을 표시하려면 :

참고 : 페이지 속성 보고서 매크로는 하나의 ID만 허용할 수 있다.

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

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

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

Click here to expand...

OR 검색의 경우 동일한 필드에 여러 값을 지정.
따라서 'label-a', 'label-b'또는 둘 다 사용하여 페이지를 표시하려면 'Label-a'와 'label-b'를 같은 라벨 필드에 넣는다.

AND 검색의 경우 둘 이상의 필터를 추가하고 각각에 단일 값을 지정.
label-a와 label-b가 있는 페이지만 표시하려면 'label-a'를 한 라벨 필드에 넣은 다음 두 번째 라벨 필드를 매크로에 추가하고 'label-b'를 넣는다.

간단히 말하면 OR 값은 같은 필터에 입력되고 AND 값은 다른 필터에 입력된다.
일부 필터만 AND를 지원한다. 필터가 AND 연산자를 지원하지 않으면 해당 필터를 두 번 이상 추가할 수 없다.

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

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

*이 필드는 CQL 기반 매크로에 필요

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

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

매개변수	기본값	설명
페이지 속성 ID	공백	지정하지 않으면 보고서에 여러 매크로가 있는 페이지의 모든 페이지 속성 매크로의 데이터가 표시된다. ID가 같은 페이지 속성 매크로의 데이터만 포함하도록 ID를 지정
제목 열 머리글	제목	보고서 표의 첫 번째 열에 표시할 제목. 이 열은 보고서에 표시되는 페이지에 대한 링크를 포함한다. 기본 열 제목은 '제목' 이다.
표시 할 열		지정하지 않으면 보고서에 모든 열이 표시. 포함할 쉼표로 구분된 열의 목록을 지정할 수 있다. 열 제목에 쉼표가 있으면 열 이름 주위에 큰 따옴표를 사용. 열 제목에 따옴표가 있으면 큰 따옴표를 사용. 예를 들어, 열, "내" "새로운" "열, 예", 세 번째 열
표시 할 항목 수	30	추가 항목에 대한 페이지 매김 옵션을 표시하기전에 테이블에 표시할 항목 수
정렬 기준	수정됨	특정 열 머리글로 표를 정렬. 해당 페이지 속성 매크로에 나타나는 것과 똑같은 열 이름을 입력한다. 테이블을 역순으로 정렬하려면 역순 정렬 확인란을 선택
의견 수 보기	아니	테이블의 각 페이지에 대한 주석 수를 표시
좋아요 수 표시	아니	테이블의 각 페이지에 대한 좋아요 수를 표시

보고서가 비어 있으면 다음을 확인 :

라벨을 올바르게 입력했으며 페이지 속성 매크로가 포함된 페이지에 라벨이 표시되어 있는지 여부
각 페이지의 페이지 속성 매크로가 올바르게 구성
다른 필드를 지정해도 검색 범위가 너무 좁아지지 않는지 여부(예 : 지정한 상위 페이지 아래에 라벨이 있는 페이지가 없는 경우)
페이지 속성 보고서 매크로가 여러 페이지 속성 매크로의 콘텐츠를 올바르게 표시하지 않는 알려진 문제가 있다. 자세한 내용은 CONFSERVER-34141해결 된 참조