입력 변수 생성

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기6분
  • 활동 디자이너의 입력 양식에서 활동에 전달할 변수를 만듭니다.

    시작하기 전에

    입력 스테이지로 이동하려면 먼저 일반 양식에서 활동 이름을 지정 해야 합니다 .

    필요한 역할: workflow_admin 또는 activity_creator

    주:
    입력 양식의 변수 문자열은 255자로 제한됩니다.

    프로시저

    1. + 아이콘을 클릭하여 새 입력 변수를 생성합니다.

      디자이너는 Input1이라는 기본 변수를 만듭니다.

      입력 변수 생성
    2. 필드에 새 변수 이름을 입력합니다.
    3. 변수 이름이나 변수 속성을 변경하려면 값을 두 번 클릭한 다음 나타나는 필드에서 새 값을 선택하거나 입력합니다.
    4. 다음 필드를 사용하여 변수를 구성합니다.
      표 1. 변수 구성
      필드 설명
      유형 이 변수의 데이터 유형입니다. 필드를 두 번 클릭하여 선택 목록을 표시합니다. 일반적인 데이터 유형 외에도 입력 배열을 만들고 민감한 데이터가 포함된 개별 변수를 암호화할 수 있습니다. 암호화된 변수는 ECC 큐로 전달된 후 대상 호스트에서 실행될 때 MID Server에 의해 해독됩니다. 호스트에서 이러한 변수를 실행하여 반환된 중요한 데이터는 암호화된 출력 변수를 통해 다른 활동으로 전달될 수 있습니다.
      필수 입력 변수를 필수로 표시합니다. 필수로 표시된 변수는 워크플로우의 활동에 대한 속성 양식의 필수 필드입니다. 입력 테스트 기능을 사용하면 필수 변수를 필터링할 수 있습니다.
      기본값 이 입력 변수의 기본값입니다. 기본값은 워크플로우의 활동에 대한 속성 양식의 변수에 대해 미리 채워집니다. 변수를 테스트할 때 이 값을 재정의할 수 있습니다.
    5. 변수 목록의 순서를 변경하려면 행을 선택한 다음 행을 새 위치로 끕니다.

      이동할 행을 선택하면 포인터 아이콘이 위쪽/아래쪽 화살표 아이콘( 위쪽/아래쪽 화살표 아이콘)으로 바뀝니다.

    6. 변수를 삭제하려면 행에서 삭제 아이콘( delete icon)을 클릭합니다.
    7. Continue(계속)를 클릭하여 Execution Command 단계로 이동하거나 Go to Pre-Processing (Advanced)(전처리(고급))로 이동을 클릭하여 활동이 실행되기 전에 실행되는 스크립트를 만듭니다.

    입력 변수 매핑

    입력 변수를 생성한 후 명령 실행 양식의 필드에 매핑합니다.

    시작하기 전에

    필요한 역할: activity_admin, activity_creator

    이 태스크 정보

    이러한 필드에는 대상 호스트 또는 엔드포인트에서 데이터를 인증하고 쿼리하는 데 필요한 값이 포함되어 있습니다. 이 예시에는 대상에서 실행할 명령과 필요할 경우 사용할 MID Server에 대한 필드가 포함되어 있습니다.

    프로시저

    변수를 매핑하려면 적절한 필드로 끌어 놓습니다.

    디자이너는 시스템에 필요한 구문으로 변수를 자동으로 표현합니다.

    입력 변수 매핑

    PowerShell 실행 명령 구성

    사용자가 작성한 입력 변수를 사용하여 Orchestration이 Windows 대상 머신에서 실행하는 명령을 구성합니다.

    시작하기 전에

    명령 실행 단계로 진행하기 전에 입력 양식에 필요한 입력 변수를 생성합니다.

    필요한 역할: activity_creator, admin

    주:
    워크플로우 컨텍스트에서 인스턴스를 실행할 필요 없이 MID Server와 대상 컴퓨터 간의 PowerShell 연결을 테스트할 수 있습니다. 자세한 내용은 테스트 템플릿 출력을 참조하세요.

    프로시저

    1. 입력 목록에서 변수를 끌어 명령 필드에 놓습니다.
      시스템은 명령에 적합한 구문으로 변수 형식을 지정합니다.
      그림 1. PowerShell 실행 명령
      PowerShell 실행 명령
    2. 테이블에 표시된 필드를 완성합니다.
      표 2. Powershell 명령 필드
      필드 설명
      입력 입력 변수 작성기. 사용 가능한 필드에 매핑변수를 만듭니다.
      대상 호스트 이 PowerShell 활동에 대한 대상 서버의 호스트 이름 또는 IP 주소입니다.
      스크립트 유형 PowerShell 호스트에서 실행할 스크립트 유형입니다. 사용할 수 있는 옵션은 다음과 같습니다.
      • 사용자 지정 Powershell 명령
      • MID Server 스크립트 파일
      MID Server 스크립트 파일 실행할 MID Server 스크립트 파일입니다. 이 필드는 선택한 스크립트 유형MID Server 스크립트 파일인 경우에 사용할 수 있습니다.
      명령 대상 호스트에서 이 활동이 실행되는 명령입니다. 이 필드는 선택한 스크립트 유형사용자 지정 Powershell 명령인 경우에 사용할 수 있습니다. 변수 작성기에서 이 필드로 입력 변수를 끌어서 놓아 명령을 생성할 수 있습니다.
      Powershell 변수 Powershell을 사용하여 호스트에 전달할 이름-값 쌍입니다. 이러한 변수를 수동으로 생성하거나 입력 변수를 필드로 끌어다 놓을 수 있습니다. 암호화된 입력 변수는 이 필드의 데이터 유형 설정에 관계없이 암호화를 유지합니다. 값을 입력하고 암호화된 데이터 유형을 선택하면 값이 이 필드에 일반 텍스트로 나타나고 ECC 큐로 전달될 때만 암호화됩니다.
      MID 서비스 계정 사용 다른 자격 증명을 시도하지 않고 MID Server 서비스 계정의 자격 증명만 사용하여 대상 호스트에서 이 활동을 인증합니다. 이 확인란을 선택하면 자격 증명 태그 필드를 사용할 수 없습니다.
      자격 증명 태그 이 활동에서 호스트에서 Powershell 명령을 실행하는 데 사용해야 하는 오케스트레이션 활동에 대한 특정 자격 증명 별칭 입니다. 이 필드를 비워 두면 MID Server는 MID Server 서비스 계정으로 끝나는 유효한 자격 증명을 찾을 때까지 사용 가능한 모든 자격 증명을 시도합니다. 자격 증명 별칭이 정의된 경우 MID Server는 해당 별칭에 대한 자격 증명만 시도하고 MID Server 서비스 계정은 시도하지 않습니다. MID 서비스 계정 사용 확인란을 선택하면 이 필드를 사용할 수 없습니다.
      필요한 MID Server 기능 기능별로 Powershell을 쿼리하는 데 사용할 MID 서버입니다. 기본적으로 시스템은 Powershell MID Server를 선택합니다.
    3. 저장을 클릭합니다.
    4. Continue(계속)를 클릭하여 Outputs(출력) 단계로 이동합니다.

    테스트 활동 템플릿 입력

    사용자 지정 활동을 개발하는 동안 워크플로우 컨텍스트에서 활동을 실행할 필요 없이 사용자 지정 활동의 입력 매개변수를 테스트할 수 있습니다.

    시작하기 전에

    입력 변수를 생성하고 실행 명령 양식의 필드에 매핑하거나 이러한 필드에 실제 값을 제공합니다.

    필요한 역할: web_service_admin, activity_admin, activity_creator

    이 태스크 정보

    입력 테스트는 엔드포인트에 대해 입력 매개변수만 실행하고 전처리 또는 후처리 스크립트는 실행하지 않습니다. 워크플로우를 사용하여 전처리 또는 후처리 스크립트를 테스트해야 합니다. 테스트를 위해 활동을 체크아웃할 필요는 없으며, 활동이 제대로 구성된 경우 활동 디자이너의 모든 단계에서 입력 변수를 테스트할 수 있습니다. 일반적으로 명령 실행 단계는 입력을 테스트할 준비가 된 시점입니다.
    주:
    자동 매핑을 사용하려면 입력 변수를 테스트해야 합니다.

    프로시저

    1. 입력 테스트를 클릭합니다.
      입력 소스 변수 목록이 나타납니다. 이러한 변수에 대한 기본값을 추가한 경우 해당 값이 대체 값 열에 나타납니다. 필수 변수는 빨간색 별표로 표시됩니다. 이 예제에서 SOAP 엔드포인트는 주식 시세 변수에 대한 값을 반환합니다.
      입력 변수에 대한 테스트 값
    2. 다음 컨트롤을 사용하여 변수 목록을 필터링합니다.
      • 모든 입력: 모든 입력 변수를 표시합니다. 이것이 기본 뷰입니다.
      • 필수 입력: 필수 입력 변수만 표시합니다.
      • 기본값이 없는 입력: 기본값이 할당되지 않은 입력 변수를 표시합니다.
    3. 필요에 따라 값을 재설정합니다.
      • 기본값 재설정: 이 양식에 설정된 모든 테스트 값을 기본값으로 바꿉니다(있는 경우).
      • 값 지우기: 기본값이 있더라도 입력 변수 목록의 모든 값을 지웁니다.
    4. 테스트 값이 올바르게 구성되었으면 확인을 클릭합니다.
      시스템은 지정된 대상에 대해 구성된 모든 입력의 값을 실행하고 결과 페이로드를 반환합니다. 응답 양식의 버튼에는 페이로드의 다른 뷰가 표시됩니다. 전체 페이로드가 원시 출력 창에 나타납니다.
      그림 2. 입력 테스트의 응답 페이로드
    5. 페이로드의 적절한 매개변수 값을 출력 단계의 변수에 자동으로 매핑하려면 자동 매핑 옵션을 선택합니다.
    6. 또는 구문 분석 규칙에 대해 저장 을 클릭하여 전체 페이로드를 구문 분석 규칙에 복사할 수 있습니다.
      이렇게 하면 페이로드에서 직접 출력 변수의 값을 수동으로 선택할 수 있습니다. 이 작업은 구문 분석 규칙에 있던 이전 페이로드를 완전히 덮어씁니다.
    7. 창의 오른쪽 상단 모서리에 있는 X 를 클릭하여 닫습니다.