11.3 관련 기능

본 항목에서는 레시피 기능에서 자주 쓰이는 함수(Function) 및 서브루틴(Subroutine)을 확인할 수 있습니다. 활용할 수 있는 함수 및 서브루틴은 다음 표를 참조하여 주시기 바랍니다. 각 함수 및 서브루틴의 자세한 사항은 각 항을 참조하여 주시기 바랍니다.

스크립트 상에서 함수와 서브루틴을 입력할 시, 함수의 경우 출력되는 값이 존재하므로 반드시 괄호를 포함하여야 합니다. 서브루틴의 경우에는 괄호를 사용하지 않습니다.
명령식으로 함수와 서브루틴을 사용할 경우, 두 식 모두 괄호를 사용하여 입력하여야 합니다.
스크립트 상에서는 반드시 함수와 서브루틴을 구별하여 입력하여야 합니다.

명령어			설명
제어 화면	서브루틴	RecipeDialog	웹 브라우저에서 레시피 제어화면을 나타냅니다.
	서브루틴	RecipeDownload	레시피 제어화면에서 [쓰기]에 해당하는 기능으로, 해당되는 태그 그룹의 레시피 데이터를 다운로드합니다.
	서브루틴	RecipeUpload	레시피 제어화면에서 [읽기]에 해당하는 기능으로, 해당되는 태그 그룹에 속한 태그의 값을 레시피 내로 업로드합니다.
	함수	RecipeGetData	현재 레시피 내에 있는 해당 레시피 모델의 필드 값을 출력합니다.
	서브루틴	RecipeSetData	해당 레시피 모델의 필드에 특정한 설정값을 입력합니다.
	서브루틴	RecipeLoad	레시피 제어화면에서 [열기]에 해당하는 기능으로, 레시피 파일에 저장된 레시피 설정값들을 불러옵니다.
	서브루틴	RecipeSave	레시피 제어화면에서 [저장]에 해당하는 기능으로, 설정한 레시피 데이터를 저장합니다.

명령어 설명

RecipeDialog	CimonX 실행모드에서 레시피 제어화면을 나타냅니다.
서브루틴명	명령식 표기	RecipeDialog()
	스크립트 표기	RecipeDialog
기능	웹브라우저를 통해 서버에 접속하였을 때, 해당 명령식을 사용하여 레시피 제어 화면을 나타낼 수 있습니다. 레시피 제어 화면에서는 현재 레시피 모델에 설정되어 있는 값을 확인할 수 있으며, 설정 값을 저장하거나 변경할 수 있습니다.
사용 예제	명령식으로 제어화면을 나타냅니다. RecipeDialog()

항목	설명
모델 이름	레시피 모델을 선택합니다.
태그 그룹	선택한 모델의 태그 그룹을 선택합니다.
쓰기	연결된 태그의 값에 레시피의 설정 값을 적용합니다. 태그가 실태그로 지정되었을 경우, 연결된 PLC에 설정 값을 다운로드합니다.
읽기	연결된 태그의 값을 레시피의 설정 값으로 불러옵니다.
저장/불러오기	레시피 설정 값을 저장하거나 불러옵니다.
	생산 이력 이름	저장된 생산 이력 이름을 표시합니다.
	주석	생산 이력에 대한 설명을 입력합니다.
	불러오기	선택한 생산이력의 설정 값을 해당 레시피로 불러옵니다.
	저장	설정된 레시피 값을 가진 생산 이력을 Historian DB저장합니다.
	취소	생산이력 저장을 취소합니다.
	삭제	선택한 생산이력을 삭제합니다.

RecipeDownload	해당 태그 그룹의 레시피 데이터를 다운로드합니다.
서브루틴명	명령식 표기	RecipeDownload (“모델 이름”, “태그 그룹 이름”)
	스크립트 표기	RecipeDownload “모델 이름”, “태그 그룹 이름”
