• 파워 리포트에서만 사용 가능한 개체 입니다.
  • 사용자는 excel 개체를 이용해 셀의 값을 읽거나 값을 쓸 수 있습니다.
  • 스크립트에서 계산된 값을 셀에 쓰는 방식으로 리포트 작성에 활용 합니다.


셀의 위치 지정 방식

스크립트에서 셀의 값을 읽고 쓰기 위해서는 셀의 위치 ('WorkSheet', '행' , '열')를 지정 해야 합니다.

예)

# Sheet1의 B5 셀 읽기

excel.getStringValue('Sheet1','B',5)

셀의 위치를 지정하는 방법은 '이름으로 지정' 하는 방법과 '인덱스로 지정' 하는 방법이 있습니다.

이름으로  지정

셀의 위치를 Excel에서 표기한 행과 열의 문자로 지정 합니다.

# Sheet1의 B2 셀 읽기

excel.getStringValue('Sheet1','B','2')

인덱스 번호로

지정
  • 셀의 위치를 인덱스 번호로 지정 합니다.
  • 행과 열의 인덱스는 1부터 시작 합니다.
  • 행의 인덱스는 Excel의 행 번호와 동일하며, 열의 인덱스는 아래 그림과 같이 1에서 시작 합니다.  

# Sheet1의 B2 셀 읽기

excel.getStringValue('Sheet1',2 , 2 )

인덱스 지정 방식은 반복문(For , While) 같은 곳에서 인덱스 번호를 증가해 셀의 위치를 순차적 접근하여 셀의 값을 읽거나 쓰는 경우 유리 합니다.


WorkSheet  지정 방식

이름으로  지정

'Sheet3' , 'Sheet2' 와 같이 WorkSheet 이름으로 지정 합니다.

# Sheet3의 B2 셀 읽기

excel.getStringValue('Sheet3','B','2')

인덱스 번호로

지정
  • WorkSheet를 인덱스 번호로 지정 합니다.
  • WorkSheet 인덱스는 왼쪽에서 1부터 시작 합니다.

 

# Sheet1의 B2 셀 읽기

excel.getStringValue(3,'B','2')

API 함수에서 WorkSheet를 지정하지 않으면 왼쪽 첫 번째 WorkSheet가 기본으로 선택 됩니다.


Methods

리턴 값

함 수

설 명

str

getStringValue (sheet , column, row)

WorkSheet , 행 , 열을 지정해 셀의 내용을 문자열 형식으로 읽어 옵니다.

  str

getStringValue (column, row)

행 , 열을 지정해 첫 번째 WorkSheet의 셀의 내용을 문자열 형식으로 읽어 옵니다.

number

getValue (sheet , column, row)

WorkSheet , 행 , 열을 지정해 셀의 내용을 숫자 형식으로 읽어 옵니다.

number

getValue (columName, rowName)

첫 번째 WorkSheet의 행, 열을 지정해 셀의 내용을 숫자 형식으로 읽어 옵니다.


setStringValue (sheet, column, row, value)

WorkSheet , 행 , 열을 지정해 셀에 문자열 값을 씁니다.


setStringValue (column, row, value)

첫 번째 WorkSheet의 행, 열을 지정해 셀에 문자열 값을 씁니다.


setValue (sheet, column, row, value)

WorkSheet , 행 , 열을 지정해 셀에 숫자 값을 씁니다.


setValue (column, row, value)

첫 번째 WorkSheet의 행, 열을 지정해 셀에 숫자 값을 씁니다.

 getStringValue ( sheet , colum, row )

WorkSheet , 행 , 열을 지정해 셀의 내용을 문자열 형식으로 읽어 옵니다.


  • sheet : 읽어올 셀의 WorkSheet 이름이나 WorkSheet 번호를 입력 합니다.
  • column : 읽어올 셀의 행 이름이나 인덱스 번호를 입력 합니다.
  • row : 읽어올 열의 행 이름이나 인덱스 번호를 입력 합니다.


예) 셀을 문자열 형식으로 읽기


# 이름으로 지정

print excel.getStringValue('Sheet3','B','5')

# 인덱스로 지정

print excel.getStringValue(1,2,5)

# 이름, 인덱스를 혼합해 지정

print excel.getStringValue('Sheet3','B',5)

결과)

>>> 전력 일지

>>> 전력 일지

>>> 전력 일지

 getStringValue ( colum, row )

행 , 열을 지정해 첫 번째 WorkSheet의 셀의 내용을 문자열 형식으로 읽어 옵니다.


  • column : 읽어올 셀의 행 이름이나 인덱스 번호를 입력 합니다.
  • row : 읽어올 열의 행 이름이나 인덱스 번호를 입력 합니다.


