다음을 통해 공유

Excel Online(OneDrive)

Excel Online(OneDrive) 연결 공급자를 사용하면 OneDrive에 저장된 Excel 파일을 사용할 수 있습니다. 이 연결 공급자는 개인(MSA) 계정만 지원합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 21Vianet에서 운영하는 중국 클라우드
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps - 사용할 수 없음
Power Automate 스탠다드 다음을 제외한 모든 Power Automate 지역 :
     - 21Vianet에서 운영하는 중국 클라우드
커넥터 메타데이터
게시자 Microsoft

알려진 문제 및 제한 사항

  • Excel Online(OneDrive) 커넥터에서 지원하는 Excel 파일의 최대 크기는 5MB입니다.
  • 작업에서 필터링 또는 정렬을 사용할 List rows present in a table 때 데이터가 최신 상태가 아닐 수 있습니다(약간의 지연이 있을 수 있음).
  • 이 List rows present in a table 작업은 기본 필터링 및 정렬을 지원합니다.
    • eq, ne, contains, startswith, endswith 필터 함수를 지원합니다.
    • 단 하나의 필터 함수만 열에 적용할 수 있습니다.
    • 정렬에는 열이 1 개만 사용할 수 있습니다.
  • 이 List rows present in a table 작업은 기본적으로 최대 256개의 행을 반환합니다. 모든 행을 얻으려면 페이지 매김을 켭니다.
  • 업데이트용으로 OneDrive에서 Excel 파일이 잠기거나 커넥터를 마지막으로 사용한 후 최대 12분까지 삭제할 수 있습니다.
  • 다른 커넥터 또는 수동 편집에서 수행한 동시 파일 수정은 지원되지 않습니다. 사용자는 여러 클라이언트에서 동시에 단일 Excel 파일에 데이터를 쓰지 않아야 합니다(Excel Desktop, Excel Web, Power Automate, LogicApps 또는 PowerApps). 이로 인해 병합 충돌 및 데이터 불일치가 발생할 수 있습니다.
  • 커넥터는 Microsoft Excel Open XML 스프레드시트(*.xlsx) 및 Microsoft Excel 이진 통합 문서(.xlxb) 형식의 파일을 지원합니다.
  • 커넥터는 작업에서 최대 500개의 열에 대한 행을 List rows present in a table 검색합니다. 처음 500개 열에 대한 행은 기본적으로 반환됩니다. 매개 변수에서 Select Query 검색할 특정 열의 쉼표로 구분된 목록을 제공할 수 있습니다.
  • 커넥터는 숨겨진 열을 포함하는 테이블에 OData 매개 변수 사용을 지원하지 않습니다.
  • 복잡한 수식이 있거나 워크시트에 너무 많은 행이 있는 경우 다시 계산으로 인한 커넥터 시간 제한이 발생할 수 있습니다. 두 경우 모두 재시도 정책으로 인해 데이터를 여러 번 삽입할 수 있습니다. 해결 방법으로 수식을 간소화하거나 줄일 수 있는지 확인하세요. 그렇지 않으면 이 통합 문서의 계산 모드를 수동으로 설정할 수 있습니다. 자세한 내용은 여기를 참조하세요.
  • 파일에 대한 쓰기 액세스는 모든 작업에 필요하며, 그렇지 않으면 Graph API에서 오류를 반환 403 Forbidden 합니다. 또한 스프레드시트가 읽기 전용 모드인 경우 커넥터에서 오류를 반환 502 BadGateway 합니다. 읽기 전용 모드를 사용하지 않도록 설정하려면 여기에서 자세히 알아보세요.
  • Filter Query / Order By / Select Query 작업 매개 변수는 영숫자 열 이름만 지원합니다.
  • 피벗 테이블은 Graph API 제한으로 인해 지원되지 않습니다.
  • 사용자가 짧은 기간 내에 너무 많은 요청을 하는 경우 429 응답을 받을 수 있습니다. 제한 제한은 각 요청에 고유하며 요청 수, 사용된 메모리 및 기타 중요한 요소에 따라 달라집니다.
  • 같은 Delete a rowkey column 작업에서 필드는 .입니다case-sensitive.
  • 작업과 같은 Update a rowDelete a row 작업에서 여러 일치 항목이 있는 경우 첫 번째 행만 업데이트/삭제됩니다.
  • 와 같은 Create a rowUpdate a rowDelete a row 작업에서 커밋된 변경 내용이 해당 Power Automate, LogicApps 또는 Power Apps 작업의 성공적인 응답 직후에 항상 영향을 받지는 않습니다. 기본 백 엔드 서비스 제한으로 인해 최대 30초까지 지연이 예상됩니다.
  • PowerApps에서 테이블을 가져오는 동안 옵션을 선택하면 커넥터가 최대 64000개의 행을 자동으로 Insert auto generated id into Excel table 채울 수 있습니다.
  • 숫자만 포함된 테이블 열 헤더는 기본 백 엔드 서비스 제한으로 Update a rowDelete a row 인해 작업에서 예기치 않은 동작을 일으킬 수 있습니다. 해결 방법으로 다른 문자도 포함되도록 이러한 열의 이름을 바꾸세요.
  • Excel 파일을 수정할 수 있으며 "읽기 전용" 작업이 실행되는 경우에도 파일의 버전 기록에 새 버전이 표시될 수 있습니다. 이 동작은 커넥터 백 엔드 서비스의 내부 저장 메커니즘으로 인해 설계되었습니다.
  • 파일을 수동으로 열 수 있더라도 파일을 배설하거나 보호된 시트로 표시하면 손상된 파일 오류가 발생합니다.

