Microsoft Excel 커넥터

To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/microsoft-excel-connector/">Library

Microsoft Excel 커넥터

Microsoft O365 Worksheet V1.0 API와의 통합

소개

Microsoft Excel 워크시트 API를 사용하면 사용자는 Office 365 계정에 적절한 액세스 권한이 설정된 상태에서 Microsoft Excel 시트를 생성, 읽기 및 편집할 수 있습니다. 이 커넥터의 목표는 HTTP 커넥터를 사용하여 Microsoft Graph API(v1.0)를 통해 Tulip과 Microsoft를 통합하고, 고객이 자신의 인스턴스로 가져올 수 있는 즉시 사용 가능한 커넥터를 제공하는 것입니다.

목적

이 문서는 Microsoft의 Graph API(v1.0)에 HTTP 호출을 수행하여 M365 Excel 워크시트와 상호작용함으로써 구축할 수 있는 다양한 커넥터 기능을 소개하고, 다양한 사용 사례에 활용할 수 있는 워크시트에 대한 다양한 읽기 및 쓰기 작업을 보여줍니다.

API 문서

Microsoft Graph API 문서

필수 조건

Microsoft O365에서 계정을 생성하고 Microsoft Entra ID에서 OAuth 2.0 자격 증명을 구성합니다.
Microsoft 포털에서 필요한 범위를 지정하여 API를 등록하십시오. Azure - Entra ID

커넥터 설정 방법 동영상:

Tulip 연결 세부 정보

다음 정보를 Tulip의

커넥터에서 다음 정보를 구성해야 합니다.

실행 환경: 클라우드 커넥터 호스트
호스트: graph.microsoft.com
포트: 443
TLS: 예

OAuth 2: Microsoft Graph API와 통신하기 위한 액세스 토큰을 얻기 위해

커넥터 기능

1) 드라이브 정보 하나 가져오기

목적

이 커넥터는 하나의 드라이브에서 모든 항목을 가져옵니다.

엔드포인트

엔드포인트https://graph.micrsoft.com:443/v1.0/me/drive/root/children에 대한 HTTP GET 호출

필수 입력

필요한 입력 없음

필수 출력 추출기

SheetID: 다른 작업을 수행하는 데 사용될 워크북의 고유 식별자입니다.
CreatedAt: 워크북의 생성 날짜 및 시간.
LastModified: 워크북의 마지막 수정 날짜 및 시간.
SheetName: 워크북 이름.
SpreadSheetURL: 워크북의 URL입니다.

2) 워크북 내의 모든 워크시트 가져오기

목적

이 커넥터는 workbookID를 전달하여 워크북의 모든 워크시트를 가져옵니다.

엔드포인트

엔드포인트https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets에 대한 HTTP GET 요청

필수 입력

다음은 전달해야 하는 URL 매개변수입니다.

워크북 ID

필수 출력 추출기

sheetId: 다른 작업을 수행하는 데 사용될 스프레드시트의 고유 식별자입니다.
sheetName: 워크시트의 표시 이름입니다.
sheetPosition: 워크북 내에서 워크시트의 0을 기준으로 한 위치입니다.
sheetVisibility: 워크시트의 표시 상태입니다. 가능한 값은 Visible, Hidden, VeryHidden입니다.

3) 워크시트 메타데이터 가져오기

목적

이 커넥터는 WorkbookID 및 워크시트 이름을 기반으로 데이터를 가져옵니다.

엔드포인트

https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/ 엔드포인트에 대한 HTTP GET 호출

필수 입력

다음은 전달해야 하는 URL 매개변수입니다.

워크북 ID
워크시트 이름

필수 출력 추출기

sheetId: 다른 작업을 수행하는 데 사용될 스프레드시트의 고유 식별자입니다.
sheetName: 워크시트의 표시 이름입니다.
sheetPosition: 워크북 내에서 워크시트의 0을 기준으로 한 위치.
sheetVisibility: 워크시트의 표시 상태입니다. 가능한 값은 Visible, Hidden, VeryHidden입니다.

4) 새 워크시트 생성

목적

사용자는 워크북 ID와 워크시트 이름을 입력으로 전달할 수 있으며, Tulip은 제공된 시트 이름으로 새 워크시트를 생성합니다. API의 응답은 워크시트의 메타데이터와 다양한 속성입니다. 이를 통해 워크시트에서 데이터를 가져오거나 업데이트할 수 있습니다.
Microsoft Graph V1.0 API에서 가져온 정보는 Tulip 앱, Tulip 테이블 또는 다른 커넥터 함수로 파이프라인 처리되는 Tulip 변수 내에서 추가로 활용할 수 있습니다.

엔드포인트

엔드포인트 https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add에 대한 HTTP POST 호출

필수 입력

다음은 요청 본문(Request Body)으로 전송되는 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목

필수 출력 추출기

WorksheetId: 다른 작업을 수행하는 데 사용될 스프레드시트의 고유 식별자입니다.
spreadsheetURL: 새로 생성된 스프레드시트의 URL입니다.
응답과 함께 반환되는 추가 매개변수는 출력 매개변수의 일부로 포함될 수 있습니다.

5) 워크시트 속성 업데이트

목적

사용자는 워크북 ID, 기존 워크시트 이름, 워크시트 위치 및 새 워크시트 이름을 입력으로 전달할 수 있으며, Tulip은 제공된 시트 이름으로 워크시트를 업데이트합니다. API의 응답은 워크시트의 메타데이터 및 다양한 속성입니다. 이를 통해 스프레드시트의 데이터를 가져오고 업데이트할 수 있습니다.