예) 셀을 문자열 형식으로 읽기


# 이름으로 지정

print excel.getStringValue('B','5')

# 인덱스로 지정

print excel.getStringValue(2,5)

# 이름, 인덱스를 혼합해 지정

print excel.getStringValue('B',5)

결과)

>>> 전력 일지

>>> 전력 일지

>>> 전력 일지

 getValue ( sheet , colum, row )

WorkSheet , 행 , 열을 지정해 셀의 내용을 숫자 형식으로 읽어 옵니다.


  • sheet : 읽어올 셀의 WorkSheet 이름이나 WorkSheet 번호를 입력 합니다.
  • column : 읽어올 셀의 행 이름이나 인덱스 번호를 입력 합니다.
  • row : 읽어올 열의 행 이름이나 인덱스 번호를 입력 합니다.


예) 셀을 문자열 형식으로 읽기


# 이름으로 지정

print excel.getValue('Sheet3','B','5')

# 인덱스로 지정

print excel.getValue(1,2,5)

# 이름, 인덱스를 혼합해 지정

print excel.getValue('Sheet3','B',5)

결과)

>>> 3.141592

>>> 3.141592

>>> 3.141592

 getValue ( colum, row )

행 , 열을 지정해 첫 번째 WorkSheet의 셀의 내용을 숫자 형식으로 읽어 옵니다.


  • column : 읽어올 셀의 행 이름이나 인덱스 번호를 입력 합니다.
  • row : 읽어올 열의 행 이름이나 인덱스 번호를 입력 합니다.


예) 셀을 문자열 형식으로 읽기


# 이름으로 지정

print excel.getValue('B','5')

# 인덱스로 지정

print excel.getValue(2,5)

# 이름, 인덱스를 혼합해 지정

print excel.getValue('B',5)

결과)

>>> 3.141592

>>> 3.141592

>>> 3.141592

 setStringValue ( sheet , colum, row , value )

WorkSheet , 행 , 열을 지정해 셀에 문자열을 씁니다.


  • sheet : 대상 WorkSheet 이름이나 WorkSheet 번호를 입력 합니다.
  • column : 셀의 행 이름 또는 인덱스 번호를 입력 합니다.
  • row : 셀의 행 이름 또는 인덱스 번호를 입력 합니다.
  • value : 셀에 쓸 문자열 입니다.


예)

# 이름으로 지정

excel.setStringValue('Sheet3','B','5', '설정값 1')

# 인덱스로 지정

excel.setStringValue(1,2,6, '설정값 2')

# 이름, 인덱스를 혼합해 지정

excel.setStringValue('Sheet3','B',7, '설정값 3')

결과)

 setStringValue ( colum, row , value )

행 , 열을 지정해 첫 번째 WorkSheet의 셀에 문자열을 씁니다.


  • column : 셀의 행 이름 또는 인덱스 번호를 입력 합니다.
  • row : 셀의 열 이름 또는 인덱스 번호를 입력 합니다.
  • value : 셀에 쓸 문자열 입니다.


예)

# 이름으로 지정

excel.setStringValue('Sheet3','B','5', '설정값 1')

# 인덱스로 지정

excel.setStringValue(1,2,6, '설정값 2')

# 이름, 인덱스를 혼합해 지정

excel.setStringValue('Sheet3','B',7, '설정값 3')

결과)

 setValue ( sheet , colum, row , value)

WorkSheet , 행 , 열을 지정해 셀에 숫자를 씁니다.


  • sheet : 대상 WorkSheet 이름이나 WorkSheet 번호를 입력 합니다.
  • column : 셀의 행 이름 또는 인덱스 번호를 입력 합니다.
  • row :  셀의 열 이름 또는 인덱스 번호를 입력 합니다.
  • value : 셀에 쓸 숫자 값 입니다.


예)

# 이름으로 지정

excel.setValue('Sheet3','B','5', 3)

# 인덱스로 지정

excel.setValue(1,2,6, 4)

# 이름, 인덱스를 혼합해 지정

excel.setValue('Sheet3','B',7, 5)

결과)


 setValue ( colum, row , value)

행 , 열을 지정해 첫 번째 WorkSheet의 셀에 숫자를 씁니다.


  • column :  셀의 행 이름 또는 인덱스 번호를 입력 합니다.
  • row : 셀의 열 이름 또는 인덱스 번호를 입력 합니다.
  • value : 셀에 쓸 숫자 값 입니다.


예)

# 이름으로 지정

excel.setValue('Sheet3','B','5', 3)

# 인덱스로 지정

excel.setValue(1,2,6, 4)

# 이름, 인덱스를 혼합해 지정

excel.setValue('Sheet3','B',7, 5)


결과)