스크립트 모음(스크립트 라이브러리) 생성

VisualApplets는 Script Collection 기능을 제공하며, 이를 통해 스크립트 절차를 VisualApplets GUI에서 직접 매우 편리하게 사용할 수 있습니다. VisualApplets는 Script Collection 내에서 Tcl 스크립트와 Python 스크립트를 지원합니다.

첫 번째 단계로, 개별 명령어가 포함된 스크립트 컬렉션을 생성합니다. 지정된 Tcl 또는 Python 스크립트에서 특정 프로시저를 호출하도록 각 명령어를 정의합니다.

그 후 개별 명령어를 VisualApplets GUI에서 그래픽 방식으로 직접 사용할 수 있으며, 마우스 클릭이나 드래그 앤 드롭을 통해 실행할 수 있습니다. 이 방법을 통해 Tcl 또는 Python 절차를 라이브러리 요소로 활용할 수 있습니다. 호출된 명령어는 Scripting Console에서 실행됩니다. Scripting Console을 열면 명령어 실행 과정을 확인할 수 있습니다.

Script Collection 창에서 VisualApplets 설치에 이미 포함된 스크립트 모음과 각 모음에 포함된 명령어를 확인할 수 있습니다.

Script Collection 창을 열려면 Window 메뉴를 열고 Dock Windows를 선택한 다음 Scripting Collection을 선택합니다:

VisualApplets 메인 창의 오른쪽에 Scrip Collection 창이 열립니다:

다음과 같은 방법으로 스크립트 컬렉션을 정의할 수 있습니다:

• VisualApplets GUI 사용 또는
• 스크립트 모음을 정의하는 XML 파일 생성/편집.

정보

VisualApplets는 Python 및 Tcl로 작성된 스크립트에 대한 스크립트 모음을 지원합니다. Scripting Console은 Python 스크립트 모음 요소를 사용할 때 자동으로 Python으로 전환되며, 콘솔이 Tcl로 설정되면 다시 Tcl로 전환됩니다. Python 스크립트 모음은 Python Version Settings 대화상자에서 Active Version으로 선택된 Python 환경에서 실행됩니다. 자세한 내용은 Managing Python Versions를 참조하십시오.

정보

모든 컬렉션 정보를 XML 파일에 저장하면 개별 스크립트뿐만 아니라 스크립트 컬렉션의 구조 및 콘텐츠 정의에도 버전 관리 시스템을 사용할 수 있습니다.

스크립트 모음 구조

각 스크립트 컬렉션에는 여러 개의 명령어(스크립트 컬렉션의 요소)가 포함되어 있습니다.

이는 GUI에 다음과 같이 반영됩니다.

각 명령어는 특정 스크립트 내의 하나의 특정 프로시저를 가리킵니다. 명령어가 수행되면 그가 가리키는 프로시저가 호출됩니다.

스크립트 컬렉션을 정의하려면 다음을 정의해야 합니다.

• 컬렉션의 이름
• 컬렉션에 포함된 명령어
• 선택 사항: 버전 번호, 설명 등 기타 추가 정보
• 선택 사항: 스크립트 모음을 나타내는 GUI 아이콘입니다.
• 개별 명령별 항목:
  • 명령 이름
  • 명령이 가리키는 Tcl 또는 Python 파일입니다.
  • 명령이 가리키는 이 파일 내의 Tcl 또는 Python 프로시저입니다.
  • Tcl 또는 Python 프로시저에 전달해야 하는 인수(GUI에서 명령을 시작할 때 필요한 값이 프롬프트로 표시됨)
  • 명령 모드(아래의 Adding a Command to a Script Collection 참조)
  • 선택 사항: Command scope (아래의 Adding a Command to a Script Collection 참조)
  • 선택 사항: 버전 번호, 설명 등 추가 정보입니다.
  • 선택 사항: 명령을 나타내는 GUI 아이콘 (아래의 Adding a Command to a Script Collection 참조). 아이콘 파일을 제공하지 않으면 GUI에서 기본 아이콘이 사용됩니다.

단 하나의 스크립트 컬렉션을 설명하는 나열된 모든 정보는 하나의 XML 파일에 저장됩니다.

