사용자 정의 코드 스니펫

일부 스크립트에는 Studio 작업이 단독으로 제공할 수 있는 것보다 더 높은 복잡성이 필요합니다. Studio을(를) 사용하면 스크립트에 사용자 정의 코드를 추가할 수 있습니다. 이를 통해 조직의 요구사항을 충족하기 위해 스크립트를 사용자 정의할 수 있습니다.

사용자 정의 코딩에는 약간의 스크립팅과 프로그래밍 지식이 필요합니다. Studio은 Snippet에서 사용하도록 개발된 Studio라는 사용자 지정 프로그래밍 언어를 사용합니다. 이 언어를 사용하는 방법을 배울 수 있도록 완전한 기술 참조 가이드를 온라인 도움말에서 사용할 수 있습니다.

스니펫에 대한 주요 정보

  • 코드 스니펫은 조직과 스크립트의 효율성 향상에 도움이 될 수 있습니다. 실행되는 프로세스를 더욱 자유롭게 제어할 수 있는 것은 물론 실행 시점과 방법도 더욱 자유롭게 제어할 수 있습니다. 직접 변수와 개체를 생성할 수 있으며 IF, FOR, FOREACH 등의 문을 사용하여 프로그래밍 논리를 추가할 수 있습니다.
  • 일부 제품과 기능에는 스니펫이 필요하지만, 필요하지 않을 때도 스크립트에서 이를 사용할 수 있습니다.
  • 제품이나 기능에 코드 스니펫이 필요한 경우, 포함해야 하는 스니펫에 관한 세부 정보를 제공합니다. 스크립트에서 코드 스니펫을 사용하는 방법을 보여주기 위한 스크립트의 예시가 제공됩니다. 제품 또는 기능에 추가 스크립팅을 구현해야 할 수 있습니다.
  • Snippet 스크립팅 언어는 .NET 프레임워크에 구축됩니다. 이 언어는 서버 측에서 실행되고 C# 및 Visual Basic .NET과 마찬가지로 MSIL(Microsoft Intermediate Language)로 컴파일됩니다.

스니펫 작업

스크립트에 사용자 정의 코드를 추가하려면 Snippet 작업이 필요합니다. 이 작업을 두 번 클릭하여 사용자 정의 코드를 추가할 수 있는 편집기 창을 열 수 있습니다. 또한 편집기 창에서 코드를 디버그할 수도 있습니다. 스크립트에는 두 개 이상의 Snippet 작업이 필요할 수 있습니다. 여러 작업을 사용하는 경우 목적을 인식하는 데 도움이 되는 문구로 각 작업의 Caption 추가 필드를 업데이트합니다.

Snippet 작업의 배치는 중요합니다. Snippet이(가) 값을 변수에 할당하면 값이 필요한 작업 전에 배치해야 합니다. 반면 Snippet에 전달되는 값에 따라 작동하는 의사결정 코드가 포함되어 있는 경우에는 값을 제공하는 작업 이후에 Snippet을(를) 배치해야 합니다.

작업과 스니펫의 비교

스니펫에서 할 수 있는 작업의 일부는 Studio 작업을 사용해서도 수행할 수 있습니다. 예를 들어 IF 및 FOR 문을 위한 작업이 있습니다. 또한 사용가 정의 변수를 생성하고 이를 값에 할당하는 데 사용할 수 있는 ASSIGN 작업도 있습니다. 이러한 작업을 용납 가능한 방식으로 사용하여 이러한 기능을 스크립트에 추가합니다. 하지만, 스니펫을 사용하면 더욱 효율적입니다.

스니펫에 코드를 배치하면 스크립트가 더욱 깔끔해지고, 잘 정리되며, 탐색하기 쉬워집니다. 덕분에 스크립터 작업을 더욱 쉽게 효율적으로 수행할 수 있습니다. 스니펫에서 항상 변수를 선언하는 습관을 들이면 나중에 특정한 선언을 찾아야 할 때 더 좁은 범위에서 검색할 수 있습니다.

스크립트에 사용자 정의 코드 추가

