excel 개체는 일반적으로 Excel 문서에서 사용자가 지정할 셀의 값을 읽어오거나 값을 셀에 쓸때 사용합니다. 사용자는 excel 개체를 이용해 운영중 발생한 값이나 기타 정보를 엑셀 파일로 저장할 수 있으며, 반대로 엑셀 파일로 저장된 값을 읽어 올 때 사용할 수 있습니다.

Methods


리턴 값

함 수

설 명


close()

작업 중인 엑셀 파일을 닫습니다.

str

errorMessage()

엑셀 파일 열기 또는 저장 실패 시 에러 메시지를 확인할 수 있습니다.

  str

getStringValue( sheet, column, row )

엑셀 파일의 시트(sheet), 컬럼(column), 행(row)을 입력하면 값을 문자열로 가져옵니다.

int or float

getValue( sheet, column, row )

엑셀 파일의 시트(sheet), 컬럼(column), 행(row)을 입력하면 값을 숫자로 가져옵니다.

boolean

open( path )

입력한 경로의 엑셀 파일을 불러옵니다.

boolean

save( path )

입력한 경로에 엑셀 파일을 저장합니다.


setStringValue( sheet, column, row, value )

입력한 문자열을 엑셀 파일의 시트(sheet), 컬럼(column), 행(row) 위치에 설정합니다.


setValue( sheet, column, row, value )

입력한 숫자를 엑셀 파일의 시트(sheet), 컬럼(column), 행(row) 위치에 설정합니다.



 

 boolean open( path:엑셀 파일 경로 )

 

 path에 입력한 경로의 엑셀 파일을 불러옵니다.


  • path에는 파일 경로를 문자열로 입력합니다.
    • 불러올 엑셀 파일이 프로젝트 내에 있을 경우 : 확장자를 포함한 엑셀 파일명을 입력합니다.

                        예) 프로젝트 내에 있는 'test.xls'을 불러올 경우 : 'test.xls'을 입력합니다.

    • 불러올 엑셀 파일이 프로젝트 내에 없을 경우 : 엑셀 파일의 전체 경로를 입력합니다.

                        예) 'C:\\'에 있는 'test.xls'을 불러올 경우 : 전체 경로인 'C:\\test.xls'을 입력합니다.

  • 파일 열기 성공 시 참(True)이 반환되고 실패할 경우 거짓(False)이 반환됩니다.
    • 파일 열기 성공 시 : True(1)
    • 파일 열기 실패 시 : False(0)


 예)

# 'c:\\' 경로에 있는 'test.xls'파일을 엽니다.

excel.open('c:\\test.xls')  



 

 boolean save( path:엑셀 파일 경로 )

 

 path에 입력한 경로에 작업중인 엑셀 파일를 저장합니다.


  • path에는 파일 경로를 문자열로 입력합니다.
    • 불러올 엑셀 파일이 프로젝트 내에 있을 경우 : 확장자를 포함한 엑셀 파일명을 입력합니다.

                        예) 프로젝트 내에 있는 'test.xls'을 불러올 경우 : 'test.xls'을 입력합니다.

    • 불러올 엑셀 파일이 프로젝트 내에 없을 경우 : 엑셀 파일의 전체 경로를 입력합니다.

                        예) 'C:\\'에 있는 'test.xls'을 불러올 경우 : 전체 경로인 'C:\\test.xls'을 입력합니다.

  • 파일 저장 성공 시 참(True)이 반환되고 실패할 경우 거짓(False)이 반환됩니다.
    • 파일 저장 성공 시 : True(1)
    • 파일 저장 실패 시 : False(0)


open 함수와 save 함수에 입력하는 파일 확장자를 동일하게 입력해야 합니다.


save 함수에 엑셀 파일 경로를 입력할 때 open함수에 입력한 경로와 동일하게 입력할 경우 엑셀 파일이 덮어쓰기가 되어 원본 파일의 데이터가 사라질 수 있습니다.


 예)

# open함수와 save함수의 파일 확장자를 동일하게 입력합니다.


# 확장자가 '.xls'인 경우

excel.open('c:\\test.xls')

excel.save('d:\\test_save.xls')


# 확장자가 '.xlsx'인 경우

excel.open('c:\\test.xlsx')

excel.save('d:\\test_save.xlsx')



 

 close()

 

 close 함수는 작업중인 엑셀 파일을 닫습니다.


 예)

# 작업중인 엑셀 파일을 닫습니다.