여러 스크립트 모음을 정의할 수 있습니다.

GUI 백그라운드에서 실행되는 작업

백그라운드에서 컬렉션 정의 XML 파일을 위해 지정한 디렉토리에 새로운 XML 파일이 생성됩니다(Required Settings 참조):

파일 이름은 GUI에서 정의한 스크립트 모음 이름과 같습니다. XML 파일에는 현재 정의된 모음에 대한 모든 정보가 포함되어 있습니다.

As you haven't specified any commands for your script collection yet, the <Elements> element is still empty.

정보

새로운 스크립트 컬렉션을 생성하려면 GUI를 사용하거나 처음부터 XML 파일을 생성할 수 있습니다. 결과는 동일합니다. GUI는 항상 XML 파일에 정의된 정보를 표시합니다.

명령어 옵션

명령을 정의할 때 버튼을 통해 명령을 시작할 수 있는지 여부를 정의할 수 있습니다 (즉, Trigger Mode) 또는 드래그 앤 드롭을 통해 시작할 수 있으며, 이는 GUI에 손 모양 아이콘으로 표시됩니다 . 명령에 대한 버튼을 툴바에 추가할 수도 있습니다.

Trigger Mode로 설정된 명령의 경우 command scope를 정의할 수 있습니다. Command scope에서는 명령이 특정 요소에만 적용되도록 특정 디자인 요소(예: 모듈 또는 링크)로 제한할 수 있습니다.

요구 사항

파일 요구 사항

스크립트 컬렉션은 다음 파일로 구성됩니다.

• 스크립트 모음을 정의하는 XML 파일입니다. XML 파일에는 모음 자체의 정의와 모음에 포함된 명령의 정의가 포함되어 있습니다.
• 실제 스크립트가 포함된 Tcl 또는 Python 파일입니다. 이러한 파일은 다음 요구 사항을 충족해야 합니다.
  • Tcl 또는 Python 스크립트입니다.
  • 이 파일에는 프로시저만 포함됩니다. 스크립트 파일을 로드할 때 실행되는 명령은 포함되어 있지 않습니다.
  • 명령 CMD_NAME의 이름 충돌을 방지하려면 다음 명명 규칙을 준수하십시오:
    • Command_CMD_NAME
  • .tcl 또는 .py 파일을 컬렉션 파일(*.xml)과 동일한 디렉토리 또는 그 하위 디렉토리에 저장합니다.
• 선택 사항: VA GUI의 개별 모음 또는 명령 아이콘을 위한 PNG 아이콘 파일입니다. PNG 파일은 다음 요구 사항을 충족해야 합니다.
  • 정사각형 이미지를 포함해야 합니다.
  • 최소 해상도는 16 x 16입니다.
  • 아이콘 파일은 컬렉션 파일(*.xml)과 동일한 디렉토리 또는 그 하위 디렉토리에 저장합니다. 아이콘 파일을 제공하지 않으면 GUI에서 명령을 나타내는 데 기본 아이콘이 사용됩니다.

정보

작동하는 스크립트 컬렉션에 필요한 모든 파일은 일반 텍스트 파일입니다. 이를 통해 스크립트 컬렉션 정의를 버전 관리 시스템에 저장할 수 있습니다.

필수 설정

VisualApplets에서 스크립트 모음 정의 파일(XML 파일)의 위치를 지정할 수 있습니다. 모음 스크립트 파일의 저장 위치는 하나만 정의할 수 있으므로, Basler에서는 모음을 정의하는 모든 XML 파일을 동일한 디렉터리에 저장할 것을 권장합니다.

스크립트 모음 디렉터리 경로를 설정하려면:

1. Settings 메뉴에서 System Settings를 선택합니다.
2. Paths 탭을 선택합니다.
3. Under Script Collection, specify the path to the directory where you store the collection-defining XML files you want to use. The default setting is <VA installation directory>/ScriptCollection:

