Microsoft Excel 커넥터

::: (정보) ()앱을 다운로드하려면 방문하세요: 라이브러리:::

Microsoft Excel 커넥터

Microsoft O365 워크시트 V1.0 API와 통합

소개

Microsoft Excel 워크시트 API를 통해 사용자는 Office365 계정에 대한 올바른 액세스 권한으로 Microsoft 엑셀 시트를 만들고, 읽고, 편집할 수 있습니다. 이 커넥터의 목표는 HTTP 커넥터를 사용하여 Microsoft의 그래프 API(v1.0)를 사용하여 Tulip과 Microsoft를 통합하고 고객에게 인스턴스로 가져올 수 있는 즉시 사용 가능한 커넥터를 제공하는 것입니다.

목적

이 문서에서는 M365 Excel 워크시트와 상호 작용하기 위해 Microsoft의 Graph API(v1.0)에 HTTP 호출을 수행하여 구축할 수 있는 다양한 커넥터 기능을 강조하여 다양한 사용 사례에 활용될 수 있는 워크시트의 다양한 읽기 및 쓰기 작업을 보여줍니다.

API 문서

Microsoft 그래프 API 문서

사전 요구 사항

1. Microsoft O365에서 계정을 만들고 Microsoft Entra ID에서 OAuth 2.0 자격 증명을 구성합니다.
2. Microsoft 포털에서 필요한 범위로 API를 등록합니다. Azure - Entra ID

커넥터 설정 동영상

튤립 연결 세부 정보

Tulip의 다음 정보를 구성해야 합니다.

커넥터에서 구성해야 합니다.

1. 실행 대상: 클라우드 커넥터 호스트
2. 호스트: graph.microsoft.com
3. 포트: 443
4. TLS: 예

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

커넥터 기능

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

목적

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

엔드포인트

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

필수 입력

입력이 필요하지 않습니다.

필수 출력 추출기

1. SheetID: 다른 작업을 수행하는 데 사용되는 통합 문서의 고유 식별자입니다.
2. CreatedAt: 통합 문서의 만든 날짜 및 시간입니다.
3. LastModified: 통합 문서의 마지막 수정 날짜 및 시간입니다.
4. 시트 이름: 통합 문서 이름입니다.
5. 스프레드시트URL: 통합 문서의 URL입니다.

2) 통합 문서의 모든 워크시트 가져오기

목적

이 커넥터는 통합 문서 ID를 전달하여 통합 문서의 모든 워크시트를 가져옵니다.

엔드포인트

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

필수 입력

전달할 URL 매개 변수는 다음과 같습니다.

1. 통합 문서 ID

필수 출력 추출기

1. sheetId: 다른 작업을 수행하는 데 사용되는 스프레드시트의 고유 식별자입니다.
2. sheetName:워크시트의 표시 이름입니다.
3. 시트 위치: 통합 문서 내에서 워크시트의 영점 기준 위치입니다.
4. 시트 가시성: 워크시트의 가시성입니다. 사용 가능한 값은 Visible, Hidden, VeryHidden입니다.

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

목적

이 커넥터는 통합 문서 ID 및 워크시트 이름에서 데이터를 가져옵니다.

엔드포인트

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

필수 입력

전달할 URL 매개 변수는 다음과 같습니다.

1. 통합 문서 ID
2. 워크시트 이름

필수 출력 추출기

1. sheetId: 다른 작업을 수행하는 데 사용되는 스프레드시트의 고유 식별자입니다.
2. sheetName:워크시트의 표시 이름입니다.
3. 시트 위치: 통합 문서 내에서 워크시트의 영점 기준 위치입니다.
4. 시트 가시성: 워크시트의 가시성입니다. 가능한 값은 다음과 같습니다: 표시됨, 숨김, 매우 숨김입니다.

4) 새 워크시트 만들기

목적

1. 사용자가 통합 문서 ID와 워크시트 이름을 입력으로 전달하면 Tulip이 제공된 시트 이름으로 새 워크시트를 생성합니다. API의 응답은 워크시트의 메타데이터와 다양한 속성입니다. 이를 사용하여 워크시트에서 데이터를 가져오고 업데이트할 수 있습니다.
2. Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

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

필수 입력

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

1. 통합 문서 ID - 통합 문서 ID
2. 워크시트 이름 - 워크시트 제목