열 이름 처리

작업 응답 결과의 열 이름은 OData 형식과 호환되도록 변환될 수 있습니다.

캐릭터 인코딩된 값
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

예: Column [one]#1 ->Column [one]_x0023_1

개념 및 예제

  • Key column: 값을 검색하는 데 사용할 테이블의 열(key value)
  • Key value: 특정 행을 key column 식별하는 데 사용할 값입니다.

다음 표를 예로 들어 하세요. 테이블 key column 의 두 번째 행에서 행 작업을 수행하려면 다음이어야 Column 1key value 합니다 200.

열 1 열 2 3열
100 A-2 A-3
200 B-2 B-3
300 C-2 C-3

일반 제한

이름 가치
단일 Excel 테이블에서 행을 가져오기/삽입/업데이트/삭제하는 데 사용할 수 있는 ID 열 변형의 최대 수입니다. 현재 값은 2로 설정됩니다. 즉, 하나의 특정 테이블에 대해 워크플로에서 최대 두 개의 열 이름 변형을 사용해야 합니다. 2
PowerApps에서 테이블을 가져오는 동안 'Excel 표에 자동 생성된 ID 삽입 옵션'을 선택하면 커넥터가 자동으로 채울 수 있는 최대 행 수입니다. 64000

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

워크시트 가져오기

Excel 통합 문서에서 워크시트 목록을 가져옵니다.
워크시트 만들기

Excel 통합 문서에서 새 워크시트를 만듭니다.
테이블 가져오기

Excel 통합 문서에서 테이블 목록을 가져옵니다.
테이블 만들기

Excel 통합 문서에서 새 테이블을 만듭니다.
테이블에 있는 행 나열

테이블에 있는 행을 나열합니다.
테이블에 키 열 추가

Excel 테이블에 키 열을 추가합니다. 새 열이 오른쪽에 추가됩니다. 새 키 열은 테이블에서 고유해야 합니다.
테이블에 행 추가

Excel 표에 새 행을 추가합니다.
테이블에 행 추가 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 테이블에 행 추가를 사용하세요.

Excel 표에 새 행을 추가합니다.
행 가져오기

키 열을 사용하여 행을 가져옵니다. 이 작업은 열 및 키 열이 지정된 지정된 행의 모든 값을 검색합니다.
행 삭제

키 열을 사용하여 행을 삭제합니다.
행 업데이트

키 열을 사용하여 행을 업데이트합니다. 입력 값은 지정된 셀을 덮어쓰고 빈 열은 업데이트되지 않습니다. 값을 덮어쓰는 대신 추가하려면 "행 가져오기" 작업을 사용하여 먼저 콘텐츠를 검색합니다.