GUI를 통해 생성하는 각 스크립트 컬렉션에 대해 하나의 XML 파일이 지정된 디렉토리에 기록됩니다. 새로운 컬렉션 설명 XML 파일을 디렉토리에 추가하거나 거기에 저장된 기존 XML 파일을 편집하는 경우, VisualApplets GUI에서 변경 사항을 적용할 수 있습니다. VisualApplets를 다시 시작하지 않고 변경 사항을 표시하려면 Script Collection 창을 마우스 우클릭하고 Rescan Script Collection Directory를 선택합니다.

GUI를 통한 스크립트 모음 생성

기본 XML 파일을 직접 수정하지 않고 GUI를 통해 스크립트 모음을 완전히 정의할 수 있습니다. XML 파일은 백그라운드에서 생성 및 업데이트됩니다. 모음과 포함된 명령을 정의하면 즉시 VisualApplets GUI에 모음이 표시됩니다.

새 스크립트 모음 생성

그래픽 사용자 인터페이스를 통해 새 스크립트 모음을 생성하려면:

1. Script Collection 창을 마우스 우클릭합니다.

2. 컨텍스트 메뉴에서 Create New Script Collection을 선택합니다.

   

   대화 상자가 열립니다.

3. 새 스크립트 컬렉션의 이름을 입력하고 OK로 확인합니다.

   

   새 컬렉션이 Script Collection 창에 표시됩니다.

   

스크립트 모음에 명령어 추가

GUI를 통해 스크립트 컬렉션에 명령을 추가하려면:

1. 스크립트 컬렉션 이름을 마우스 우클릭합니다.

2. 컨텍스트 메뉴에서 Create Element를 선택합니다.

   

   추가하려는 명령을 설명하기 위한 대화상자가 열립니다. 빨간색으로 강조 표시된 필드는 필수 입력 항목입니다.

   

3. Command Name(필수): 명령의 이름을 지정합니다.

4. Version: 명령의 버전 정보를 제공할 수 있습니다.
5. Description: 설명은 툴팁 정보로 표시됩니다. 명령이 호출할 프로시저에 대한 설명을 입력합니다.
6. Icon File: Script Collection 창이나 도구 모음에 특정 명령 아이콘이 표시되도록 하려면 여기에 아이콘 파일의 경로를 지정할 수 있습니다. 절대 경로 또는 컬렉션 파일(*.xml)을 기준으로 한 상대 경로를 설정할 수 있습니다(자세한 내용은 File Requirements 참조). 아이콘 파일을 선택하지 않으면 기본 아이콘이 GUI에서 새 명령을 나타내는 데 사용됩니다.

7. Script File: 명령을 통해 시작하려는 프로시저가 포함된 스크립트의 경로와 이름을 제공합니다. 컬렉션 파일(.xml)을 기준으로 경로를 정의할 수 있습니다. 또는 명령이 호출할 프로시저가 포함된 스크립트 파일을 정의하는 대신, Tcl 또는 Python 프로시저를 명령에 직접 입력할 수 있습니다. 명령에 직접 정의된 Tcl 또는 Python 프로시저는 명령을 호출할 때마다 실행됩니다. 이 옵션을 선호하는 경우 Script File 필드를 비워 두고 Command Call 아래의 Template 필드에 명령이 나타내는 전체 Tcl 또는 Python 프로시저를 제공하십시오.

   

   명령 범위로 정의된 디자인 요소를 선택하지 않고 명령을 실행하려고 하면 Invalid Scope 메시지가 나타납니다.

   

8. Command Options: VisualApplets GUI에서 명령을 시작하는 방식을 정의합니다. 명령은 버튼 클릭(trigger mode) 또는 디자인 창으로의 드래그 앤 드롭(Drag & Drop mode)을 통해 시작할 수 있습니다. trigger mode를 사용하는 경우 프로그램 창의 도구 모음에 명령에 대한 추가 버튼을 추가하고 명령이 실행되는 조건(범위)을 정의할 수 있습니다.

   

   1. Trigger mode: 클릭하는 즉시 명령을 시작하는 버튼을 만들려면 Drag & Drop 필드를 지웁니다. 명령이 Run 버튼과 함께 Script Collection 창에 표시됩니다.

      

      명령 실행을 시작하려면 Run 버튼을 클릭합니다.

   2. 도구 모음 옵션(trigger mode 전용): VisualApplets의 도구 모음에서 명령을 사용할 수 있도록 하려면 Add to Toolbar 옵션을 선택합니다. 이는 Drag & Drop 확인란의 선택을 해제한 경우에만 가능합니다. GUI에서 컬렉션을 위한 새 도구 모음이 생성되고 명령 아이콘이 표시됩니다.

      

      도구 모음에서 명령 아이콘을 클릭하는 것은 Run 버튼을 클릭하는 것과 동일한 효과를 냅니다. 그러면 Description 아래에 입력한 텍스트가 도구 모음의 툴팁으로 표시됩니다.

      

   3. Drag & Drop mode: GUI에서 드래그 앤 드롭 작업을 통해 실행을 시작하려면 Drag & Drop 확인란을 선택합니다. 이 경우 Action 열에 손 모양 아이콘이 표시됩니다.

      

