<< Click to Display Table of Contents >>
Scheduler
태스크 설정 기능과 관련된 메소드를 제공하는 클래스입니다.
Constructor Detail
Scheduler
public Scheduler(string ip, int port)
보고서 스케줄 작업을 생성하고 결과 파일 및 스케줄러 관리 기능을 수행합니다.
Parameters:
ip - 오즈 스케줄러 서버가 설치되어 있는 호스트 컴퓨터의 IP
port - 스케줄러 포트(기본 값: 9521)
Method Detail
CreateTask
public string CreateTask(ServerInfo s, NameValueCollection configMap, NameValueCollection exportMap)
폼 파일을 기반으로 태스크를 생성한 후 생성된 태스크 ID를 가져옵니다. CreateTask 함수로 여러 개의 태스크 생성 시 뷰어의 대기 큐와 상관없이 실행되는 뷰어의 개수만큼 Thread와 param 파일이 생성됩니다.
Parameters:
s - 오즈 서버 정보
configMap - 스케줄러 설정 옵션(NameValueCollection 참고)
exportMap - 익스포트 정보(NameValueCollection 참고)
GetTaskInfos
public ScheduledTask[] GetTaskInfos(ServerInfo s)
현재 생성된 태스크의 결과물을 가져옵니다.
Parameters:
s - 오즈 서버 정보
GetTaskResult
public TaskResult[] GetTaskResult(ServerInfo s, string from, string to, string taskId, int rollingIndex)
롤링된 파일을 검색하여 태스크 실행 결과를 가져옵니다.
Parameters:
s - 오즈 서버 정보
from - 태스크 결과를 가져올 시작 시간
to - 태스크 결과를 가져올 종료 시간
taskId - 가져올 태스크 아이디
rollingIndex – 파일 인덱스
GetTaskResults
public TaskResult[] GetTaskResults(ServerInfo s, string from, string to, string taskId)
태스크 결과를 가져옵니다.
Parameters:
s - 오즈 서버 정보
from - 태스크 결과를 가져올 시작 시간
to - 태스크 결과를 가져올 종료 시간
taskId - 가져올 태스크 아이디
GetTaskWaitTime
public int GetTaskWaitTime(ServerInfo s, String taskId)
태스크가 대기한 시간을 가져옵니다.(단위: 초)
Parameters:
s - 오즈 서버 정보
taskId - 가져올 태스크 아이디
GetTaskWaitCount
public int GetTaskWaitCount()
실행 대기 중인 태스크 개수를 가져옵니다.
RemoveTask
public void RemoveTask(ServerInfo s, string taskId)
태스크를 삭제합니다.
Parameters:
s - 오즈 서버 정보
taskId - 삭제할 태스크 아이디
ModifyTask
public string ModifyTask(ServerInfo s, string taskId, NameValueCollection configMap, NameValueCollection exportMap)
태스크 속성을 변경합니다.
Parameters:
s - 오즈 서버 정보
taskId - 속성을 변경할 태스크 아이디
configMap - 스케줄러 설정 옵션(NameValueCollection 참고)
exportMap - 익스포트 정보(NameValueCollection 참고)
PauseTask
public void PauseTask(ServerInfo s, string taskId)
태스크를 일시 중지시킵니다.
Parameters:
s - 오즈 서버 정보
taskId - 중지할 태스크 아이디
ResumeTask
public void ResumeTask(ServerInfo s, string taskId)
중지된 태스크를 다시 실행시킵니다.
Parameters:
s - 오즈 서버 정보
taskId - 다시 실행시킬 태스크 아이디
Stop
public void Stop(ServerInfo s, bool forciblyStop)
스케줄러를 중지시킵니다.
Parameters:
s - 오즈 서버 정보
forciblyStop - 스케줄러를 강제로 중지시킬지 여부
Export
public bool Export(ServerInfo s, NameValueCollection configMap, NameValueCollection exportMap)
뷰어 파라미터를 그대로 사용하여 익스포트한 후 익스포트 성공 여부를 반환합니다.
서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할 수 있습니다.
Parameters:
s - 오즈 서버 정보
configMap - 스케줄러 설정 옵션(NameValueCollection 참고)
exportMap - 익스포트 정보(NameValueCollection 참고)
MakePDF
public bool MakePDF(ServerInfo s, NameValueCollection configMap, NameValueCollection exportMap)
스케줄러의 작업 목록에 등록하지 않고 PDF 익스포트만 수행한 후 익스포트 성공 여부를 반환합니다. 서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할 수 있습니다.
Parameters:
s - 오즈 서버 정보
configMap - 익스포트를 위한 폼 정보(NameValueCollection 참고)
exportMap - PDF 익스포트 정보(NameValueCollection 참고)
public bool Print(ServerInfo s, NameValueCollection configMap, NameValueCollection printMap)
뷰어 파라미터를 적용시켜 프린트하고 성공 여부를 반환합니다.
실제 프린트 작업의 성공 여부가 아니라 뷰어에 프린트 호출이 성공했는지 여부를 반환합니다.
"task_type=viewerTag"인 경우에만 사용될 수 있으며 이외의 값이 들어오면 무시합니다. 또한 서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할수 있습니다.
태스크 작업 주기 옵션과 관계없이 즉시 한 번만 프린트 작업을 호출하고 태스크는 생성되지 않으며, 메일 보내기 등의 파라미터를 설정하여도 메일 관련 작업은 일어나지 않고 오직 프린트만 합니다.
뷰어 파라미터에서 설정한 파라미터 중 아래의 파라미터는 항상 해당 값으로 고정되어 동작합니다.
•viewer.allowmultiframe=true
•viewer.mode=print
•viewer.printcommand=true
•viewer.showerrormessage=false
•viewer.useprogressbar=false
•print.ingnoreerror=false
•print.mode=silent
•export.confirmsave=false
•export.format=""
•information.debug=debug
Parameters:
s - 오즈 서버 정보
configMap - 스케줄러 설정 정보(NameValueCollection 참고)
printMap - 출력 정보(NameValueCollection 참고)
GetCurrentStatus
string GetCurrentStatus()
스케줄러의 사용 메모리, 전체 메모리, 실행 중인 뷰어 개수, 대기 중인 뷰어 개수를 가져옵니다.
GetConfiguration
public NameValueCollection GetConfiguration(ServerInfo s)
스케줄러 설정 값을 가져옵니다.
Parameters:
s - 오즈 서버 정보
ModifyConfiguration
public void ModifyConfiguration(ServerInfo s, NameValueCollection configMap)
스케줄러의 설정 값을 변경합니다.
Parameters:
s - 오즈 서버 정보
configMap - 스케줄러 설정 옵션(NameValueCollection 참고)
SetReceiveTimeOut
public void SetReceiveTimeOut(int timeOut)
소켓 타임 아웃을 설정합니다.(단위: 초)
Parameters:
timeOut - 소켓 타임 아웃
Ping
public bool Ping()
서버의 구동 여부를 반환합니다.
GetSchedulingInfos
public string[] GetSchedulingInfos(string path)
설정한 경로에 있는 OZS 파일 목록을 가져옵니다.
path를 파일명으로 지정하면 해당 OZS 파일 정보만 가져오며, path를 폴더명으로 지정하면 해당 폴더에 있는 모든 OZS 파일 정보를 가져옵니다. 만일 해당 경로에 파일이 존재하지 않거나 존재하지 않는 폴더를 지정하면 빈 값을 리턴합니다.
Parameters:
path - OZS 파일 목록을 가져올 경로. OZS 파일 목록을 가져올 경로는 /%SCH_HOME%/[path]/로 지정됩니다. 예를 들어 path를 sample로 설정할 경우에는 /%SCH_HOME%/sample/에 있는 OZS 파일 목록을 가져옵니다.
ConvertSchedulingInfos
public void ConvertSchedulingInfos(string oldPath, string newPath)
2.5 버전의 OZS 파일을 최신 버전으로 변경하여 저장합니다.
Parameters:
oldPath - 변환할 OZS 파일명 또는 경로. 해당 경로는 /%SCH_HOME%/[oldPath]/입니다.
newPath - 변환된 OZS 파일 저장 경로. 해당 경로는 /%SCH_HOME%/[newPath]/이며 newPath는 oldPath와 다르게 설정하여야 합니다.
AddTaskHoliday
public bool AddTaskHoliday(TaskHolidayInfo value)
태스크 휴일 정보를 추가합니다.
Parameters:
value - 태스크 휴일 정보
ModifyTaskHoliday
public bool ModifyTaskHoliday(string old_key, TaskHolidayInfo new_value)
태스크 휴일 정보를 수정합니다.
Parameters:
old_key - 수정할 태스크 휴일 이름
new_value - 새로운 태스크 휴일 정보
DeleteTaskHoliday
public bool DeleteTaskHoliday(string[] keys)
태스크 휴일 정보를 삭제합니다.
Parameters:
keys - 삭제할 태스크 휴일 이름 배열
AddTaskHolidayGroup
public bool AddTaskHolidayGroup(TaskHolidayGroupInfo value)
태스크 휴일 그룹 정보를 추가합니다.
Parameters:
value - 태스크 휴일 그룹 정보
ModifyTaskHolidayGroup
public bool ModifyTaskHolidayGroup(string old_key, TaskHolidayGroupInfo new_value)
태스크 휴일 그룹 정보를 수정합니다.
Parameters:
old_key - 수정할 태스크 휴일 그룹 이름
new_value - 새로운 태스크 휴일 그룹 정보
DeleteTaskHolidayGroup
public bool DeleteTaskHolidayGroup(string key)
태스크 휴일 그룹 정보를 삭제합니다.
Parameters:
key - 삭제할 태스크 휴일 그룹 이름
GetTaskHolidayInfos
public TaskHolidayInfos GetTaskHolidayInfos()
태스크 휴일 정보 목록을 가져옵니다.
GetTaskHolidayGroupInfos
public TaskHolidayGroupInfos GetTaskHolidayGroupInfos()
태스크 휴일 그룹 정보 목록을 가져옵니다.
SaveTaskHoliday
public void SaveTaskHoliday()
태스크 휴일 정보를 xml 파일로 저장합니다.
DirectExport
public DirectExportResult DirectExport(ServerInfo s, NameValueCollection configMap, NameValuecollection exportMap)
뷰어 파라미터를 적용시켜 익스포트한 후 결과 정보를 반환합니다.
서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할 수 있습니다.
Parameters:
s - 오즈 서버 정보
configMap - 스케줄러 설정 옵션(NameValueCollection 참고)
exportMap - 익스포트 정보(NameValueCollection 참고)
DirectExportFiles
public Hashtable[] DirectExportFiles(ServerInfo s, NameValueCollection properties, NameValuecollection exportProperties, string localTempPath)
뷰어 파라미터를 적용시켜 익스포트한 결과를 로컬 임시 경로에 저장한 후 파일 정보를 반환합니다.
서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할 수 있습니다.
Parameters:
s - 오즈 서버 정보
properties - 스케줄러 설정 옵션(NameValueCollection 참고)
exportProperties - 익스포트 정보(NameValueCollection 참고)
localTempPath - 익스포트한 결과를 저장할 로컬 임시 경로
DirectExportResult
public DirectExportResult DirectExportResult(ServerInfo s, NameValueCollection properties, NameValuecollection exportProperties)
뷰어 파라미터를 적용시켜 익스포트한 후 결과 정보를 반환합니다.
서버에 설정된 스케줄러의 환경 설정 중 task_type이 viewerTag이고, ViewerType이 ActiveX 또는 Applet인 경우에만 사용할 수 있습니다.
Parameters:
s - 오즈 서버 정보
properties -스케줄러 설정 옵션(NameValueCollection 참고)
exportProperties - 익스포트 정보(NameValueCollection 참고)
DirectExportByteArray
public HashTable DirectExportByteArray(ServerInfo s, NameValueCollection configProperties, NameValueCollection exportProperties)
태스크를 실행한 후 실행 결과 정보를 반환합니다.
태스크 실행 결과를 파일로 저장하지 않고, 메모리로 익스포트하려면 ude.classname을 설정한 후 ViewerType=Applet, export_file=false로 설정하시기 바랍니다.
서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할 수 있습니다.
Parameters:
s - 오즈 서버 정보
configProperties - 스케줄러 설정 옵션(NameValueCollection 참고)
exportProperties - 익스포트 정보(NameValueCollection 참고)
DirectPrint
public DirectPrintResult DirectPrint(ServerInfo s, NameValueCollection configMap, NameValuecollection printMap)
뷰어 파라미터를 적용시켜 프린트하고 결과 정보를 반환합니다.
"task_type=viewerTag"인 경우에만 사용될 수 있으며 이외의 값이 들어오면 무시합니다. 또한 서버에 설정된 스케줄러의 환경 설정 중 "ViewerType=None"이 아닌 경우에만 사용할수 있습니다.
Parameters:
s - 오즈 서버 정보
configMap - 스케줄러 설정 옵션(NameValueCollection 참고)
printMap - 출력 정보. print.mode = silent로만 실행됩니다.(NameValueCollection 참고)
GetFile
public void GetFile(ServerInfo s, string fileName, string targetFile)
파일을 가져옵니다.
Parameters:
s - 오즈 서버 정보
fileName - 가져올 파일명
targetFile - 저장할 파일 명
GetTaskProperties
public void GetTaskProperites(ServerInfo s, string TaskID, NameValueCollection configMap, NameValueCollection exportMap)
태스크의 속성 즉 스케줄러에서 태스크를 생성할 때 사용되는 설정 옵션(configMap)과 스케줄러에서 익스포트되는 파일의 설정 옵션을 가져옵니다.
Parameters:
s - 오즈 서버 정보
taskID - 속성을 가져올 태스크 아이디
configMap - 익스포트를 위한 폼 정보(NameValueCollection 참고)
exportMap - PDF 익스포트 정보(NameValueCollection 참고)