기능	레시피 제어화면에서 [쓰기]에 해당하는 기능으로, 해당되는 태그 그룹의 레시피 데이터를 PLC(실태그로 지정된 경우)로 다운로드합니다.
사용 예제	“사료” 모델의 태그 그룹 “닭”의 데이터 값을 PLC로 다운로드하는 예제 RecipeDownLoad(“RecipeModel1”, “TagGroup1”)

RecipeUpload	해당 태그 그룹에 속한 태그의 값을 레시피 메모리로 업로드합니다.
서브루틴명	명령식 표기	RecipeUpload(“모델 이름”, “태그 그룹 이름”)
	스크립트 표기	RecipeUpload “모델 이름”, “태그 그룹 이름”
기능	레시피 제어화면에서 [읽기]에 해당하는 기능으로, 해당 모델의 태그 그룹에 연결된 태그의 값을 레시피 설정 값으로 불러옵니다.
사용 예제	태그 그룹 “닭”에 연결된 태그의 값을 “사료” 모델의 레시피 설정값으로 불러오는 예제 RecipeUpLoad(“RecipeModel1”, “TagGroup1”)

RecipeGetData	해당 모델의 필드 값을 태그에 반영합니다.
함수명	연산식 표기	RecipeGetData (“모델 이름”, “필드 이름”)
	스크립트 표기	n = RecipeGetData (“모델 이름”, “필드 이름”)
기능	현재 레시피 메모리에 있는 해당 레시피 모델 내 필드의 값을 반영합니다. 이 함수를 명령식으로 이용할 때는 A1 = RecipeGetData(“사료”, “귀리”)와 같이 가져온 데이터의 값이 저장된 태그를 지정하여야 합니다.
사용 예제	“사료” 모델의 “귀리” 필드 값에 저장되어 있는 레시피 메모리를 닭. 귀리 태그에 반영하는 예제 닭. 귀리 = RecipeGetData(“사료”, “귀리”)

RecipeSetData	해당 모델의 필드에 특정 값을 입력합니다.
서브루틴명	명령식 표기	RecipeSetData(“모델 이름”, “필드 이름”, 설정값)
	스크립트 표기	RecipeSetData “모델 이름”, “필드 이름”, 설정값
기능	해당 레시피 모델의 필드에 특정한 설정 값을 입력합니다. 이 때의 결과는 메모리의 값만 바뀌므로, RecipeSetData 함수로 설정 값을 입력한 뒤에는 RecipeDownload 함수를 사용하여야 실제 태그에 값이 쓰여집니다.
사용 예제	“사료” 모델의 “귀리” 필드에 100을 입력하는 예제 RecipeSetData(“사료”, “귀리”, 100)

RecipeLoad	해당 생산 이력으로부터 레시피 설정 값을 읽어옵니다.
서브루틴명	명령식 표기	RecipeLoad(“모델 이름”, “생산 이력 이름”)
	스크립트 표기	RecipeLoad “모델 이름”, “생산 이력 이름”
기능	레시피 제어화면에서 [열기]에 해당하는 기능으로, 해당 생산 이력으로부터 레시피 설정 값을 읽어와 화면에 표시합니다.
사용 예제	“돼지 사료” 생산 이력에 저장된 레시피 설정 값을 “사료” 모델에 불러오는 예제 RecipeLoad(“사료”, “돼지 사료”)

RecipeSave	해당 레시피 설정 값을 원하는 생산이력으로 저장합니다.
서브루틴명	명령식 표기	RecipeSave(“모델 이름”, “이력 이름”, ”주석”)
	스크립트 표기	RecipeSave “모델 이름”, “이력 이름”, ”주석”
기능	레시피 제어화면에서 [저장]에 해당하는 기능으로, 화면에 표시된 레시피 설정 값을 지정한 이름으로 저장합니다.
사용 예제	“사료” 모델에 불러온 레시피 설장값을 “돼지 사료_20240131” 에 저장하는 예제 RecipeSave(“사료”, “돼지 사료_20240131”,”2024년 돼지사료 값”)