함수에서 사용할 데이터
xlwings Lite활용, 실습데이터 호출에서 정의한 재무데이터 호출 함수를 기본데이터로 사용합니다.엑셀 자동화의 시작: 읽고 쓰기
중요: Xlwings Lite의 제한사항
현재 Xlwings Lite에서는 외부 엑셀 파일 불러오기 기능이 지원되지 않습니다. 해당 기능은 개발 진행 중입니다.
자동화의 핵심
•
데이터 읽기와 가공이 핵심 로직
•
읽기와 쓰기의 반복적인 프로세스
Xlwings Lite 함수 만들기
필요한 배경지식
•
변수 개념 (필수)
•
함수 개념 (선택사항)
xlwings lite 함수의 기본 개념
xlwings lite의 함수는 엑셀에서 사용하는 SUM과 같은 기능을 하는 함수입니다.
•
엑셀의 SUM 함수에 숫자를 넣으면 합계가 나오듯이
•
xlwings lite 함수도 값(인수)을 넣으면 원하는 결과가 나옵니다
즉, 엑셀에서 SUM 함수를 호출하듯이 우리가 만든 함수를 "내가만든함수()" 이렇게 호출할 수 있다는 의미입니다. 함수 이름은 자유롭게 정할 수 있죠!
함수 작성 단계
1.
함수 정의: def + 함수명 + () 형식으로 작성
2.
데코레이터 추가: @func를 함수 위에 추가하여 xlwings에 사용자 함수임을 알림
3.
매개변수 정의: 함수의 괄호 안에 필요한 매개변수(엑셀의 '인수') 정의
4.
데이터프레임 지정: df: pd.DataFrame으로 매개변수의 데이터 형태 지정
5.
값 반환: 받은 값을 처리 후 반환 (기본은 그대로 반환)
함수가 완성되면 엑셀의 어느 셀에서나 함수명으로 호출이 가능합니다.
@func
def readRange(df:pd.DataFrame):
return df
Python
복사
이 코드는 xlwings lite에서 사용할 수 있는 가장 기본적인 함수입니다. 각 부분을 자세히 살펴보겠습니다
•
@func: xlwings lite에게 이것이 엑셀에서 사용할 수 있는 함수라고 알려주는 데코레이터입니다.
•
def readRange: 함수의 이름을 'readRange'로 정의합니다. 이 이름으로 엑셀에서 함수를 호출할 수 있습니다. 제가 제마음대로 정한 명칭이므로 사용자는 니마음대로 함수명을 정하면 됩니다.
•
(df: pd.DataFrame): 이 함수가 받는 매개변수를 정의합니다. df라는 이름의 판다스 데이터프레임을 입력받습니다.
•
return df: 입력받은 데이터프레임을 그대로 반환합니다.
이 함수는 엑셀에서 선택한 범위의 데이터를 그대로 다시 반환하는 가장 단순한 형태의 함수입니다. 엑셀에서는 =READRANGE(범위)와 같은 형식으로 사용할 수 있습니다.