Snippet 작업을 통해 스크립트에 사용자 정의 코드를 추가할 수 있습니다. 이 작업은 도구 탭에 있는 기본 팔레트의 고급 섹션에 있습니다.

  1. Studio에서 스크립트를 엽니다.
  2. 코드가 필요한 모든 곳의 스크립트에 Snippet 작업을 배치하고 이를 다른 작업에 연결합니다.
  3. 작업을 두 번 클릭하여 편집기 창을 엽니다. 여기에서 코드를 추가하면 됩니다.

  4. 코드 추가에 사용할 탭을 클릭합니다. 각 탭에서 각기 다른 코드 추가 메서드를 제공합니다. 탭은 다음과 같습니다.

  5. 원하면 코드를 디버그합니다.

  6. 언제든지 Apply을(를) 클릭하면 편집기 창을 닫지 않고 변경 사항을 저장할 수 있습니다.
  7. 코드 편집이 끝나면 OK을(를) 클릭합니다.

텍스트 보기로 코드 작성

Snippet 창의 텍스트 보기 탭을 사용하면 Snippet 코드를 직접 작성할 수 있습니다. 이 언어를 사용하는 방법을 배울 수 있도록 완전한 참조 가이드를 온라인 도움말에서 사용할 수 있습니다.

  1. Studio에서 스크립트를 엽니다.
  2. 스크립트에 Snippet 작업을 추가하고 두 번 클릭하여 Snippet 창을 엽니다.
  3. 트리 뷰 탭의 왼쪽에 코드를 입력합니다. 코드를 입력하거나 이 도움말 사이트 또는 다른 스크립트 등의 다른 출처에서 코드를 복사하여 붙여 넣을 수 있습니다.
  4. 언제든지 Tree View 탭을 클릭하여 사전 정의된 키워드에서 코드를 추가합니다. 위 및 아래 화살표 버튼을 사용하여 키워드와 관련된 코드를 스크립트의 다른 위치로 옮길 수 있습니다.
  5. Check Syntax 아이콘 작은 녹색 원 3개와 오른쪽을 가리키는 화살표 모양이 있는 구문 확인 아이콘입니다. 을 클릭하여 현재 코드의 구문이 올바른지 확인합니다. 텍스트 보기 탭 하단의 툴바에 있는 상태 필드에는 Okay 상태가 표시됩니다. 오류가 있는 경우에는 오류 관련 팝업 메시지가 표시되며, 툴바의 상태 필드에는 메시지가 표시됩니다. 예를 들어 메시지는 Error at line 4(으)로 읽힐 수 있습니다.
  6. Comment 아이콘 열기 꺾쇠괄호와 닫기 꺾쇠괄호 사이에 파란색 정방향 슬래시 기호가 있는 모양의 메모 아이콘입니다. 을 클릭하여 커서가 현재 위치한 줄을 메모로 변환합니다.
  7. Uncomment 아이콘 큰 빨간색 정방향 슬래시가 열기 꺾쇠괄호와 닫기 꺾쇠괄호 사이에 파란색 정방향 슬래시 기호가 있는 아이콘 위를 가로질러 그려져 있는 모양의 메모 삭제 아이콘입니다. 을 클릭하여 커서가 현재 위치한 줄에서 메모 문자를 제거합니다.
  8. 언제든지 Apply을(를) 클릭하면 편집기 창을 닫지 않고 변경 사항을 저장할 수 있습니다.
  9. 코드 편집이 끝나면 OK을(를) 클릭합니다.

트리 뷰를 사용한 코드 작성

