Confluence Wiki 페이지와 하위 페이지를 PDF로 자동 변환하는 비법

Confluence Wiki 페이지와 하위 페이지를 PDF로 자동 변환하는 비법

로


Confluence Wiki 페이지와 하위 페이지를 PDF로 자동 변환하는 비법

디스크립션: 제가 직접 확인해본 결과, Confluence Wiki 페이지와 그 하위 페이지를 자동으로 PDF로 저장하는 방법에 대해 자세히 소개합니다. 이러한 자동화를 통해 시간과 노력을 절약할 수 있는 팁들을 공유하니 아래를 읽어보시면 많은 도움이 될 것입니다.

목차

Confluence API 사용하기

Confluence에서 API를 사용하려면 몇 가지 사전 준비가 필요해요. 저는 이 과정을 통해 Confluence API를 쉽게 활용할 수 있었답니다.

 

👉 ✅ 상세정보 바로 확인 👈

 



  1. API 활성화 및 API Token 생성

먼저, Confluence Cloud에서 API를 활성화해야 해요. 그리고 Atlassian 계정에서 API Token을 생성하세요. 이렇게 하면 나중에 HTTP 요청을 보낼 때 인증이 가능해요.

  1. Confluence Cloud에 로그인합니다.
  2. 계정 설정으로 가서 API Token을 생성합니다.

 

단계 설명
1 Confluence Cloud 로그인
2 API Token 생성

 

2. n8n 설정하기

n8n에서 Confluence에 접근할 수 있는 HTTP Request 노드를 설정하는 게 중요해요. 이를 통해 API 호출이 가능해지지요.

  • n8n을 설치하고, API와의 연결을 설정해요.
  • HTTP Request 노드에서 인증 정보를 입력해줘야 해요.

자동화 워크플로 구성하기

이제 본격적으로 PDF 변환 자동화 워크플로를 구성해볼게요. 쉽고 간단한 단계로 진행하니 차근차근 따라 해보세요.

1. 루트 페이지 ID 가져오기

첫 번째 단계로 지정한 Wiki 페이지의 ID를 가져오기 위해 HTTP Request 노드를 설정해 봐요.

  • Method: GET
  • URL: https://<YOUR_CONFLUENCE_DOMAIN>.atlassian.net/wiki/rest/api/content?title=<PAGE_TITLE>
  • Headers:
  • Authorization: Basic <base64_encoded_email:api_token>

 

2. 하위 페이지 목록 가져오기

루트 페이지의 ID를 기반으로 하위 페이지 목록도 가져와야 해요. 다시 한 번 HTTP Request 노드 설정을 추가합니다.

  • Method: GET
  • URL: https://<YOUR_CONFLUENCE_DOMAIN>.atlassian.net/wiki/rest/api/content/<PAGE_ID>/child/page

이처럼 API를 통해 데이터를 쉽게 가져올 수 있어요.

PDF 변환 과정

이제 수집한 페이지의 데이터를 PDF로 변환하는 단계에요. 여기서 중요한 것은 HTML로 변환한 페이지를 PDF로 만드는 것이지요.

1. Prepare PDF 변환 요청

Set 노드를 활용하여 PDF로 변환할 페이지 내용을 정리해요. 이렇게 몇 가지 정보를 준비할 수 있어요.

Key Value
제목 페이지 제목
내용 HTML 콘텐츠
ID 페이지 ID

2. HTML to PDF 노드 설정

이제 HTML 콘텐츠를 PDF로 변환하는 부분이에요. n8n의 HTML to PDF 노드는 이 과정을 아주 간단하게 만들어줍니다.

  • HTML 입력: 이전 HTTP Request 노드에서 가져온 HTML 콘텐츠
  • PDF 옵션: 페이지 크기 및 여백 설정 가능

파일 저장 및 반복 처리

PDF로 변환한 후에는 파일을 지정한 위치에 저장해야 해요.

1. Write Binary File 노드

PDF 파일을 저장하는 단계예요. 사용자가 지정한 이름과 경로로 폴더에 파일을 잘 저장할 수 있게 해줘요.

  • File Name: {{$json["title"]}}.pdf
  • File Path: 경로 설정

2. Loop 노드

마지막으로 모든 하위 페이지에 대해 동일한 프로세스를 반복하여 PDF를 생성해 줘요. 특히 이 단계에서 반복 처리해주는 Loop 노드는 효율적이지요.

자동화 워크플로 요약

  1. 루트 페이지의 ID를 가져와요.
  2. 해당 페이지의 하위 페이지 목록을 가져옵니다.
  3. 각 페이지의 내용을 HTML로 추출해 PDF로 변환해요.
  4. 변환된 PDF를 파일로 저장하고 반복합니다.

어렵지 않죠? 추가적으로 파일 압축이나 이메일 전송 등으로 기능을 확장할 수 있어요. 이 부분은 개인의 필요에 따라 유용하게 활용할 수 있답니다.

어제 변경된 페이지만 PDF로 저장하기

어제 바뀐 페이지를 PDF로 저장하고 싶으신가요? 그럼 아래의 단계를 따르시면 된답니다.

1. 변경된 페이지 ID 가져오기

먼저, 페이지 ID와 하위 페이지 목록을 가져올 필요가 있어요. 이 API 요청으로 변경된 페이지 정보까지 얻을 수 있지요.

2. 변경된 페이지 필터링

이제 Function 노드를 활용하여 어제 변경된 페이지만 필터링해요. 수행할 스크립트는 다음과 같아요.

javascript
const yesterday = new Date();
yesterday.setDate(yesterday.getDate() - 1);
return items.filter(item => {
const lastUpdated = new Date(item.json.history.lastUpdated.when);
// 어제 변경된 페이지 검토
return lastUpdated >= yesterday && lastUpdated < today;
});

결론

Confluence Wiki 페이지와 하위 페이지를 PDF로 변환하는 자동화는 여러 모로 유용해요. 특히 시간을 절약하고 필요한 정보를 손쉽게 문서화할 수 있으니, 개인이나 팀의 효율성을 높이는 데 도움이 될 것입니다. 따라서 필요한 기능을 추가하여 사용자 맞춤형으로 최적화할 수 있답니다.

태그: API, Confluence, PDF, 자동화, n8n, Wiki, 문서화, 효율성, 스크립트, 자동화 기법, PDF 변환

함께보면 좋은글!