기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Excel
<a name="actions-excel"></a>

Excel 작업을 사용하면 자동화에서 Excel 파일을 읽고 업데이트하고 생성할 수 있습니다. 모든 Excel 작업은 .xlsx 및 .xlsm 파일 형식을 모두 지원합니다. 워크북 식별자는 여러 작업에서 참조를 유지합니다.

**참고**  
.xlsm 파일에서 값을 읽을 수 있지만 매크로 실행은 지원되지 않습니다.

## 새 워크북 생성
<a name="create-new-workbook"></a>

빈 Excel 파일을 생성합니다. 후속 단계에서 스프레드시트를 업데이트하는 데 사용할 수 있는 통합 문서 식별자를 출력합니다.

**속성:**
+ **워크북 식별자**(출력): 향후 작업을 위해 워크북 참조를 저장하는 변수 이름(기본값: `workbook_id`)

## 기존 워크북 열기
<a name="open-existing-workbook"></a>

기존 Excel 파일을 로드합니다. 후속 단계에서 스프레드시트를 업데이트하는 데 사용할 수 있는 통합 문서 식별자를 반환합니다. Excel(.xlsx) 파일만 지원합니다.

**속성:**
+ **Excel 파일**(필수): 열 .xlsx 파일로, 일반적으로 변수(예: `my_file`)에 저장됩니다.
+ **워크북 식별자**(출력): 워크북 참조를 저장하는 변수 이름(기본값: `workbook_id`)

**파일 요구 사항:**
+ 유효한 Excel(.xlsx) 파일이어야 합니다.
+ 파일은 미디어 파일 객체로 액세스할 수 있어야 합니다.

## 워크북 저장
<a name="save-workbook"></a>

Excel 파일에 업데이트를 저장합니다. 저장된 통합 문서의 파일 이름과 파일 유형을 업데이트할 수 있습니다.

**속성:**
+ **파일 이름**(필수): 확장명 없이 저장된 파일의 이름(예: "월별 보고서")
+ **파일 유형**(드롭다운): 출력 형식 - 현재 XLSX 지원(기본값: XLSX)
+ **저장된 파일**(출력): 저장된 파일 객체를 저장하는 변수(기본값: `saved_file`)

## 읽기 시트
<a name="read-sheet"></a>

다양한 셀에서 데이터를 가져옵니다. 작업은 출력을 데이터 테이블 변수에 저장합니다.

**속성:**
+ **워크북 식별자**(필수): 읽을 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 워크시트 또는 탭 이름(기본값: "Sheet1")
+ **셀 범위**(선택 사항): 범위 사양 - 여러 형식을 지원합니다.
  + 시작 셀: "A2"( 앵커 포인트에서 모든 데이터를 읽음)
  + 정확한 범위: "A1:B10"
  + 열 범위: "A:B"
  + 행 범위: "1:3"
  + 비어 있음: 전체 시트를 읽습니다.
+ **헤더 포함**(확인란): 활성화된 경우 첫 번째 행을 열 헤더로 처리합니다. 비활성화하면 기본 이름 지정(Column0, Column1 등)을 사용합니다(기본값: TRUE).
+ **데이터 테이블**(출력): 추출된 데이터를 저장하는 변수(기본값: `excel_table`)

**공식 처리:**
+ 작업은 수식을 자동으로 계산하고 결과를 데이터 테이블에 저장합니다.

## 셀 읽기
<a name="read-cell"></a>

셀에서 값을 가져옵니다. 워크시트에서 개별 셀 값을 읽는 데 사용됩니다.

**속성:**
+ **워크북 식별자**(필수): 읽을 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 워크시트 이름(기본값: "Sheet1")
+ **셀 참조**(필수): 셀 위치(예: "A1")
+ **셀 값**(출력): 셀 콘텐츠를 저장하는 변수(기본값: `cell_value`)

## 시트에 쓰기
<a name="write-to-sheet"></a>

데이터 테이블을 시트로 출력합니다. 워크시트에 다양한 행과 열을 쓰는 데 사용됩니다.

**속성:**
+ **데이터 테이블**(필수): 작성할 데이터 테이블(예: `my_table`)
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 대상 워크시트(기본값: "Sheet1")
+ **셀에서 시작**(선택 사항): 데이터 배치를 위한 시작 위치(기본값: "A1")
+ **헤더 포함**(확인란): 활성화된 경우 열 헤더를 작성합니다(기본값: TRUE).

## 셀에 쓰기
<a name="write-to-cell"></a>

셀에 값을 출력합니다. 워크시트에서 개별 셀을 업데이트하는 데 사용됩니다.

**속성:**
+ **작성할 값**(필수): 셀의 콘텐츠(예: "Order \$112345")
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 대상 워크시트(기본값: "Sheet1")
+ **셀 참조**(필수): 대상 셀 위치(예: "A1")

## 새 행 쓰기
<a name="write-new-row"></a>

시트에 데이터 행을 추가합니다. 새 행이 기존 데이터의 끝에 추가됩니다.

**속성:**
+ **행 값**(필수): 첫 번째 열부터 새 행의 값 배열(예: ["Q1", "Sales", 100])
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 대상 워크시트(기본값: "Sheet1")