워크시트 가져오기

작업 ID:
GetAllWorksheets

Excel 통합 문서에서 워크시트 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.

반환

Name 경로 형식 Description
value
 value array of WorksheetMetadata

워크시트 만들기

작업 ID:
CreateWorksheet

Excel 통합 문서에서 새 워크시트를 만듭니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
이름
 name string

워크시트 이름입니다.

반환

몸
WorksheetMetadata

테이블 가져오기

작업 ID:
GetTables

Excel 통합 문서에서 테이블 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.

반환

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

표 스타일입니다.

테이블 만들기

작업 ID:
CreateTable

Excel 통합 문서에서 새 테이블을 만듭니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
테이블 이름
 TableName string

Excel 테이블 이름을 입력합니다.
테이블 범위
 Range True string

A1 표기법을 사용하여 테이블 주소를 입력합니다.
열 이름
 ColumnsNames string

열 이름을 ';' 또는 ','로 구분하여 입력합니다.

반환

테이블 메타데이터

몸
TableMetadata

테이블에 있는 행 나열

작업 ID:
GetItems

테이블에 있는 행을 나열합니다.

매개 변수

Name 키 필수 형식 Description
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 형식입니다.

반환

이 작업의 출력은 동적입니다.

테이블에 키 열 추가

작업 ID:
CreateIdColumn

Excel 테이블에 키 열을 추가합니다. 새 열이 오른쪽에 추가됩니다. 새 키 열은 테이블에서 고유해야 합니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
Table
 table True string

드롭다운에서 테이블을 선택합니다.
키 열
 idColumn string

키 열 이름을 제공합니다.

테이블에 행 추가

작업 ID:
AddRowV2

Excel 표에 새 행을 추가합니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
Table
 table True string

드롭다운에서 테이블을 선택합니다.
행
 item True dynamic

지정한 Excel 표에 추가할 행입니다.
DateTime 형식
 dateTimeFormat string

DateTime 형식입니다.

반환

이 작업의 출력은 동적입니다.

테이블에 행 추가 [사용되지 않음]

작업 ID:
AddRow

이 작업은 더 이상 사용되지 않습니다. 대신 테이블에 행 추가를 사용하세요.

Excel 표에 새 행을 추가합니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
Table
 table True string

드롭다운에서 테이블을 선택합니다.
행
 item True dynamic

지정한 Excel 표에 삽입할 행입니다.

행 가져오기

작업 ID:
GetItem

키 열을 사용하여 행을 가져옵니다. 이 작업은 열 및 키 열이 지정된 지정된 행의 모든 값을 검색합니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
Table
 table True string

드롭다운에서 테이블을 선택합니다.
키 열
 idColumn True string

드롭다운에서 열을 선택합니다.
키 값
 id True string

키 값을 입력합니다.
DateTime 형식
 dateTimeFormat string

DateTime 형식입니다.

반환

이 작업의 출력은 동적입니다.

행 삭제

작업 ID:
DeleteItem

키 열을 사용하여 행을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
Table
 table True string

드롭다운에서 테이블을 선택합니다.
키 열
 idColumn True string

드롭다운에서 열을 선택합니다.
키 값
 id True string

키 값을 입력합니다.

행 업데이트

작업 ID:
PatchItem

키 열을 사용하여 행을 업데이트합니다. 입력 값은 지정된 셀을 덮어쓰고 빈 열은 업데이트되지 않습니다. 값을 덮어쓰는 대신 추가하려면 "행 가져오기" 작업을 사용하여 먼저 콘텐츠를 검색합니다.

매개 변수

Name 키 필수 형식 Description
File
 file True string

파일 찾아보기를 통해 Excel 파일을 선택합니다.
Table
 table True string

드롭다운에서 테이블을 선택합니다.
키 열
 idColumn True string

드롭다운에서 열을 선택합니다.
키 값
 id True string

키 값을 입력합니다.
항목 속성 제공
 item True dynamic

항목 속성을 제공합니다.
DateTime 형식
 dateTimeFormat string

DateTime 형식입니다.

반환

이 작업의 출력은 동적입니다.

정의

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

워크시트 표시 여부입니다.