기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Excel
Excel 작업을 사용하면 자동화에서 Excel 파일을 읽고 업데이트하고 생성할 수 있습니다. 모든 Excel 작업은 .xlsx 및 .xlsm 파일 형식을 모두 지원합니다. 워크북 식별자는 여러 작업에서 참조를 유지합니다.
참고
.xlsm 파일에서 값을 읽을 수 있지만 매크로 실행은 지원되지 않습니다.
새 워크북 생성
빈 Excel 파일을 생성합니다. 후속 단계에서 스프레드시트를 업데이트하는 데 사용할 수 있는 통합 문서 식별자를 출력합니다.
속성:
워크북 식별자(출력): 향후 작업을 위해 워크북 참조를 저장하는 변수 이름(기본값:
workbook_id)
기존 워크북 열기
기존 Excel 파일을 로드합니다. 후속 단계에서 스프레드시트를 업데이트하는 데 사용할 수 있는 통합 문서 식별자를 반환합니다. Excel(.xlsx) 파일만 지원합니다.
속성:
Excel 파일(필수): 열 .xlsx 파일로, 일반적으로 변수(예:
my_file)에 저장됩니다.워크북 식별자(출력): 워크북 참조를 저장하는 변수 이름(기본값:
workbook_id)
파일 요구 사항:
유효한 Excel(.xlsx) 파일이어야 합니다.
파일은 미디어 파일 객체로 액세스할 수 있어야 합니다.
워크북 저장
Excel 파일에 업데이트를 저장합니다. 저장된 통합 문서의 파일 이름과 파일 유형을 업데이트할 수 있습니다.
속성:
파일 이름(필수): 확장명 없이 저장된 파일의 이름(예: "월별 보고서")
파일 유형(드롭다운): 출력 형식 - 현재 XLSX 지원(기본값: XLSX)
저장된 파일(출력): 저장된 파일 객체를 저장하는 변수(기본값:
saved_file)
읽기 시트
다양한 셀에서 데이터를 가져옵니다. 작업은 출력을 데이터 테이블 변수에 저장합니다.
속성:
워크북 식별자(필수): 읽을 워크북(예:
workbook_id)시트 이름(필수): 워크시트 또는 탭 이름(기본값: "Sheet1")
셀 범위(선택 사항): 범위 사양 - 여러 형식을 지원합니다.
시작 셀: "A2"( 앵커 포인트에서 모든 데이터를 읽음)
정확한 범위: "A1:B10"
열 범위: "A:B"
행 범위: "1:3"
비어 있음: 전체 시트를 읽습니다.
헤더 포함(확인란): 활성화된 경우 첫 번째 행을 열 헤더로 처리합니다. 비활성화하면 기본 이름 지정(Column0, Column1 등)을 사용합니다(기본값: TRUE).
데이터 테이블(출력): 추출된 데이터를 저장하는 변수(기본값:
excel_table)
공식 처리:
작업은 수식을 자동으로 계산하고 결과를 데이터 테이블에 저장합니다.
셀 읽기
셀에서 값을 가져옵니다. 워크시트에서 개별 셀 값을 읽는 데 사용됩니다.
속성:
워크북 식별자(필수): 읽을 워크북(예:
workbook_id)시트 이름(필수): 워크시트 이름(기본값: "Sheet1")
셀 참조(필수): 셀 위치(예: "A1")
셀 값(출력): 셀 콘텐츠를 저장하는 변수(기본값:
cell_value)
시트에 쓰기
데이터 테이블을 시트로 출력합니다. 워크시트에 다양한 행과 열을 쓰는 데 사용됩니다.
속성:
데이터 테이블(필수): 작성할 데이터 테이블(예:
my_table)워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 대상 워크시트(기본값: "Sheet1")
셀에서 시작(선택 사항): 데이터 배치를 위한 시작 위치(기본값: "A1")
헤더 포함(확인란): 활성화된 경우 열 헤더를 작성합니다(기본값: TRUE).
셀에 쓰기
셀에 값을 출력합니다. 워크시트에서 개별 셀을 업데이트하는 데 사용됩니다.
속성:
작성할 값(필수): 셀의 콘텐츠(예: "Order #12345")
워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 대상 워크시트(기본값: "Sheet1")
셀 참조(필수): 대상 셀 위치(예: "A1")
새 행 쓰기
시트에 데이터 행을 추가합니다. 새 행이 기존 데이터의 끝에 추가됩니다.
속성:
행 값(필수): 첫 번째 열부터 새 행의 값 배열(예: ["Q1", "Sales", 100])
워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 대상 워크시트(기본값: "Sheet1")
데이터 검증:
값을 배열 형식으로 제공해야 합니다.
값은 첫 번째 열부터 순차적으로 기록됩니다.
새 시트 생성
빈 워크시트를 추가합니다. 새 시트가 통합 문서의 끝에 추가됩니다.
속성:
워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 새 워크시트의 이름(예: "판매 데이터")
시트 복사
워크시트 사본을 생성합니다. 새 시트는 동일한 통합 문서 내에 생성됩니다.
속성:
워크북 식별자(필수): 대상 워크북(예:
workbook_id)복사할 시트 이름(필수): 소스 워크시트 이름(예: "Original Sheet")
새 시트 이름(필수): 중복된 시트 이름(예: "Original Sheet (Copy)")
시트 이름 바꾸기
기존 워크시트의 이름을 업데이트합니다.
속성:
워크북 식별자(필수): 대상 워크북(예:
workbook_id)현재 시트 이름(필수): 기존 워크시트 이름(예: "Sheet1")
업데이트된 시트 이름(필수): 워크시트의 새 이름(예: "Q1 데이터")
시트 삭제
통합 문서에서 시트를 제거합니다. 워크북의 나머지 마지막 시트를 삭제할 수 없습니다.
속성:
워크북 식별자(필수): 대상 워크북(예:
workbook_id)삭제할 시트 이름(필수): 제거할 워크시트(예: "Sheet1")
제약 조건:
통합 문서에서 마지막으로 남은 시트를 삭제할 수 없음
셀 색상 설정
셀 배경색을 업데이트합니다. 특정 셀 범위를 강조 표시하는 데 사용됩니다.
속성:
셀 색상(필수): RGB 16진수 코드 형식(예: 빨간색의 경우 "FF0000")
워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 대상 워크시트(예: "Sheet1")
셀 범위(필수): 형식을 위한 범위 - 지원:
단일 셀: "A1"
정확한 범위: "A1:B10"
열 범위: "A:B"
행 범위: "1:3"
셀 색상 가져오기
셀 배경색을 읽습니다. RGB 16진수 코드 형식(예: 빨간색의 경우 "FF0000")으로 색상을 출력합니다.
속성:
워크북 식별자(필수): 소스 워크북(예:
workbook_id)시트 이름(필수): 소스 워크시트(예: "Sheet1")
셀 참조(필수): 읽을 셀(예: "A1")
셀 색상(출력): RGB 16진수 코드를 저장하는 변수(기본값:
cell_color)
행 숨기기
시트에 행을 숨깁니다. 데이터는 그대로 유지되지만 표시되지 않습니다.
속성:
워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 대상 워크시트(예: "Sheet1")
시작 행(필수): 숨길 첫 번째 행 번호(Excel 번호는 1에서 시작)
끝 행(선택 사항): 숨길 마지막 행 번호입니다. 비어 있는 경우 시작 행만 숨겨집니다.
행 번호 지정:
Excel 행 번호는 1부터 시작합니다(0이 아님).
정수 값을 제공해야 합니다.
행 숨기기 해제
숨겨진 행을 표시합니다. 이전에 숨겨진 행을 표시하는 데 사용됩니다.
속성:
워크북 식별자(필수): 대상 워크북(예:
workbook_id)시트 이름(필수): 대상 워크시트(예: "Sheet1")
시작 행(필수): 숨김을 해제할 첫 번째 행 번호(Excel 번호 지정은 1에서 시작)
End Row(선택 사항): 숨김을 해제할 마지막 행 번호입니다. 비어 있는 경우 시작 행만 표시됩니다.
모범 사례 및 제한 사항
워크북 식별자 관리
설명 변수(예: ,
sales_workbookreport_file)에 워크북 식별자 저장동일한 통합 문서의 여러 작업에서 동일한 식별자 재사용
데이터 작업을 수행하기 전에 항상 통합 문서를 생성하거나 엽니다.
범위 사양
정확한 데이터 작업을 위해 정확한 범위("A1:B10") 사용
전체 열로 작업할 때 열 범위("A:B") 사용
헤더 또는 요약 작업에 행 범위(“1:3”) 사용
전체 시트를 처리하려면 범위를 비워 둡니다.
성능 최적화
가능한 경우 개별 셀 대신 전체 범위 읽기
개별 셀 쓰기 대신 데이터 테이블을 사용한 배치 쓰기 작업
모든 수정이 완료된 경우에만 통합 문서 저장
제한 사항
파일 호환성은 최신 Excel(.xlsx) 형식으로만 제한되며 레거시 Excel(.xls) 파일은 지원되지 않습니다.
