Attachments Macro
- 이병욱
페이지에 첨부 된 파일 목록 표시
적절한 권한을 가진 사용자가 다음을 수행 할 수 있다.
- 페이지에서 직접 목록에서 파일 업로드
- 첨부 파일 속성 및 라벨 편집
- 첨부 된 파일 삭제 (파일의 모든 버전 삭제)
- 이미지 첨부 파일 미리보기
- Office Connector를 사용하여 첨부된 Office 및 PDF 문서 편집 가능
- 페이지에 첨부된 모든 파일 다운로드
참고 : 첨부 파일이 매우 큰 경우 매크로 매개 변수를 사용하여 미리보기를 끌 수 있다.
첨부 파일 매크로 사용
첨부 파일 매크로를 페이지에 추가하려면 :
- Confluence 에디터에서 Insert> Other Macros 선택
- 필요한 매크로 찾기 및 선택
자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.
기존 매크로 편집하기 : 매크로 자리 표시자를 클릭하고 편집을 선택. 매크로 대화 상자 창이 열리고 매크로 매개 변수를 편집 할 수 있다.
매개 변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션이다.
Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개 변수 이름이 매크로 브라우저에서 사용되는 라벨과 다른 경우, 아래에 대괄호 (예)로 표시
| Parameter | Default | Description |
|---|---|---|
| 파일이름 패턴(patterns) | all | 파일이름으로 첨부파일을 필터링하는데 사용되는 쉼표로 구분된 정규식 목록
|
| 첨부 파일 라벨(labels) | (none) | 표시할 첨부파일을 필터링하는데 사용되는 라벨 목록 |
| 이전 첨부 파일 버전 포함(old) | false | true 값은 이전 첨부 파일 버전을 목록에 포함 |
| 정렬 기준(sortBy) | date | 첨부파일의 정렬 순서. 페이지를 보는 사용자는 열 머리글을 클릭하여 정렬 순서를 변경할 수 있다. 유효한 값은 다음과 같다.
|
| 정렬 순서(sortOrder) | 오름차순 | Sort By 매개변수와 함께 사용하여 첨부파일을 오름차순 또는 내림차순으로 정렬 |
| 업로드 허용(upload) | true | 이 옵션을 선택하면 첨부파일 목록에 사용자가 새 파일을 찾아보고 첨부할 수 있는 옵션이 포함 |
| 페이지 제목(page) | (none) | 다른 페이지에서 첨부파일을 표시하는데 사용. 페이지 제목을 입력하지 않으면 매크로는 현재 페이지에 첨부된 파일을 표시 |
| 미리보기 표시(preview) | true | 첨부파일의 미리보기를 표시하는 데 사용. true인 경우 목록항목이 확장되면 미리보기가 표시 |
위키 마크 업 예제
편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로 유용)
매크로 이름 : 첨부파일
매크로 본문 : 없음
{sortments=descending|labels=chocolate,cookies|upload=false|preview=false}{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false|preview=false}