Excel Online(비즈니스)
Excel Online(비즈니스) 커넥터를 사용하면 Microsoft Graph(비즈니스용 OneDrive, SharePoint 사이트 및 Office 365 그룹)에서 지원하는 문서 라이브러리에서 Excel 파일을 사용할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| Power Automate | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 연락처 | |
|---|---|
| 이름 | Excel Online(비즈니스) |
| URL | https://learn.microsoft.com/en-us/connectors/excelonlinebusiness/ |
| 전자 메일 | idcknowledgeeco@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://products.office.com/excel |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/ |
| 카테고리 | AI; 비즈니스 인텔리전스 |
작업의 알려진 문제 및 제한 사항
| 간단한 설명 | Operations | 긴 설명 |
|---|---|---|
| 오래된 데이터 | 테이블에 있는 행 나열 | 테이블 작업에 있는 행 나열에서 필터링 또는 정렬을 사용하는 경우 데이터가 최신 상태가 아닐 수 있습니다(약간의 지연이 있을 수 있음). |
| 필터링 기능 | 테이블에 있는 행 나열 |
테이블 작업에 있는 행 나열은 기본 필터링 및 정렬을 지원합니다. - 다음 필터 함수를 지원합니다. eqnecontainsstartswithendswith- 단 하나의 필터 함수만 열에 적용할 수 있습니다. - 정렬에 1열만 사용할 수 있습니다. |
| 누적 필터 | 테이블에 있는 행 나열 | 테이블에 있는 작업 목록 행을 사용하여 필터를 적용하면 기존 필터 위에 추가됩니다. |
| 누적되지 않은 필터 | 테이블에 있는 행 나열 | 테이블 작업에 있는 행 나열을 사용하여 필터를 적용하지 않으면 Excel 파일에 이미 설정된 필터는 무시됩니다. 이 작업은 Excel의 기존 필터에 관계없이 모든 행을 검색합니다. |
| Pagination | 테이블에 있는 행 나열 | 테이블 작업에 있는 행 나열은 기본적으로 최대 256개의 행을 반환합니다. 모든 행을 얻으려면 페이지 매김을 켭니다. |
| 순차적이지 않은 행 선택 | 테이블에 있는 행 나열 | 커넥터는 테이블 작업에 있는 목록 행의 최대 열 500 개에 대한 행을 검색합니다 . 처음 500개 열에 대한 행은 기본적으로 반환됩니다. 매개 변수에서 검색 Select Query 할 특정 열의 쉼표로 구분된 목록을 제공할 수 있습니다. |
| 키 열 필드 이름 |
테이블에 키 열 추가 행 삭제 행 가져오기 행 업데이트 |
키 열 필드는 대/소문자를 구분합니다. |
| 여러 행 업데이트/삭제 |
행 삭제 행 업데이트 |
행 업데이트 및 행 삭제와 같은 작업에서 여러 일치 항목이 있는 경우 첫 번째 행만 업데이트/삭제됩니다. |
| Microsoft Excel Macro-Enabled 스프레드시트 지원 | 스크립트 실행 | 스크립트 실행 작업은 Microsoft Excel Macro-Enabled 스프레드시트(*.xlsm) 형식을 추가로 지원합니다. 자세한 내용은 Power Automate 흐름에서 매크로 파일을 사용하는 방법을 참조하세요. |
| 테이블 열 머리글 제한 |
행 추가 행 업데이트 행 삭제 |
행 추가, 행 업데이트, 행 삭제와 같은 작업에서 커밋된 변경 내용이 해당 Power Automate, LogicApps 또는 Power Apps 작업의 성공적인 응답 직후에 항상 영향을 받지는 않습니다. 기본 백 엔드 서비스 제한으로 인해 최대 30초까지 지연이 예상됩니다. |
| 스크립트 작업 제한 실행 | 스크립트 실행 | 스크립트 실행 작업은 10초당 최대 3개의 호출을 허용하고 하루에 최대 1600건의 호출을 허용합니다. |
| 스크립트 작업 소버린 클라우드 지원 실행 | 스크립트 실행 | 스크립트 실행 작업은 소버린 클라우드(Gcc, GccHigh, DoD 및 기타 상위 클라우드 포함)에서 사용할 수 없습니다. |
일반 오류
| 오류 | 해결 방법 |
|---|---|
| 403 금지됨 | 파일에 쓰기 권한이 있는지 확인합니다. |
| 502 BadGateway | 스프레드시트가 읽기 전용 모드인 경우 이러한 오류가 표시됩니다. 읽기 전용 모드를 사용하지 않도록 설정하는 방법을 알아보려면 읽기 전용에서 Excel 스프레드시트 변경으로 이동합니다. |
| 429 요청이 너무 많음 | 이 문제는 사용자가 짧은 기간 내에 너무 많은 요청을 하는 경우에 발생합니다. 제한 제한은 각 요청에 고유하며 요청 수, 사용된 메모리 및 기타 중요한 요소에 따라 달라집니다. 제한이 발생하는 경우 커넥터 작업 주위에 명시적 지연을 추가하는 것이 좋습니다. Graph API의 제한 제한으로 인해 다음과 같은 여러 가지 이유로 인해 발생할 수도 있습니다. 1. 흐름의 전역 요청 수가 한도를 초과하면 일부 요청이 제한됩니다. 어떤 요청이 제한되고 Azure 제한 솔루션에서 임의로 선택되지 않습니다. 2. #1의 제한에 도달하지 않은 경우에도 다른 이유로 인해 여전히 제한될 수 있습니다. 다음은 제한에 대한 가장 일반적인 이유입니다. a. Sharepoint 서비스 제한 정책을 누릅니다. b. 예를 들어 너무 많은 요청으로 인해 작업 큐가 가득 찼습니다. c. 요청이 예상보다 긴 시간 동안 큐에 보류 중입니다. 예를 들어 30대보다 오래 걸리는 요청은 504를 반환하고 504를 계속하면 제한이 발생할 수 있습니다. d. 통합 문서 세션에서 연속 오류가 너무 많습니다. e. 작업 ID "RunScriptProd"에서 OfficeScripting에 대한 요청이 수행되고 해당 요청이 10초 이내에 3을 초과하면 제한됩니다. |
일반적인 알려진 문제 및 제한 사항
- Excel Online(비즈니스) 커넥터에서 지원하는 Excel 파일의 최대 크기는 25MB입니다.
- 커넥터를 마지막으로 사용한 후 최대 6분 동안 업데이트 또는 삭제를 위해 Excel 파일이 잠겨 있을 수 있습니다.
- 다른 커넥터에서 수행한 동시 파일 수정 또는 수동 편집은 지원되지 않습니다. 사용자는 동시에 여러 클라이언트에서 단일 Excel 파일에 데이터를 쓰지 않아야 합니다(Excel Desktop, Excel Web, Power Automate, LogicApps 또는 Power Apps). 이로 인해 병합 충돌 및 데이터 불일치가 발생할 수 있습니다.
- 커넥터는 Microsoft Excel Open XML 스프레드시트(*.xlsx) 및 Microsoft Excel 이진 통합 문서(*.xlxb) 형식의 파일을 지원합니다.
- 커넥터의 작업에 필요한 속성은
File다음 옵션 중 하나를 사용하여 채워야 합니다.- 파일 선택기에서 파일을 선택합니다.
- 비즈니스용 OneDrive 커넥터의 트리거/작업(특정 비즈니스용 OneDrive 작업 또는 트리거에 대해 존재하는 항목에 따라 파일
Id또는File identifier속성)의 출력을 사용합니다. - SharePoint 커넥터의 트리거/작업(특정 Sharepoint의 작업 또는 트리거에 대해 존재하는 항목에 따라 파일
Id또는Identifier속성)의 출력을 사용합니다. -
드라이브에서 시작하는 파일 경로를 입력합니다. 예제:
- 파일이 OneDrive 아래에 있고 전체 경로가 OneDrive/file.xlsx드라이브 매개 변수인
OneDrive경우 입력 file.xlsx. - 파일이 O365 그룹 아래에 있고 전체 경로가 문서/내부 문서/file.xlsx드라이브 매개 변수인
Documents경우 내부 문서/file.xlsx입력합니다.
- 파일이 OneDrive 아래에 있고 전체 경로가 OneDrive/file.xlsx드라이브 매개 변수인
- 커넥터는 숨겨진 열을 포함하는 테이블에 OData 매개 변수 사용을 지원하지 않습니다.
- 복잡한 수식이 있거나 워크시트에 행이 너무 많은 경우 다시 계산으로 인한 커넥터 시간 제한이 발생할 수 있습니다. 두 경우 모두 재시도 정책으로 인해 데이터를 여러 번 삽입할 수 있습니다. 해결 방법으로 수식을 간소화하거나 줄일 수 있는지 확인하세요. 그렇지 않으면 이 통합 문서의 계산 모드를 수동으로 설정할 수 있습니다. 자세한 내용은 여기를 참조하세요.
-
Filter Query/Order By/Select Query작업 매개 변수는 영숫자 열 이름만 지원합니다. - 피벗 테이블은 Graph API 제한으로 인해 지원되지 않습니다.
- 커넥터는 항상 문서 라이브러리 드롭다운 컨트롤에서 사용할 수 있는 모든 문서 라이브러리를 반환합니다. 대부분의 사용자에게는 하나의 문서 라이브러리만 반환되지만 사용 가능한 문서 라이브러리가 여러 개 있는 경우 모두 나열됩니다. 문서 라이브러리(예: 드라이브 리소스) 및 사용자, 그룹 및 사이트에 대한 예상 동작에 대해 자세히 알아보려면 드라이브 나열 - 주의 사항으로 이동합니다.
- Power Apps에서 테이블을 가져오는 동안 Excel 표에 자동으로 생성된 ID 삽입 옵션을 선택하면 커넥터가 최대 64,000개의 행을 자동으로 채울 수 있습니다.
- 숫자만 포함된 테이블 열 머리글은 기본 백 엔드 서비스 제한으로 인해 행 업데이트, 행 삭제 와 같은 작업에서 예기치 않은 동작을 일으킬 수 있습니다. 해결 방법으로 다른 문자도 포함되도록 이러한 열의 이름을 바꿉니다.
- Excel 파일을 수정할 수 있으며 "읽기 전용" 작업이 실행되는 경우에도 파일의 버전 기록에 새 버전이 표시될 수 있습니다. 이 동작은 커넥터 백 엔드 서비스의 내부 저장 메커니즘으로 인해 설계되었습니다.
- 게스트 사용자가 주 사용자와 다른 테넌트에서 온 경우 문서에 액세스할 수 없습니다. 이 경우 사용자에게 HTTP 404(찾을 수 없음) 오류가 발생합니다.
- Fairfax Logic Apps에서 이 커넥터는 상업용(.com) 계정을 사용하는 연결만 지원합니다.
- SharePoint 파일을 사용할 수 없습니다. Graph API는 사용자의 IP 주소를 SharePoint에 전달하지 않습니다. 따라서 위치 기반 정책을 사용하는 경우 SharePoint는 사용자가 신뢰할 수 있는 경계 내에 있는지 여부를 확인할 수 없습니다. 이러한 이유로 SharePoint 라이브러리에 액세스할 때 "조직 정책으로 인해 이 네트워크 위치에서 이러한 리소스에 액세스할 수 없습니다"라는 오류가 발생할 수 있습니다. 자세한 내용은 여기를 참조하세요.
- 파일 선택기는 폴더당 최대 200개 항목만 표시합니다. 폴더에 항목이 200개 이상 있는 경우 사용자가 항목을 찾는 데 문제가 있을 수 있습니다.
- 연속 504 오류가 있는 경우 고객은 다른 Graph API 제한으로 인해 제한에 직면할 수 있습니다. 다음은 장기 실행 작업에 대한 504를 줄이기 위한 몇 가지 제안 사항입니다.
- 수식 및 종속성을 줄여 테이블을 최대한 간단하게 업데이트합니다.
- 행 수가 큰 경우 동일한 테이블 형식의 다른 빈 워크시트/통합 문서를 사용합니다.
- 파일에 대한 쓰기 액세스는 모든 작업에 필요하며, 그렇지 않으면 Graph API에서 오류를 반환
403 Forbidden합니다. 또한 스프레드시트가 읽기 전용 모드인 경우 커넥터에서 오류를 반환502 BadGateway합니다. 읽기 전용 모드를 사용하지 않도록 설정하려면 여기에서 자세히 알아보세요. - 각 커넥터 요청의 지원되는 최대 크기는 5MB입니다.
열 이름 처리
작업 응답 결과의 열 이름은 OData 형식과 호환되도록 변환할 수 있습니다.
| 캐릭터 | 인코딩된 값 |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| # | _x0023_ |
예: Column [one]#1 ->Column [one]_x0023_1
일반 제한
| 이름 | 가치 |
|---|---|
| 단일 Excel 테이블에서 행을 가져오기/삽입/업데이트/삭제하는 데 사용할 수 있는 ID 열 변형의 최대 수입니다. 현재 값은 2로 설정됩니다. 즉, 하나의 특정 테이블에 대해 워크플로에서 최대 두 개의 열 이름 변형을 사용해야 합니다. | 2 |
개념 및 예제
- 키 열: 값(키 값)을 검색하는 데 사용할 테이블의 열입니다.
- 키 값: 특정 행을 식별하는 데 사용할 키 열의 값입니다.
다음 표는 예제입니다. 테이블 key column 의 두 번째 행에서 행 작업을 수행하려면 200이어야 합니다 Column 1key value.
| 열 1 | 열 2 | 3열 |
|---|---|---|
| 100 | A-2 | A-3 |
| 200 | B-2 | B-3 |
| 300 | C-2 | C-3 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
|
Share |
Excel 통합 문서에 대해 Office 스크립트를 실행합니다. 스크립트가 기본 위치 외부에 저장되면 이 작업을 사용합니다. |
| 스크립트 실행 |
Excel 통합 문서에 대해 Office 스크립트를 실행합니다. 스크립트가 기본 위치에 저장되면 이 작업을 사용합니다. |
| 워크시트 가져오기 |
Excel 통합 문서에서 워크시트 목록을 가져옵니다. |
| 워크시트 만들기 |
Excel 통합 문서에서 새 워크시트를 만듭니다. |
| 테이블 가져오기 |
Excel 통합 문서에서 테이블 목록을 가져옵니다. |
| 테이블 만들기 |
Excel 통합 문서에서 새 테이블을 만듭니다. |
| 테이블에 있는 행 나열 |
테이블에 있는 행을 나열합니다. |
| 테이블에 키 열 추가 |
Excel 테이블에 키 열을 추가합니다. 새 열이 오른쪽에 추가됩니다. |
| 테이블에 행 추가 |
Excel 표에 새 행을 추가합니다. |
| 테이블에 행 추가 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 테이블에 행 추가를 사용하세요.
|
| 행 가져오기 |
키 열을 사용하여 행을 가져옵니다. |
| 행 삭제 |
키 열을 사용하여 행을 삭제합니다. |
| 행 업데이트 |
키 열을 사용하여 행을 업데이트합니다. 입력 값은 지정된 셀을 덮어쓰고 빈 열은 업데이트되지 않습니다. 값을 덮어쓰는 대신 추가하려면 "행 가져오기" 작업을 사용하여 먼저 콘텐츠를 검색합니다. |
SharePoint 라이브러리에서 스크립트 실행
Excel 통합 문서에 대해 Office 스크립트를 실행합니다. 스크립트가 기본 위치 외부에 저장되면 이 작업을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
통합 문서 위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
통합 문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
통합 문서
|
file | True | string |
파일 찾아보기를 통해 Excel 통합 문서를 선택합니다. |
|
스크립트 위치
|
scriptSource | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
스크립트 라이브러리
|
scriptDrive | True | string |
드롭다운에서 Office 스크립트 파일(.osts)의 SharePoint 라이브러리를 선택합니다. |
|
스크립트
|
scriptId | True | string |
드롭다운에서 SharePoint 라이브러리에서 Office 스크립트 파일(.osts)을 선택합니다. |
|
ScriptParameters
|
ScriptParameters | True | dynamic |
Office 스크립트에 대한 매개 변수를 제공합니다. |
반환
스크립트 실행
Excel 통합 문서에 대해 Office 스크립트를 실행합니다. 스크립트가 기본 위치에 저장되면 이 작업을 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
스크립트
|
scriptId | True | string |
드롭다운에서 실행할 Office 스크립트를 선택합니다. |
|
ScriptParameters
|
ScriptParameters | True | dynamic |
Office 스크립트의 매개 변수를 제공합니다. |
반환
워크시트 가져오기
Excel 통합 문서에서 워크시트 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
민감도 레이블 추출
|
extractSensitivityLabel | boolean |
연결된 아티팩트에서 민감도 레이블 ID를 추출할지 여부를 나타내는 부울입니다. |
|
|
민감도 레이블 메타데이터
|
fetchSensitivityLabelMetadata | boolean |
연결된 LabelId에 대한 민감도 레이블 메타데이터를 가져올지 여부를 나타내는 부울입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of WorksheetMetadata | |
|
sensitivityLabelInfo
|
sensitivityLabelInfo | array of SensitivityLabelMetadata |
워크시트 만들기
Excel 통합 문서에서 새 워크시트를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
이름
|
name | string |
워크시트 이름입니다. |
반환
테이블 가져오기
Excel 통합 문서에서 테이블 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
민감도 레이블 추출
|
extractSensitivityLabel | boolean |
연결된 아티팩트에서 민감도 레이블 ID를 추출할지 여부를 나타내는 부울입니다. |
|
|
민감도 레이블 메타데이터
|
fetchSensitivityLabelMetadata | boolean |
연결된 LabelId에 대한 민감도 레이블 메타데이터를 가져올지 여부를 나타내는 부울입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
아이디
|
value.id | string |
테이블 ID입니다. |
|
이름
|
value.name | string |
테이블 이름입니다. |
|
줄무늬 열 표시
|
value.showBandedColumns | boolean |
줄무늬 열을 표시합니다. |
|
첫 번째 열 강조 표시
|
value.highlightFirstColumn | boolean |
첫 번째 열을 강조 표시합니다. |
|
마지막 열 강조 표시
|
value.highlightLastColumn | boolean |
마지막 열을 강조 표시합니다. |
|
줄무늬 행 표시
|
value.showBandedRows | boolean |
줄무늬 행을 표시합니다. |
|
필터 단추 표시
|
value.showFilterButton | boolean |
필터 단추 표시 |
|
머리글 표시
|
value.showHeaders | boolean |
머리글을 표시합니다. |
|
합계 표시
|
value.showTotals | boolean |
합계를 표시합니다. |
|
스타일
|
value.style | string |
표 스타일입니다. |
|
sensitivityLabelInfo
|
sensitivityLabelInfo | array of SensitivityLabelMetadata |
테이블 만들기
Excel 통합 문서에서 새 테이블을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
테이블 이름
|
TableName | string |
Excel 테이블 이름을 입력합니다. |
|
|
테이블 범위
|
Range | True | string |
A1 표기법을 사용하여 테이블 주소를 입력합니다. |
|
열 이름
|
ColumnsNames | string |
열 이름을 ';' 또는 ','로 구분하여 입력합니다. |
반환
테이블 메타데이터
테이블에 있는 행 나열
테이블에 있는 행을 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. - "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/team name:" (콜론 필요) |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 ODATA 필터 쿼리입니다. |
|
|
주문 기준
|
$orderby | string |
항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다. |
|
|
상위 개수
|
$top | integer |
검색할 총 항목 수입니다(기본값 = 모두). |
|
|
개수 건너뛰기
|
$skip | integer |
건너뛸 항목 수(기본값 = 0)입니다. |
|
|
쿼리 선택
|
$select | string |
검색할 열의 쉼표로 구분된 목록입니다(기본적으로 처음 500개). |
|
|
DateTime 형식
|
dateTimeFormat | string |
DateTime 형식입니다. |
|
|
민감도 레이블 추출
|
extractSensitivityLabel | boolean |
연결된 아티팩트에서 민감도 레이블 ID를 추출할지 여부를 나타내는 부울입니다. |
|
|
민감도 레이블 메타데이터
|
fetchSensitivityLabelMetadata | boolean |
연결된 LabelId에 대한 민감도 레이블 메타데이터를 가져올지 여부를 나타내는 부울입니다. |
반환
테이블에 키 열 추가
Excel 테이블에 키 열을 추가합니다. 새 열이 오른쪽에 추가됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
키 열
|
idColumn | string |
키 열 이름을 제공합니다. |
테이블에 행 추가
Excel 표에 새 행을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
행
|
item | True | dynamic |
지정한 Excel 표에 추가할 행입니다. |
|
DateTime 형식
|
dateTimeFormat | string |
DateTime 형식입니다. |
반환
테이블에 행 추가 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 테이블에 행 추가를 사용하세요.
Excel 표에 새 행을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. " me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/팀 이름:"(콜론 필요). |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
행
|
item | True | dynamic |
지정한 Excel 표에 삽입할 행입니다. |
행 가져오기
키 열을 사용하여 행을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. - "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/team name:" (콜론 필요) |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
키 열
|
idColumn | True | string |
드롭다운에서 열을 선택합니다. |
|
키 값
|
id | True | string |
키 값을 입력합니다. |
|
DateTime 형식
|
dateTimeFormat | string |
DateTime 형식입니다. |
|
|
민감도 레이블 추출
|
extractSensitivityLabel | boolean |
연결된 아티팩트에서 민감도 레이블 ID를 추출할지 여부를 나타내는 부울입니다. |
|
|
민감도 레이블 메타데이터
|
fetchSensitivityLabelMetadata | boolean |
연결된 LabelId에 대한 민감도 레이블 메타데이터를 가져올지 여부를 나타내는 부울입니다. |
반환
행 삭제
키 열을 사용하여 행을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. - "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/team name:" (콜론 필요) |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
키 열
|
idColumn | True | string |
드롭다운에서 열을 선택합니다. |
|
키 값
|
id | True | string |
키 값을 입력합니다. |
행 업데이트
키 열을 사용하여 행을 업데이트합니다. 입력 값은 지정된 셀을 덮어쓰고 빈 열은 업데이트되지 않습니다. 값을 덮어쓰는 대신 추가하려면 "행 가져오기" 작업을 사용하여 먼저 콘텐츠를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
위치
|
source | True | string |
드롭다운에서 선택하거나 다음 중 하나를 지정합니다. - "me" - "SharePoint 사이트 URL" - "사용자/사용자의 UPN" - "그룹/그룹 ID" - "sites/SharePoint 사이트 URL:/teams/team name:" (콜론 필요) |
|
문서 라이브러리
|
drive | True | string |
드롭다운에서 문서 라이브러리를 선택합니다. |
|
File
|
file | True | string |
파일 찾아보기를 통해 Excel 파일을 선택합니다. |
|
Table
|
table | True | string |
드롭다운에서 테이블을 선택합니다. |
|
키 열
|
idColumn | True | string |
드롭다운에서 열을 선택합니다. |
|
키 값
|
id | True | string |
키 값을 입력합니다. |
|
항목 속성 제공
|
item | True | dynamic |
항목 속성을 제공합니다. |
|
DateTime 형식
|
dateTimeFormat | string |
DateTime 형식입니다. |
반환
트리거
| 선택한 행의 경우 |
Excel 테이블에서 선택한 행에 대한 흐름을 트리거합니다. (Power Automate에만 사용 가능) |
선택한 행의 경우
Excel 테이블에서 선택한 행에 대한 흐름을 트리거합니다. (Power Automate에만 사용 가능)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
schema(스키마)
|
schema | True | object | |
|
headersSchema
|
headersSchema | object |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
행
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
사용자 ID
|
headers.x-ms-user-id-encoded | guid |
AAD에서 흐름을 트리거한 사용자의 고유 식별자입니다. |
|
사용자 이메일
|
headers.x-ms-user-email-encoded | byte |
흐름을 트리거한 사용자의 이메일 주소입니다. |
|
사용자 이름
|
headers.x-ms-user-name-encoded | byte |
흐름을 트리거한 사용자의 표시 이름입니다. |
|
시간표시
|
headers.x-ms-user-timestamp | string |
흐름이 트리거된 시간입니다. |
정의
TableMetadata
테이블 메타데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
name | string |
테이블 이름 |
|
title
|
title | string |
테이블 제목 |
|
x-ms-permission
|
x-ms-permission | string |
테이블 권한 |
|
x-ms-capabilities
|
x-ms-capabilities | TableCapabilitiesMetadata |
테이블에 대한 메타데이터(기능) |
|
schema(스키마)
|
schema | Object | |
|
referencedEntities
|
referencedEntities | Object | |
|
webUrl
|
webUrl | string |
URL 링크 |
TableCapabilitiesMetadata
테이블에 대한 메타데이터(기능)
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
sortRestrictions
|
sortRestrictions | TableSortRestrictionsMetadata |
테이블에 대한 메타데이터(정렬 제한 사항) |
|
filterRestrictions
|
filterRestrictions | TableFilterRestrictionsMetadata |
테이블에 대한 메타데이터(필터 제한 사항) |
|
selectRestrictions
|
selectRestrictions | TableSelectRestrictionsMetadata |
테이블에 대한 메타데이터(제한 사항 선택) |
|
isOnlyServerPagable
|
isOnlyServerPagable | boolean |
서버 페이징 제한 |
|
filterFunctionSupport
|
filterFunctionSupport | array of string |
지원되는 필터 기능 목록 |
|
serverPagingOptions
|
serverPagingOptions | array of string |
지원되는 서버 기반 페이징 기능 목록 |
Object
TableSortRestrictionsMetadata
테이블에 대한 메타데이터(정렬 제한 사항)
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
sortable
|
sortable | boolean |
이 테이블에 정렬 가능한 열이 있는지 여부를 나타냅니다. |
|
unsortableProperties
|
unsortableProperties | array of string |
정렬할 수 없는 속성 목록 |
|
ascendingOnlyProperties
|
ascendingOnlyProperties | array of string |
오름차순만 지원하는 속성 목록 |
TableFilterRestrictionsMetadata
테이블에 대한 메타데이터(필터 제한 사항)
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
filterable
|
filterable | boolean |
이 테이블에 필터링 가능한 열이 있는지 여부를 나타냅니다. |
|
nonFilterableProperties
|
nonFilterableProperties | array of string |
필터링할 수 없는 속성 목록 |
|
requiredProperties
|
requiredProperties | array of string |
필수 속성 목록 |
TableSelectRestrictionsMetadata
테이블에 대한 메타데이터(제한 사항 선택)
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
선택
|
selectable | boolean |
이 테이블에 선택 가능한 열이 있는지 여부를 나타냅니다. |
WorksheetMetadata
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
워크시트 ID입니다. |
|
이름
|
name | string |
워크시트 이름입니다. |
|
Position
|
position | integer |
워크시트 위치입니다. |
|
가시성
|
visibility | string |
워크시트 표시 여부입니다. |
SensitivityLabelMetadata
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
sensitivityLabelId
|
sensitivityLabelId | string |
SensitivityLabel ID입니다. |
|
이름
|
name | string |
SensitivityLabel 이름입니다. |
|
표시 이름
|
displayName | string |
SensitivityLabel displayName 정보 |
|
도구 설명
|
tooltip | string |
도구 설명에 대한 SensitivityLabel 세부 정보입니다. |
|
우선순위
|
priority | integer |
SensitivityLabel 우선 순위입니다. |
|
color
|
color | string |
SensitivityLabel 색입니다. |
|
암호화됨
|
isEncrypted | boolean |
는 SensitivityLabel Encrypted입니다. |
|
활성화됨
|
isEnabled | boolean |
SensitivityLabel을 사용할 수 있는지 여부입니다. |
|
isParent
|
isParent | boolean |
SensitivityLabel이 부모인지 여부입니다. |
|
parentSensitivityLabelId
|
parentSensitivityLabelId | string |
부모 SensitivityLabel ID입니다. |