**데이터 검증:**
+ 값을 배열 형식으로 제공해야 합니다.
+ 값은 첫 번째 열부터 순차적으로 기록됩니다.

## 새 시트 생성
<a name="create-new-sheet"></a>

빈 워크시트를 추가합니다. 새 시트가 통합 문서의 끝에 추가됩니다.

**속성:**
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 새 워크시트의 이름(예: "판매 데이터")

## 시트 복사
<a name="copy-sheet"></a>

워크시트 사본을 생성합니다. 새 시트는 동일한 통합 문서 내에 생성됩니다.

**속성:**
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **복사할 시트 이름**(필수): 소스 워크시트 이름(예: "Original Sheet")
+ **새 시트 이름**(필수): 중복된 시트 이름(예: "Original Sheet (Copy)")

## 시트 이름 바꾸기
<a name="rename-sheet"></a>

기존 워크시트의 이름을 업데이트합니다.

**속성:**
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **현재 시트 이름**(필수): 기존 워크시트 이름(예: "Sheet1")
+ **업데이트된 시트 이름**(필수): 워크시트의 새 이름(예: "Q1 데이터")

## 시트 삭제
<a name="delete-sheet"></a>

통합 문서에서 시트를 제거합니다. 워크북의 나머지 마지막 시트를 삭제할 수 없습니다.

**속성:**
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **삭제할 시트 이름**(필수): 제거할 워크시트(예: "Sheet1")

**제약 조건**:
+ 통합 문서에서 마지막으로 남은 시트를 삭제할 수 없음

## 셀 색상 설정
<a name="set-cell-color"></a>

셀 배경색을 업데이트합니다. 특정 셀 범위를 강조 표시하는 데 사용됩니다.

**속성:**
+ **셀 색상**(필수): RGB 16진수 코드 형식(예: 빨간색의 경우 "FF0000")
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 대상 워크시트(예: "Sheet1")
+ **셀 범위**(필수): 형식을 위한 범위 - 지원:
  + 단일 셀: "A1"
  + 정확한 범위: "A1:B10"
  + 열 범위: "A:B"
  + 행 범위: "1:3"

## 셀 색상 가져오기
<a name="get-cell-color"></a>

셀 배경색을 읽습니다. RGB 16진수 코드 형식(예: 빨간색의 경우 "FF0000")으로 색상을 출력합니다.

**속성:**
+ **워크북 식별자**(필수): 소스 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 소스 워크시트(예: "Sheet1")
+ **셀 참조**(필수): 읽을 셀(예: "A1")
+ **셀 색상**(출력): RGB 16진수 코드를 저장하는 변수(기본값: `cell_color`)

## 행 숨기기
<a name="hide-rows"></a>

시트에 행을 숨깁니다. 데이터는 그대로 유지되지만 표시되지 않습니다.

**속성:**
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 대상 워크시트(예: "Sheet1")
+ **시작 행**(필수): 숨길 첫 번째 행 번호(Excel 번호는 1에서 시작)
+ **끝 행**(선택 사항): 숨길 마지막 행 번호입니다. 비어 있는 경우 시작 행만 숨겨집니다.

**행 번호 지정:**
+ Excel 행 번호는 1부터 시작합니다(0이 아님).
+ 정수 값을 제공해야 합니다.

## 행 숨기기 해제
<a name="unhide-rows"></a>

숨겨진 행을 표시합니다. 이전에 숨겨진 행을 표시하는 데 사용됩니다.

**속성:**
+ **워크북 식별자**(필수): 대상 워크북(예: `workbook_id`)
+ **시트 이름**(필수): 대상 워크시트(예: "Sheet1")
+ **시작 행**(필수): 숨김을 해제할 첫 번째 행 번호(Excel 번호 지정은 1에서 시작)
+ **End Row**(선택 사항): 숨김을 해제할 마지막 행 번호입니다. 비어 있는 경우 시작 행만 표시됩니다.

## 모범 사례 및 제한 사항
<a name="excel-best-practices-limitations"></a>

### 워크북 식별자 관리
<a name="excel-workbook-identifier-management"></a>
+ 설명 변수(예: , `sales_workbook``report_file`)에 워크북 식별자 저장
+ 동일한 통합 문서의 여러 작업에서 동일한 식별자 재사용
+ 데이터 작업을 수행하기 전에 항상 통합 문서를 생성하거나 엽니다.

### 범위 사양
<a name="excel-range-specifications"></a>
+ 정확한 데이터 작업을 위해 정확한 범위("A1:B10") 사용
+ 전체 열로 작업할 때 열 범위("A:B") 사용
+ 헤더 또는 요약 작업에 행 범위(“1:3”) 사용
+ 전체 시트를 처리하려면 범위를 비워 둡니다.

### 성능 최적화
<a name="excel-performance-optimization"></a>
+ 가능한 경우 개별 셀 대신 전체 범위 읽기
+ 개별 셀 쓰기 대신 데이터 테이블을 사용한 배치 쓰기 작업
+ 모든 수정이 완료된 경우에만 통합 문서 저장

### 제한 사항
<a name="excel-limitation"></a>

파일 호환성은 최신 Excel(.xlsx) 형식으로만 제한되며 레거시 Excel(.xls) 파일은 지원되지 않습니다.