Confluence node를 사용하면 Confluence Cloud의 작업을 자동화하고 다른 애플리케이션과 통합할 수 있습니다. n8n은 페이지 생성, 조회, 수정, 삭제, 페이지 레이블과 댓글 작업, 첨부 파일 업로드와 다운로드, 스페이스 목록 조회, CQL을 사용한 콘텐츠 검색을 기본으로 지원합니다.

이 페이지에서는 Confluence node가 지원하는 작업 목록, 사이트와 페이지를 선택하는 방법에 대한 안내, 추가 리소스 링크를 확인할 수 있습니다.

사이트 선택하기#

모든 작업은 작업 대상 Confluence Cloud 사이트를 선택하는 Site 파라미터로 시작합니다.

• Pick from a list(기본값): 연결이 접근할 수 있는 사이트 중에서 선택합니다.
• By URL: 사이트 주소를 붙여 넣습니다. 예: https://example.atlassian.net.
• 비워 두기: 연결이 접근할 수 있는 사이트가 정확히 하나이면 노드가 자동으로 그 사이트를 사용합니다. 여러 개이면 노드가 하나를 선택하라고 요청하고 오류 메시지에 사이트 목록을 표시합니다.

페이지 선택하기#

페이지를 대상으로 하는 작업은 페이지를 지정하는 네 가지 방법을 제공합니다.

• Pick from a list(기본값): 제목으로 페이지를 검색합니다. 먼저 Space를 선택하면 목록을 해당 스페이스 하나로 좁힐 수 있습니다.
• By URL: 브라우저나 Confluence의 Share 버튼에서 페이지 링크를 그대로 붙여 넣습니다.
• By ID: 페이지의 숫자 ID를 붙여 넣습니다.
• By Title: 페이지 제목을 입력합니다. 제목은 정확히 하나의 페이지와 일치해야 하며, 같은 제목의 페이지가 여럿이면 Space를 선택해 조회 범위를 한정합니다.

페이지 본문#

페이지나 댓글 콘텐츠를 쓰는 작업은 Body Format 선택 항목을 제공합니다.

• Plain Text(기본값): 일반 텍스트를 입력합니다. 각 줄이 하나의 단락이 됩니다. 마크업은 필요하지 않습니다.
• Storage: Confluence 스토리지 형식 XHTML을 입력합니다. 예: <h2>Title</h2><p>Text</p>.
• Atlas Doc Format: 원시 Atlassian Document Format JSON 문서를 입력합니다.

콘텐츠를 읽는 작업은 본문을 Storage(기본값) 또는 Atlas Doc Format으로 반환하거나, 문서에서 추출한 Plain Text로 반환합니다. Plain Text는 페이지 콘텐츠를 AI 및 검색 워크플로에 전달할 때 유용합니다.

Append 작업은 페이지가 어떤 형식으로 저장되어 있든 선택한 형식으로 페이지를 씁니다. 두 형식이 다르면 Confluence가 페이지 전체를 변환합니다. 콘텐츠와 매크로는 유지되지만 Confluence가 저장된 마크업을 다시 쓰기 때문에, 페이지의 버전 기록에는 추가한 콘텐츠만이 아니라 페이지 전체가 달라진 것으로 표시됩니다. 차이를 작게 유지하려면 페이지가 이미 사용하는 형식을 선택하세요.

Confluence 페이지 초안 생성 및 게시하기#

Confluence는 페이지의 게시된 버전 옆에 초안을 따로 보관하므로, 초안이 독자에게 보이는 내용을 대체하지 않습니다.

• Create as Draft를 활성화한 Create는 게시되지 않은 페이지를 만듭니다. 작성자는 스페이스 트리에서 Draft 배지가 붙은 이 페이지를 볼 수 있습니다.
• Status를 Draft로 설정한 Update는 변경 사항을 게시되지 않은 초안으로 저장합니다. 이 작업은 페이지를 게시 취소하지 않습니다. 라이브 페이지는 마지막으로 게시된 버전을 계속 표시하고, Confluence는 해당 페이지에 Unpublished changes를 표시합니다.

초안을 게시하려면 해당 페이지에 Status를 Published로 설정해 Update를 실행합니다.

작업#

• Attachment:
  • Delete: 첨부 파일을 휴지통으로 이동하거나 영구 삭제합니다.
  • Get Many: 페이지의 첨부 파일 목록을 조회하며, 선택적으로 각 파일을 다운로드합니다.
  • Upload: 파일을 페이지의 첨부 파일로 업로드합니다. 기존 첨부 파일과 이름이 같은 파일을 업로드하면 해당 첨부 파일의 새 버전이 생성됩니다.
• Page:
  • Add Comment: 페이지에 푸터 댓글을 추가하거나 기존 댓글에 답글을 답니다.
  • Add Labels: 페이지에 레이블을 하나 이상 추가합니다.
  • Append: 기존 페이지의 맨 아래에 콘텐츠를 추가합니다.
  • Create: 스페이스에 새 페이지를 만듭니다. 선택적으로 초안, 비공개, 스페이스 루트, 상위 페이지 아래로 만들 수 있습니다.
  • Delete: 페이지를 휴지통으로 이동하거나 영구 삭제합니다. 하위 페이지는 삭제되지 않고 삭제된 페이지의 상위로 올라갑니다.
  • Delete Comment: 푸터 댓글을 영구 삭제합니다.
  • Get: 페이지를 조회하며, 선택적으로 전체 하위 트리를 함께 조회합니다. 페이지당 항목 하나를 트리 순서대로 반환하며 페이지 자신이 첫 번째입니다.
  • Get Comments: 페이지의 최상위 푸터 댓글 목록을 조회합니다.
  • Get Labels: 페이지의 레이블 목록을 조회합니다.
  • Get Many by Label: 레이블이 붙은 모든 페이지를 조회하며, 선택적으로 하나의 스페이스 안으로 한정할 수 있습니다.
  • Remove Label: 페이지에서 레이블을 제거합니다.
  • Update: 기존 페이지의 제목과 본문을 교체하거나 초안/게시 상태를 변경합니다.
• Search:
  • Query: CQL 쿼리로 콘텐츠를 검색하며, 선택적으로 같은 요청에서 각 결과의 전체 페이지 콘텐츠를 가져옵니다.
• Space:
  • Get: 스페이스 하나를 조회합니다.
  • Get Many: 여러 스페이스를 조회합니다.

템플릿 및 예제#

이 노드를 사용하는 예제는 모든 템플릿 검색에서 확인하세요.

관련 리소스#

서비스에 대한 자세한 내용은 Atlassian의 Confluence Cloud REST API 문서를 참고하세요.