필수 출력 추출기

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

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

목적

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

엔드포인트

엔드포인트 -https://graph.microsoft.com:443/v1.0/me/drive/items/{워크북ID}/워크북/워크시트/{워크시트명}에 대한 HTTP PATCH 호출

필수 입력

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

1. 통합 문서 ID - 통합 문서 ID
2. 워크시트 이름 - 워크시트 제목
3. 워크시트 위치 - 통합 문서 내 워크시트의 영점 기준 위치
4. 새 워크시트 이름 - 새 워크시트 제목

필수 출력 추출기

1. sheetID: 다른 작업을 수행하는 데 사용되는 통합 문서의 고유 식별자
2. 시트 이름: 워크시트의 표시 이름입니다.
3. 시트 위치: 통합 문서 내에서 워크시트의 영점 기준 위치입니다.

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

목적

이 커넥터는 입력으로 제공된 통합 문서 ID, 워크시트 이름, 행 인덱스 및 열 인덱스를 기반으로 통합 문서의 워크시트에서 데이터를 가져옵니다. API의 응답은 제공된 셀 값의 데이터입니다.

엔드포인트

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

필수 입력

전달할 URL 매개 변수는 다음과 같습니다.

1. 통합 문서 ID-통합 문서 ID
2. 워크시트 이름-워크시트 제목
3. 행 인덱스-검색할 셀의 행 번호
4. 열 인덱스-검색할 셀의 열 번호

필수 출력 추출기

이 커넥터는 제공된 행 및 열 인덱스의 셀 값을 반환합니다.

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

목적

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

엔드포인트

엔드포인트 -https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(주소='{시작 범위}:{끝 범위}')에 대한 HTTP GET 호출

필수 입력

전달할 URL 매개 변수는 다음과 같습니다.

1. 통합 문서 ID-통합 문서 ID
2. 워크시트 이름-워크시트 제목
3. 시작 범위- 시작 범위
4. 끝 범위- 끝 범위

필수 출력 추출기

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

8) 범위별 값 업데이트

목적

사용자가 통합 문서 ID, 워크시트 이름, 시작 범위, 끝 범위, 업데이트할 값을 입력으로 전달하면 Tulip이 제공된 범위로 범위 값을 업데이트합니다. API의 응답은 업데이트된 범위 값입니다.

엔드포인트

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

필수 입력

전달할 URL 매개 변수는 다음과 같습니다.

1. 통합 문서 ID-통합 문서 ID
2. 워크시트 이름-워크시트 제목
3. 시작 범위- 시작 범위
4. 끝 범위-끝 범위
5. 제공된 범위 내 각 셀의 값

필수 출력 추출기

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

9) 워크시트에서 테이블 만들기

목적

1. 사용자가 통합 문서 ID, 워크시트 이름, 워크시트 주소, 헤더를 입력으로 전달하면 Tulip이 테이블 이름을 가진 새 테이블을 만듭니다. API의 응답은 테이블의 메타데이터와 다양한 속성이 됩니다.
2. 이것은 스프레드시트에서 데이터를 가져오고 업데이트하는 데 추가로 사용될 수 있습니다.
3. Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

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

필수 입력

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

1. 통합 문서 ID - 통합 문서 ID
2. 워크시트 이름 - 워크시트 제목
3. 주소 - 데이터 원본을 나타내는 범위 개체의 주소 또는 이름입니다. 주소에 시트 이름이 포함되지 않은 경우 현재 활성 시트가 사용됩니다.
4. 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 호출

필수 입력

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

1. 통합 문서 ID - 통합 문서 ID
2. 워크시트 이름 - 워크시트 제목
3. 행 값

필수 출력 추출기

새로 생성된 행의 행 값을 반환합니다.

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

목적

사용자가 통합 문서 ID, 워크시트 이름, 시작 범위 및 끝 범위를 입력으로 전달하면 Tulip이 주어진 범위를 기준으로 셀 값을 지웁니다.

엔드포인트

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

필수 입력

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

1. 통합 문서 ID - 통합 문서 ID
2. 워크시트 이름 - 워크시트 제목
3. 시작 범위
4. 끝 범위

추가 읽기

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

• Microsoft 캘린더 커넥터
• Microsoft Outlook 커넥터
• Microsoft 팀 커넥터