9. Define Command Scope(trigger mode에서만 사용 가능): 디자인에서 명령을 특정 디자인 요소로 제한하려면 Define Command Scope 확인란을 선택합니다. 이 옵션은 Drag & Drop이 비활성화된 경우에만 사용할 수 있습니다.

   

   사용 가능한 옵션은 다음과 같습니다.

   • Module: 이 명령을 시작하려면 정확히 하나의 모듈을 선택해야 합니다.
   • Link: 이 명령을 시작하려면 정확히 하나의 링크를 선택해야 합니다.
   • CommentBox: 이 명령을 시작하려면 정확히 하나의 코멘트 박스를 선택해야 합니다.
   • SimModule: 이 명령을 시작하려면 정확히 하나의 시뮬레이션 모듈을 선택해야 합니다.
   • SingleSelect: 이 명령을 시작하려면 정확히 하나의 디자인 요소를 선택해야 합니다. 어떤 종류의 요소를 선택하든 상관없습니다(모듈, 링크 등).
   • MultiSelect: 이 명령을 시작하려면 둘 이상의 디자인 요소를 선택해야 합니다. 어떤 종류의 요소를 선택하든 상관없습니다(모듈, 링크 등).

   이 옵션들을 조합할 수 있습니다. 예를 들어 Module과 Link 옵션을 조합하면 정확히 하나의 모듈 또는 정확히 하나의 링크를 선택했을 때 명령이 실행됩니다. SingleSelect와 MultiSelect를 조합하면 하나 이상의 디자인 요소가 선택된 경우 명령을 시작할 수 있습니다.

   명령의 스코프(즉, Tcl 프로시저의 스코프)는 VA GUI의 Script Collection 창에 표시됩니다.

   

   명령 범위로 정의된 디자인 요소를 선택하지 않고 명령을 실행하려고 하면 Invalid Scope 메시지가 나타납니다.

   

10. Command Call: 명령이 호출되는 방식을 여기서 정의합니다.

    

    1. Template: 명령 호출을 위한 템플릿을 여기에 입력합니다. 일반적으로 Tcl 또는 Python 프로시저 이름으로 시작하고 그 뒤에 매개변수 목록이 옵니다. 매개변수는 %로 둘러싸인 자리표시자로 지정됩니다. 각 자리표시자에 대해 아래 목록에서 해당 매개변수를 정의합니다. Tcl 또는 Python 명령의 구문을 따르십시오. 또는 위의 Script File 필드를 비워둔 경우 완전한 Tcl 또는 Python 콘솔 명령 라인을 여기에 입력할 수 있습니다.
    2. Parameters: 템플릿에 사용되는 매개변수를 여기서 정의합니다. 여기에 나열된 매개변수의 순서는 중요하지 않습니다. 매개변수 이름이 템플릿의 자리표시자 이름과 일치하는지 확인하기만 하면 됩니다. 명령 정의에 새 매개변수를 추가하려면 다음을 클릭하십시오. 더보기 버튼.
       1. Name: 각 매개변수의 이름을 지정합니다. 명령 호출 시 값을 전달하는 인수에 사용했던 이름을 사용하세요.
       2. Type: 매개변수의 데이터 형식을 정의합니다. 문자열, 정수 또는 배정밀도 부동소수점 형식의 매개변수를 정의할 수 있습니다.
       3. Mode: 매개변수에 고정 값, 변수 또는 드롭 위치가 포함되는지 정의합니다. dropX 및 dropY 드롭 중에 마우스 포인터가 릴리스된 위치를 제공합니다. 단, dropX 및 dropY 은(는) Drag & Drop 모드에서만 사용할 수 있습니다. 매개변수를 변수로 정의하면 명령을 시작할 때 매개변수 값을 입력하라는 메시지가 표시됩니다.
       4. Default: 기본값을 여기에 입력합니다.
       5. Min/Max: 매개변수의 값 범위를 여기에 입력합니다.
       6. Inc: 값 범위 내의 증가 단위를 여기에 입력합니다.