excel.close()  



 

 int or float getValue( sheet:시트 이름, column:컬럼 이름, row:행 이름 )

 

 getValue 함수는 작업중인 엑셀 파일에서 참조를 원하는 시트와 컬럼, 행을 입력하면 해당 값을 숫자로 가져옵니다.


  • sheet(시트) 에는 작업중인 엑셀 파일의 시트 이름을 입력해야 합니다.
  • column(컬럼) 에는 해당 시트의 컬럼 문자를 입력해야 합니다.
  • row(행) 에는 해당 시트의 행 숫자를 문자로 입력해야 합니다.


getValue 함수를 사용하여 문자 또는 문자열을 가져올 경우 0이 반환됩니다.


 예)

# 'c:\\' 경로에 있는 'test.xls'파일을 엽니다.

excel.open('C:\\test.xls')  


# Sheet1의 A3 셀 값을 가져옵니다.

v1 = excel.getValue('Sheet1', 'A', '3')  

# Sheet1의 E5 셀 값을 가져옵니다.

v2 = excel.getValue('Sheet1', 'E', '5')  



 

 str getStringValue( sheet:시트 이름, column:컬럼 이름, row:행 이름 )

 

 getStringValue 함수는 작업중인 엑셀 파일에서 참조를 원하는 시트와 컬럼, 행을 입력하면 해당 값을 문자열으로 가져옵니다.


  • sheet(시트) 에는 작업중인 엑셀 파일의 시트 이름을 입력해야 합니다.
  • column(컬럼) 에는 해당 시트의 컬럼 문자를 입력해야 합니다.
  • row(행) 에는 해당 시트의 행 숫자를 문자로 입력해야 합니다.


 예)

# 'c:\\' 경로에 있는 'test.xls'파일을 엽니다.

excel.open('C:\\test.xls')  

       

# Sheet1의 A3 셀 값을 문자열로 가져옵니다.

v1 = excel.getStringValue('Sheet1', 'A', '3')  

# Sheet1의 E5 셀 값을 문자열로 가져옵니다.

v2 = excel.getStringValue('Sheet1', 'E', '5')  



 

 setValue( sheet:시트 이름, column:컬럼 이름, row:행 이름, value:숫자 )

 

 setValue 함수는 작업중인 엑셀 파일에서 선택한 위치(시트, 컬럼, 행) 위치에 값을 입력합니다.


  • sheet(시트) 에는 작업중인 엑셀 파일의 시트 이름을 입력해야 합니다.
  • column(컬럼) 에는 해당 시트의 컬럼 문자를 입력해야 합니다.
  • row(행) 에는 해당 시트의 행 숫자를 문자로 입력해야 합니다.
  • value 에는 설정을 원하는 숫자값을 입력해야 합니다.


 예)

# 'c:\\' 경로에 있는 'test.xlsx'파일을 엽니다.

excel.open('C:\\test.xlsx')  


# 아날로그 포인트 '분산전원 감시 시스템.태양광 전체 발전량'의 값을 가져옵니다.

p = scada.getAnalogValue('분산전원 감시 시스템.태양광 전체 발전량') 


# Sheet1의 B3 셀에 아날로그포인트 p값을 설정합니다.

excel.setValue('Sheet1', 'B', '3', p)


 


 

 setStringValue( sheet:시트 이름, column:컬럼 이름, row:행 이름, value:문자열 )

 

 setValue 함수는 작업중인 엑셀 파일에서 선택한 위치(시트,컬럼,행) 위치에 값을 입력합니다.


  • sheet(시트) 에는 작업중인 엑셀 파일의 시트 이름을 입력해야 합니다.
  • column(컬럼) 에는 해당 시트의 컬럼 문자를 입력해야 합니다.
  • row(행) 에는 해당 시트의 행 숫자를 문자로 입력해야 합니다.
  • value 에는 설정을 원하는 문자열를 입력해야 합니다.


 예)

# 'c:\\' 경로에 있는 'test.xlsx'파일을 엽니다.

excel.open('C:\\test.xlsx')  


# Sheet1의 B2 셀에 문자열 '태양광 전체 발전량'을 설정합니다.

excel.setStringValue('Sheet1', 'B', '2', '태양광 전체 발전량')


 


 

 str errorMessage()

 

 엑셀 파일 열기 또는 저장 실패 시 에러 메시지를 확인할 수 있습니다.


 예) 엑셀 파일 열기에 실패한 경우

# 'c:\\' 경로에 있는 'test.xlsx'파일을 엽니다.

open = excel.open('C:\\test.xlsx')  


# 파일 열기 실패 시 에러 메시지를 통해 실패 원인을 확인할 수 있습니다.

if( open == 0 ):

    openError = excel.errorMessage();

    # 메시지 박스에 에러 메시지를 출력합니다.

    app.messageBox('파일 열기 실패', openError);