스니펫 속성 창의 트리 뷰 탭에서는 사용자 정의 코드 생성 프로세스를 안내합니다. 사전 정의된 키워드 세트에서 선택할 수 있습니다.

  1. Studio에서 스크립트를 엽니다.
  2. 스크립트에 Snippet 작업을 추가하고 두 번 클릭하여 스니펫 창을 엽니다.
  3. 트리 뷰 탭 하단에 있는 더하기 아이콘 아래 방향 화살표가 옆에 있는 더하기 기호입니다. 을 클릭합니다.

  4. 스니펫 속성 창입니다. 트리 뷰 탭이 표시되어 있습니다. 녹색 더하기 기호 아이콘을 누르면 스니펫 명령 메뉴가 표시됩니다.

    코드에 추가하려는 키워드를 선택합니다.
  5. 창의 왼쪽 목록에 표시되는 키워드를 클릭하여 속성을 봅니다.

  6. 창의 오른쪽 목록에 표시되는 키워드의 속성을 구성합니다. 다음을 수행할 수 있습니다.

    • 각 속성을 선택하면 오른쪽 창 아래 공간에 속성의 정의가 표시됩니다.
    • 이 페이지의 스니펫 키워드 섹션에서 각 명령 구성에 관한 세부 정보를 확인하십시오.
  7. 필요에 따라 더 많은 키워드를 추가합니다.
  8. 언제든지 Text View 탭을 클릭하면 기존 코드 작성 형식으로 작성된 코드를 볼 수 있습니다.
  9. 언제든지 Apply을(를) 클릭하면 편집기 창을 닫지 않고 변경 사항을 저장할 수 있습니다.
  10. 코드 편집이 끝나면 OK을(를) 클릭합니다.

스니펫 코드 디버깅

Snippet 작션에는 코드를 검토하는 데 사용할 수 있는 자체 디버거가 있습니다. 텍스트 보기 탭에서만 코드를 디버그할 수 있습니다.

트리 뷰 탭에서 코드를 작성한 경우에는 텍스트 보기 탭으로 전환하면 디버거를 사용할 수 있습니다. 디버거에서 문제를 찾으면 특정한 줄 번호를 사용하여 코드의 어떤 부분에 문제가 있는지를 확인하십시오. 그다음 트리 뷰로 돌아가면 문제를 정정할 수 있습니다.;

줄별로 코드 단계별 진행 및 중단점 사용 등 더 많은 디버깅 옵션을 사용할 수 있습니다. 또한 스니펫 코드에서 TRACE 문을 사용하면 디버깅 중에 텍스트를 출력할 수 있습니다. 이 출력은 스크립트에서 문제를 해결할 때 유용합니다.

  1. Studio에서 Snippet 작업이 포함된 스크립트를 엽니다.
  2. Snippet 작업을 두 번 클릭합니다.
  3. 이미 일부가 포함되어 있지 않다면 Text View 탭에 Snippet 코드를 추가합니다.
  4. Snippet editor 창 오른쪽에서 Debugger 탭을 클릭합니다.
  5. Debug 아이콘 의 아래 방향 화살표 버튼을 클릭한 다음 Start삼각형 모양의 녹색 재생 버튼 아이콘입니다. 을(를) 선택합니다.

  6. 코드에 구문 오류가 있는 경우 Snippet editor 창이 확장됩니다. 코드에 있는 모든 오류가 창 하단의 창에 표시됩니다. 오류가 없으면 다음 단계로 넘어갑니다.

    스니펫 편집기 창입니다. 창 하단에 오류 창이 표시되어 있습니다.
    1. 오류를 정정합니다.
    2. 오류가 정정되면 Close 또는 Clear Trace Output 아이콘 을 클릭하여 오류 창을 닫습니다.
    3. 디버거를 다시 시작합니다.
  7. Variables as Text 탭의 콘텐츠를 봅니다. 중단점을 설정하지 않은 경우 모든 코드가 실행되면 탭에 변수와 값이 표시됩니다.
  8. 스니펫 코드에서 한 개 이상의 줄을 선택한 다음 Comment out selected lines 아이콘 을 클릭할 수 있습니다. 일부 코드를 제거하였을 때 디버깅 결과가 변경되는 방식을 보고 싶을 때 유용합니다.
  9. 메모가 작성된 코드가 있는 줄을 한 개 이상 선택하고 Uncomment the selected lines 아이콘 을 클릭하면 해당 줄을 스니펫에 다시 추가할 수 있습니다.