예:

XML을 통한 스크립트 모음 생성

VisualApplets GUI를 사용하지 않고 XML로만 스크립트 컬렉션을 정의할 수 있습니다.

각 스크립트 컬렉션마다 하나의 XML 파일을 만듭니다.

XML 파일에서 컬렉션과 포함된 명령을 정의하자마자 해당 컬렉션이 VisualApplets GUI에 표시됩니다. 전제 조건: VisualApplets의 System Settings에서 XML 파일의 위치를 지정해야 합니다. Required Settings를 참조하십시오.

스크립트 컬렉션의 구조와 콘텐츠에 관한 모든 정보는 스크립트 컬렉션당 하나의 XML 파일에 정의됩니다. 각각 하나의 스크립트 컬렉션을 정의하는 여러 XML 파일을 제공할 수 있습니다. 스크립트 컬렉션을 정의하는 XML 파일이 VisualApplets의 메뉴 Settings -> System Settings -> Paths -> Script Collection에서 지정한 디렉토리에 있는 경우, 해당 스크립트 컬렉션은 VisualApplets GUI의 Script Collection 창에 표시됩니다.

예제

VisualApplets provides the three example script collections DesignTools, LayoutAssist, and TclExamples. You find them as .xml file as well as as .tcl file in the directory <VA installation directory>/Examples/AdvancedVAFunctions/Script Collection.

VisualApplets의 GUI에 예제 스크립트 컬렉션을 표시하려면:

1. Settings -> System Settings -> Paths에서 예제 스크립트 컬렉션이 저장된 폴더의 경로를 정의합니다.

   

2. Script Collection 창을 마우스 우클릭하고 Rescan Script Collection Directory를 선택합니다.

   

   이제 GUI의 Script Collection 창에 예제 스크립트 컬렉션이 표시됩니다.

   

3. 이제 GUI 옵션과 XML 파일의 내용을 자유롭게 변경하여 작업의 영향을 확인할 수 있습니다.

예제 DesignTools.xml의 형태는 다음과 같습니다.

구문

XML 파일의 구문은 다음과 같습니다.

정보

Make sure you use the same name for the XML file name as in tag <ScriptCollection> of the XML file.

예:

파일 이름:

myCollection.xml

XML 파일 내의 컬렉션 이름:

<ScriptCollection name ="myCollection" formatVersion="1.0">.

이 형식은 다음 규칙에 따라 정의됩니다:

• 선택 사항이며, 개별 요소는 대괄호 [ ]로 묶입니다.
• 존재하지 않거나, 한 번 또는 여러 번 존재할 수 있는 구문 요소는 중괄호 { }로 묶입니다.
• 구문 (..|..)은 제공된 요소 중 하나를 지정할 수 있음을 나타냅니다.
• 파라미터 값은 기울임꼴 대문자로 표시됩니다.

The Tags <Scope> and <Toolbar>

<Scope>:

Use the tag <Scope>, if you want to limit the command to a specific design element in the design.

이는 선택적 태그이며, 명령 모드를 다음과 같이 설정한 경우에만 허용됩니다. Trigger. You can define <Scope> multiple times to specify multiple scopes. The tag isn't allowed when Command mode 로 설정된 경우, DragAndDrop.

사용 가능한 옵션은 다음과 같습니다.

