Microsoft Excel(SharePoint) 노드 문서
n8n v2.34요약
Microsoft Excel(SharePoint) 노드를 사용하면 Microsoft Teams 사이트를 통해 공유된 워크북을 포함해 SharePoint 문서 라이브러리에 저장된 Excel 워크북을 읽고 쓸 수 있습니다.
Microsoft Excel(SharePoint) 노드를 사용하면 Microsoft Teams 사이트를 통해 공유된 워크북을 포함해 SharePoint 문서 라이브러리에 저장된 Excel 워크북을 읽고 쓸 수 있습니다.
이 페이지에서는 Microsoft Excel(SharePoint) 노드가 지원하는 작업 목록, 워크북 선택 방법에 대한 안내, 추가 리소스 링크를 확인할 수 있습니다.
자격 증명
이 노드는 Authentication 드롭다운에서 선택하는 두 가지 로그인 방법을 제공합니다.
- Microsoft OAuth2 (Graph): 범용 Microsoft OAuth2 자격 증명으로 개인 사용자로 로그인합니다. 자격 증명의 Scope 필드에 노드가 필요로 하는 스코프를 입력하세요: 조회 및 읽기에는
Sites.Read.All, 쓰기에는Sites.ReadWrite.All을 입력합니다. 자격 증명이 토큰을 갱신할 수 있도록openid offline_access를 포함하세요. 예를 들어 이 노드의 모든 작업을 수행하려면openid offline_access Sites.ReadWrite.All을 입력합니다. - Microsoft Entra Service Principal (App-Only): 사용자가 없는 무인 워크플로를 위해, Microsoft Entra Service Principal 자격 증명으로 앱으로서 로그인합니다. 앱 등록에 관리자 동의와 함께 읽기용
Sites.Read.All, 쓰기용Sites.ReadWrite.All을 부여하세요. 앱을 특정 사이트로 제한하려면 대신 각 사이트에Sites.Selected를 부여하세요.
이 노드는 이 두 자격 증명만 지원합니다. 노드 전용 Microsoft Excel 및 Microsoft SharePoint 자격 증명은 이 노드와 함께 작동하지 않습니다. Excel 자격 증명에는 SharePoint(Sites.*) 스코프가 포함되어 있지 않고, SharePoint 자격 증명은 이 노드가 사용하는 Microsoft Graph가 아니라 SharePoint REST API용 토큰을 발급하기 때문입니다.
어떤 Excel 노드를 사용해야 하나요?#
n8n에는 두 가지 Excel 노드가 있습니다.
- Microsoft Excel (OneDrive): 개인 또는 비즈니스 OneDrive에 저장된 워크북용입니다.
- Microsoft Excel (SharePoint)(이 노드): Teams 사이트 뒤에 있는 파일을 포함해 SharePoint 문서 라이브러리에 저장된 워크북용입니다. 이 노드는 앱 전용 로그인도 지원하므로 무인 워크플로에 적합합니다.
누군가 워크북 링크를 공유했고 그 링크가 SharePoint 사이트를 가리킨다면, 이 노드를 사용하면 됩니다.
워크북 선택#
노드가 워크북을 가리키도록 지정하는 방법은 세 가지입니다.
- 워크북 주소 붙여넣기(기본값): SharePoint 또는 Excel에서 링크를 복사(Share > Copy link)하여 Workbook 필드에 붙여넣습니다. 복사 버튼에서 바로 복사한 링크는 그대로 사용할 수 있으며, 먼저 사이트나 라이브러리를 선택할 필요가 없습니다.
- 목록에서 선택: Site와 Document Library를 선택한 다음 이름으로 워크북을 검색합니다.
- ID로 지정: 워크북의 ID를 직접 붙여넣습니다.
작업#
- Sheet:
- Append: 시트 끝에 행을 추가합니다.
- Append or Update: 새 행을 추가하거나, 이미 존재하는 경우 현재 행을 업데이트합니다.
- Clear: 시트 또는 범위를 지웁니다.
- Delete: 시트를 삭제합니다.
- Get Many: 워크북의 시트 목록을 조회합니다.
- Get Rows: 범위 또는 시트의 사용 범위에서 행을 읽습니다.
- Update: 열 값으로 일치하는 행을 업데이트합니다.
- Table:
- Append: 테이블 끝에 행을 추가합니다.
- Convert to Range: 테이블을 일반 셀 범위로 변환합니다.
- Create: 셀 범위로 테이블을 만듭니다.
- Delete: 테이블을 삭제합니다.
- Get Columns: 테이블의 열 목록을 조회합니다.
- Get Many: 워크북의 테이블 목록을 조회합니다.
- Get Rows: 테이블의 행 목록을 조회합니다.
- Lookup: 특정 열 값을 찾은 다음 일치하는 행을 반환합니다.
- Workbook:
- Add Sheet: 워크북에 새 시트를 추가합니다.
- Delete: 워크북을 삭제합니다.
- Get Many: 문서 라이브러리의 워크북 목록을 조회합니다.
더 많은 작업이 추가될 예정입니다. 이 페이지는 새 작업이 제공될 때마다 업데이트됩니다.
템플릿 및 예제#
이 노드를 사용하는 예제는 모든 템플릿 검색에서 확인하세요.
관련 자료#
이 서비스에 대한 자세한 내용은 Microsoft의 Excel Graph API 문서를 참고하세요.