엔드포인트

엔드포인트https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}에 대한 HTTP PATCH 호출

필수 입력

다음은 요청 본문으로 전송되는 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
워크시트 위치 - 워크북 내 워크시트의 0을 기준으로 한 위치
새 워크시트 이름 - 새 워크시트의 제목

필수 출력 추출기

sheetID: 다른 작업을 수행하는 데 사용될 워크북의 고유 식별자
sheetName: 워크시트의 표시 이름.
sheetPosition: 워크북 내에서 워크시트의 0을 기준으로 한 위치.

6) 특정 셀 데이터 가져오기

목적

이 커넥터는 제공된 WorkbookID, 워크시트 이름, 행 인덱스 및 열 인덱스를 입력으로 하여 워크북의 워크시트에서 데이터를 가져옵니다. API의 응답은 제공된 셀 값의 데이터가 됩니다.

엔드포인트

엔드포인트https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={행 인덱스},column={열 인덱스})에 대한 HTTP GET 호출

필수 입력

다음은 전달해야 하는 URL 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
행 인덱스 - 검색할 셀의 행 번호
열 인덱스 - 가져올 셀의 열 번호

필수 출력 추출기

이 커넥터는 지정된 행 및 열 인덱스에 해당하는 셀 값을 반환합니다.

7) 워크시트 범위 데이터 가져오기

목적

이 커넥터는 입력으로 제공된 WorkbookID, 워크시트 이름, 시작 범위 및 끝 범위를 기반으로 워크북의 워크시트에서 데이터를 가져옵니다. API의 응답은 제공된 범위의 데이터가 됩니다.

엔드포인트

엔드포인트https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)에 대한 HTTP GET 호출

필수 입력

다음은 전달해야 하는 URL 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
시작 범위 - 시작 범위
종료 범위 - 종료 범위

필수 출력 추출기

이 커넥터는 지정된 범위 내의 모든 셀 값을 반환합니다.

8) 범위별 값 업데이트

목적

사용자는 워크북 ID, 워크시트 이름, 시작 범위, 종료 범위 및 업데이트할 값을 입력으로 전달할 수 있으며, Tulip은 제공된 범위의 값을 업데이트합니다. API의 응답은 업데이트된 범위 값이 됩니다.

엔드포인트

엔드포인트https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{시작 범위}:{종료 범위}’)에 대한 HTTP PATCH 호출

필수 입력

다음은 전달해야 하는 URL 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
시작 범위 - 시작 범위
종료 범위 - 종료 범위
지정된 범위 내 각 셀의 값

필요한 출력 추출기

출력 추출기는 필요하지 않습니다.

9) 워크시트에 표 만들기

목적

사용자는 워크북 ID, 워크시트 이름, 워크시트 주소 및 헤더 유무를 입력으로 전달할 수 있으며, Tulip은 지정된 테이블 이름으로 새 테이블을 생성합니다. API의 응답은 테이블의 메타데이터와 다양한 속성입니다.
이는 스프레드시트에서 데이터를 가져오고 업데이트하는 데 추가로 사용될 수 있습니다.
Microsoft Graph V1.0 API에서 가져온 정보는 Tulip 앱, Tulip 테이블 또는 다른 커넥터 함수로 파이프되는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

엔드포인트 https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add에 대한 HTTP POST 호출

필수 입력

다음은 요청 본문으로 전송되는 매개 변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
Address - 데이터 소스를 나타내는 범위 개체의 주소 또는 이름입니다. 주소에 시트 이름이 포함되어 있지 않으면 현재 활성화된 시트가 사용됩니다.
hasHeaders - 가져오는 데이터에 열 레이블이 있는지 여부를 나타내는 부울 값입니다. 소스에 헤더가 포함되어 있지 않은 경우(즉, 이 속성이 false로 설정된 경우), Excel은 데이터를 한 행 아래로 이동시켜 헤더를 자동으로 생성합니다.

필수 출력 추출기

이 메서드는 새로 생성된 테이블의 메타데이터 값을 반환합니다.

10) 테이블에 새 행 추가

목적

사용자는 워크북 ID, 테이블 이름 및 행 값을 입력으로 전달할 수 있으며, Tulip은 제공된 행 값을 사용하여 새 행을 생성합니다. API의 응답은 테이블에 생성된 행 값이 됩니다.

엔드포인트

https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add 엔드포인트에 대한 HTTP POST 호출

필수 입력

다음은 요청 본문(Request Body)으로 전송되는 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
행 값

필수 출력 추출기

이 함수는 새로 생성된 행의 행 값을 반환합니다.

11) 워크시트 데이터 지우기

목적

사용자는 워크북 ID, 워크시트 이름, 시작 범위 및 끝 범위를 입력으로 전달할 수 있으며, Tulip은 지정된 범위를 기준으로 셀 값을 지웁니다.

엔드포인트

엔드포인트 https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address=’{시작 범위}:{종료 범위}’)/clear에 대한 HTTP POST 호출

필수 입력

다음은 요청 본문(Request Body)으로 전송되는 매개변수입니다.

워크북 ID - 워크북 ID
워크시트 이름 - 워크시트 제목
시작 범위
종료 범위

추가 정보

Microsoft 커넥터에 대한 자세한 정보를 확인해 보세요