• Module: 이 명령을 시작하려면 정확히 하나의 모듈을 선택해야 합니다.
• Link: 이 명령을 시작하려면 정확히 하나의 링크를 선택해야 합니다.
• CommentBox: 이 명령을 시작하려면 정확히 하나의 코멘트 박스를 선택해야 합니다.
• SimModule: 이 명령을 시작하려면 정확히 하나의 시뮬레이션 모듈을 선택해야 합니다.
• SingleSelect: 이 명령을 시작하려면 정확히 하나의 디자인 요소를 선택해야 합니다. 어떤 종류의 요소를 선택하든 상관없습니다(모듈, 링크 등).
• MultiSelect: 이 명령을 시작하려면 둘 이상의 디자인 요소를 선택해야 합니다. 어떤 종류의 요소를 선택하든 상관없습니다(모듈, 링크 등).

이 옵션들을 조합할 수 있습니다. 예를 들어 Module과 Link 옵션을 조합하면 정확히 하나의 모듈 또는 정확히 하나의 링크를 선택했을 때 명령이 실행됩니다. SingleSelect와 MultiSelect를 조합하면 하나 이상의 디자인 요소가 선택된 경우 명령을 시작할 수 있습니다.

명령 범위로 정의된 디자인 요소를 선택하지 않고 명령을 실행하려고 하면 Invalid Scope 메시지가 나타납니다.

<Toolbar>:

선택적 태그로, 다음 항목을 설정한 경우에만 허용됩니다. Command mode (으)로 Trigger. 이 태그를 포함하면 명령이 컬렉션의 툴바에 추가됩니다. 다음의 경우 이 태그는 허용되지 않습니다. Command mode 로 설정된 경우, DragAndDrop.

Parameters

위의 이미지에 기울임꼴로 표시된 파라미터에 다음 값을 입력해야 합니다.

• COL_NAME: 스크립트 컬렉션의 이름입니다.
• COL_PNG_FILE_PATH: 스크립트 모음의 아이콘 파일 경로(PNG 형식, 자세한 내용은 파일 요구 사항 참조). XML 파일을 기준으로 한 상대 경로를 지정합니다.
• COL_TOOLTIP_TEXT: 스크립트 컬렉션을 설명하는 툴팁으로 표시되는 텍스트입니다.
• CMD_NAME: 명령의 이름입니다.
• CMD_TOOLTIP_TEXT: 명령을 설명하는 툴팁으로 표시되는 텍스트입니다.
• CMD_VERSION: MAJOR.MINOR 형식의 명령 버전입니다 (예: 1.0).
• TCL_FILE_PATH: 명령 실행 시 호출할 프로시저가 포함된 Tcl 스크립트의 경로입니다. XML 파일을 기준으로 상대 경로를 지정하세요.
• CMD_PNG_FILE_PATH: 명령의 아이콘 파일(PNG 형식, 자세한 내용은 파일 요구 사항 참조). XML 파일을 기준으로 한 상대 경로를 지정합니다.
• CMD_CALL: 명령에 의해 호출되는 Tcl 스크립트 내의 프로시저 이름(또는 전체 Tcl 프로시저)입니다.
• CMD_PARAM: 명령 호출 시 실제 값으로 대체되는 파라미터 이름(인수). 다음 항목에 정의된 파라미터 이름만 지정하십시오. 태그.
• PAR_NAME: 파라미터 이름입니다.
• PAR_RANGE_FROM: 값 범위의 시작입니다 (int 또는 double 데이터 타입에만 해당).
• PAR_RANGE_TO: 값 범위의 끝입니다 (int 또는 double 데이터 타입에만 해당).
• PAR_RANGE_INC: 값 범위 내의 단계 크기(int 또는 double 데이터 타입에만 해당).
• PAR_VALUE: 매개변수의 기본값.

GUI로 스크립트 모음 로드

GUI를 통해 생성하는 각 스크립트 모음에 대해 Settings → System Settings → Path 아래에 지정한 디렉터리에 하나의 XML 파일이 기록됩니다. 디렉터리에 새로운 모음 설명 XML 파일을 추가하거나 그곳에 저장된 기존 XML 파일을 편집하는 경우, VisualApplets GUI에서 변경 사항이 반영되도록 할 수 있습니다. VisualApplets를 다시 시작하지 않고 변경 사항을 표시하려면 Script Collection 창을 마우스 우클릭하고 Rescan Script Collection Directory를 선택하십시오.