다음을 통해 공유


변수 및 변수 창 관리

변수 창에는 Power Automate 데스크톱 흐름과 주고받은 입력 및 출력 변수가 표시됩니다. 또한 흐름 변수 아래에 현재 데스크톱 흐름에 사용된 모든 변수를 표시합니다.

이 창을 통해 변수를 검색하고, 이름을 바꾸고, 사용법을 찾고, 민감함으로 표시하고, 고정하고, 유형별로 필터링할 수 있습니다. 필터링을 사용하면 고정된 변수에 적용할지 여부를 선택할 수 있습니다.

변수 창의 스크린샷.

변수 값 뷰어

흐름이 실행되면 각 변수의 현재 값이 이름 옆에 표시됩니다. 변수 창 하단에 있는 지우개 아이콘을 선택하여 현재 값을 모두 지웁니다.

노트

Power Automate는 비활성화된 작업의 변수를 자동으로 생략합니다. 비활성화된 작업을 활성화하여 변수 창에서 해당 변수를 사용할 수 있도록 합니다.

변수 창에 있는 일부 값의 스크린샷.

변수 값을 더 자세히 조사하려면 변수를 더블 클릭하십시오. 변수 값 뷰어는 선택한 변수의 데이터 유형을 표시하고 데이터 행 또는 데이터 테이블를 확장하여 해당 내용을 표시합니다.

변수 값 뷰어의 스크린샷.

특정 데이터 유형에는 중첩된 요소가 포함될 수 있습니다. 예를 들어, 사용자 지정 개체의 속성에는 다른 사용자 지정 개체가 포함될 수 있습니다. 중첩된 요소의 속성을 보려면 자세히를 선택합니다.

변수 값 뷰어의 상위 사용자 지정 개체 스크린샷.

대화 상자 상단의 화살표 아이콘을 선택하여 상위 요소로 돌아갑니다.

변수 값 뷰어의 하위 사용자 지정 개체 예시 스크린샷.

데스크톱 변수 이름 변경

데스크톱 흐름 변수의 이름을 바꾸려면 해당 이름을 마우스 오른쪽 버튼으로 클릭하고 이름 바꾸기를 선택합니다. Power Automate는 모든 항목에서 변수 이름을 자동으로 업데이트합니다.

중요

변수의 이름을 기존 이름으로 바꾸려고 하면 Power Automate에서 두 변수의 병합을 확인하라는 메시지를 표시합니다. 의도하지 않은 병합은 흐름의 기능에 영향을 미치고 오류를 일으킬 수 있으므로 병합이 바람직한지 확인하세요.

변수 이름 바꾸기 옵션의 스크린샷.

입력 및 출력 변수

Power Automate을 사용하면 입력 및 출력 변수를 통해 클라우드와 데스크톱 흐름 간의 데이터 교환이 가능하므로 변수 이름 바꾸기 옵션의 자동화 기능을 확장할 수 있습니다

또한 콘솔을 통해 흐름이 트리거될 때 입력 변수를 사용하여 수동으로 값을 설정할 수 있습니다.

클라우드 흐름과 데스크톱 흐름 간의 데이터 전달에 대한 자세한 내용은 클라우드 흐름에서 데스크톱 흐름 트리거를 참조하세요.

입력 변수 만들기

입력 변수를 만들려면 다음을 수행합니다.

  1. 변수 창에서 더하기 버튼(+)을 선택한 다음 입력을 선택합니다.

    새 입력 변수를 만드는 버튼의 스크린샷.

  2. 새 입력 변수 추가 대화 상자가 나타나면 다음 필드를 채웁니다.

    • 변수 이름: 데스크톱 흐름의 변수 이름입니다.
    • 데이터 유형: 텍스트, 숫자, 부울, 사용자 지정 개체, 목록 또는 데이터 테이블과 같은 변수 유형입니다.
    • 기본값: 흐름이 흐름 디자이너 또는 콘솔을 통해 실행될 때의 기본값입니다. 사용자 지정 개체, 목록 또는 데이터 테이블 입력 변수를 만들 때 Power Automate를 사용하면 시각적 개체 또는 JSON 편집기를 통해 기본값을 구성할 수 있습니다. 비주얼 편집기의 사용자 지정 개체 입력 변수 스크린샷.
    • 외부 이름: 외부 이름은 콘솔에서 흐름을 호출할 때 클라우드 흐름 디자이너 및 흐름 입력 대화 상자에 나타나는 이름입니다.
    • 설명: 흐름을 호출하는 동안 클라우드 및 데스크톱 흐름 디자이너에 나타나는 변수에 대한 설명입니다.
    • 민감한 것으로 표시: 변수를 민감한 것으로 표시할지 여부를 정의합니다. 민감한 변수에 대한 정보는 민감 변수에서 찾을 수 있습니다.
    • 선택 사항으로 표시: 이 입력 변수를 채우는 것이 필수인지 여부를 정의합니다. 입력 변수를 선택 사항으로 표시하면 값을 수신하고 실제 값 전달을 생략할 수 있으므로 오류가 발생하지 않습니다. 선택적 입력 변수에 관한 정보는 선택적 입력 변수에서 확인하실 수 있습니다.

    참고

    변수 이름, 데이터 유형, 외부 이름 필드는 입력 변수를 생성하는 데 필요합니다.

    중요

    새 입력 변수에 대해 기존 흐름 변수 이름을 선택하면 Power Automate에서 두 변수의 병합을 확인하라는 메시지를 표시합니다. 의도하지 않은 병합은 흐름의 기능에 영향을 미치고 오류를 일으킬 수 있습니다. 또한 기존 입력 또는 출력 변수의 이름을 사용할 수 없습니다.

    새 입력 변수를 만들기 위한 대화 상자의 스크린샷.

클라우드 흐름이 아닌 콘솔을 통해 직접 데스크톱 흐름을 트리거하면 흐름 입력 대화 상자에서 입력 변수의 값을 수동으로 설정하라는 메시지를 표시합니다. 사용자 지정 개체, 목록 및 데이터 테이블의 경우 대화 상자에서 시각적 개체 또는 JSON 편집기를 사용하여 값을 채울 수 있습니다.

흐름 입력 대화 상자의 스크린샷.

출력 변수 만들기

출력 변수를 만들려면 다음을 수행합니다.

  1. 변수 창에서 더하기 버튼(+)을 선택한 다음 출력을 선택합니다.

    새 출력 변수를 만드는 버튼의 스크린샷.

  2. 새 출력 변수 추가 대화 상자가 나타나면 다음 필드를 채웁니다.

    • 변수 이름: 데스크톱 흐름의 변수 이름입니다.
    • 데이터 유형: 텍스트, 숫자, 부울, 사용자 지정 개체, 목록 또는 데이터 테이블과 같은 변수 유형입니다.
    • 외부 이름: 외부 이름은 클라우드 흐름 디자이너에 나타나는 이름입니다.
    • 설명: 흐름을 호출하는 동안 클라우드 또는 데스크톱 흐름 디자이너에 나타나는 변수에 대한 설명입니다.
    • 민감한 것으로 표시: 변수를 민감한 것으로 표시할지 여부를 정의합니다. 민감한 변수에 대한 정보는 민감 변수에서 찾을 수 있습니다.

    노트

    변수 이름, 데이터 유형, 외부 이름 필드는 출력 변수를 생성하는 데 필요합니다.

    중요

    새 출력 변수에 대해 기존 흐름 변수 이름을 선택하면 Power Automate에서 두 변수의 병합을 확인하라는 메시지를 표시합니다. 의도하지 않은 병합은 흐름의 기능에 영향을 미치고 오류를 일으킬 수 있습니다. 또한 기존 입력 또는 출력 변수의 이름을 사용할 수 없습니다.

    새 출력 변수를 만들기 위한 대화 상자의 스크린샷.

입력 및 출력 변수 관리

생성된 모든 입력 및 출력 변수는 변수 창의 해당 섹션에서 사용할 수 있습니다.

이 창을 사용하여 각 입력/출력 변수의 이름을 바꾸고, 업데이트하고, 삭제하고, 사용법을 찾고, 고정하고, 필터링할 수 있습니다. 필터링을 사용하면 고정된 변수에 적용할지 여부를 선택할 수 있습니다.

입력 및 출력 변수를 표시하는 변수 창 섹션의 스크린샷.

입력/출력 변수를 업데이트하려면 다음을 수행합니다.

  1. 변수 창에서 이름을 마우스 오른쪽 버튼으로 클릭하고 편집을 선택합니다.

    중요

    입력 또는 출력 변수의 이름을 기존 흐름 변수 이름으로 바꾸려고 하면 Power Automate에서 두 변수의 병합을 확인하라는 메시지를 표시합니다. 의도하지 않은 병합은 흐름의 기능에 영향을 미치고 오류를 일으킬 수 있습니다. 또한 기존 입력 또는 출력 변수의 이름을 사용할 수 없습니다.

    입력 및 출력 변수를 편집하는 옵션의 스크린샷.

  2. 입력/출력 변수 편집 대화 상자에서 원하는 필드를 업데이트하고 저장을 선택하여 변경 사항을 적용합니다.

    입력 및 출력 변수를 편집하는 대화의 스크린샷.

민감한 변수

중요

데스크톱용 Power Automate(v.2.13 이하)에서 개발된 흐름은 편집하지 않는 한 민감한 변수 기능의 영향을 받지 않습니다. 편집하지 않고 콘솔이나 포털을 통해 기존 데스크톱 흐름을 실행하면 이전 동작을 유지하고 이전과 같이 작동합니다.

새 기능을 적용하려면 데스크톱용 Power Automate v.2.14 이상을 사용하여 흐름을 편집하고 저장합니다. Power Automate는 CyberArk에서 암호 가져오기 작업으로 생성된 과거의 암호화된 입력 변수 및 암호화된 변수를 민감함으로 표시된 텍스트 변수로 변환합니다.

일부 자동화 시나리오는 기밀 정보를 처리하고 런타임 중에 중요한 데이터를 저장하고 사용하는 변수를 특별히 처리해야 합니다. 데스크톱 흐름은 흐름 디자이너의 변수 창에서 디버깅하는 동안 값이 마스킹되는 민감한 변수 생성을 지원합니다.

또한 조직 프리미엄 계정으로 로그인한 경우 데스크톱 흐름이 콘솔 또는 클라우드 흐름을 통해 실행될 때 민감한 변수의 값이 포털의 실행 기록에 저장되지 않습니다.

모든 변수는 유형에 관계없이 민감할 수 있습니다. 민감도는 변수 수준에서 적용되므로 목록, 데이터 행, 데이터 테이블 및 사용자 지정 개체가 전체적으로 민감해집니다. 목록 항목, 데이터 테이블 열 또는 변수 속성을 중요하지 않은 변수에서 중요한 것으로 표시할 수 있는 방법은 없습니다.

다른 모든 변수와 마찬가지로 모든 작업에서 민감한 변수를 제한 없이 사용, 조작 및 처리할 수 있습니다. 또한 다른 변수와 결합하여 표현식에 포함할 수 있습니다. 이 경우 로그는 전체 식을 민감한 것으로 처리합니다.

흐름 디자이너는 감도를 설정 및 해제할 수 있는 마스크로 처리합니다. 따라서 민감한 변수의 마스크를 해제하여 값을 보고 다시 마스크하여 값을 숨길 수 있습니다.

중요

민감한 변수는 하드코딩된 데이터를 보호하기 위한 것이 아닙니다. 해당 변수가 민감한 것으로 표시되더라도 변수 설정과 같은 작업 속성에서 암호 및 PIN과 같은 일반 텍스트로 민감한 데이터를 하드코딩하면 안 됩니다. 데스크톱 흐름 로그는 보호되지만 하드코딩된 값은 Microsoft Dataverse의 모드 및 흐름 정의에서 볼 수 있습니다.

클라우드 흐름의 민감한 입력에 대한 자세한 내용은 암호와 같은 민감한 입력 관리를 참조하세요.

노트

  • 민감한 변수의 값은 데스크톱 흐름 외부로 보내거나 메시지 표시 작업을 통해 표시할 때 표시됩니다.
  • 민감도는 변수에서 상속할 수 없습니다. 민감한 변수를 다른 변수에 추가하거나 할당하는 경우 결과 변수는 기본적으로 민감하지 않습니다. 이 규칙의 예외는 자격 증명 변수 형식에만 적용됩니다. 각 작업 또는 다른 변수의 재할당에 의해 생성된 자격 증명 변수는 항상 중요하며 해당 민감도가 적용됩니다. 동일한 예외가 자격 증명 변수 유형의 "Password" 속성에도 적용됩니다.
  • 변수를 민감한 것으로 표시하면 변수 설정 작업의 요약에서 해당 값을 숨깁니다.
  • 변수 설정 작업의 입력 세부 정보는 포함된 변수가 민감한 것으로 표시된 경우 데스크톱 흐름 로그에 표시되지 않습니다.
  • 디버깅 중 민감한 변수를 마스킹하면 화면을 보는 제3자로부터 개발자를 보호하는 기본적인 형태만 제공됩니다.

변수를 민감함으로 표시하려면 변수 창에서 변수를 마우스 오른쪽 버튼으로 클릭하고 민감함으로 표시를 선택합니다. 변수를 민감한 것으로 설정하지 않으려면 변수 창에서 변수를 마우스 오른쪽 버튼으로 클릭하고 민감하지 않음으로 표시를 선택합니다.

변수를 민감한 것으로 표시하는 옵션의 스크린샷.

상황에 맞는 메뉴 외에도 각 변수 옆에 있는 전용 아이콘을 사용하여 민감하거나 민감하지 않은 것으로 표시할 수 있습니다.

변수를 민감한 것으로 표시하는 아이콘의 스크린샷.

민감한 입출력 변수

입력 또는 출력 변수를 생성하거나 편집할 때 해당 대화 상자에서 민감함으로 표시를 선택하여 민감하게 만들 수 있습니다.

새 입력 변수를 추가하기 위한 대화 상자의 스크린샷.

입력 변수의 기본값은 민감도가 사용된 경우 생성 또는 편집 대화 상자에서 볼 수 있습니다. 포털 또는 콘솔을 통해 프로덕션 실행에서 각 입력을 초기화해야 하므로 이 값은 테스트 및 디버깅 목적으로만 존재합니다. 기본값은 Dataverse의 작업 모드 및 흐름 정의에서 보호되지 않습니다.

반면에 콘솔을 통해 입력 변수가 있는 데스크톱 흐름을 실행할 때 나타나는 변수 창과 흐름 입력 대화 상자에는 기본값이 표시되지 않습니다.

기본 텍스트 값을 삭제하고 새 값을 제공하지 않는 한 값을 표시하는 눈 아이콘을 사용할 수 없습니다. 텍스트 이외의 다른 데이터 유형을 채울 때 새 값이 표시됩니다.

민감한 변수가 있는 흐름 입력 대화 상자 스크린샷.

선택적 입력 변수

입력 또는 출력 변수를 생성하거나 편집할 때 해당 대화 상자에서 선택 사항으로 표시를 선택하여 선택 사항으로 만들 수 있습니다.

선택 사항으로 표시 컨트롤 스크린샷.

기본적으로 입력 변수는 필수입니다. 즉, 다음을 제공해야 합니다.

  • 다른 값을 전달하지 않는 경우 디버깅(콘솔 시작) 실행 중에 사용할 수 있도록 생성할 때 기본값입니다.
  • 적절한 실행을 보장하기 위한 해당 유형의 값입니다.

입력 변수가 선택 사항으로 표시된 경우 값을 받을 수 있으므로 위의 두 항목을 모두 생략할 수 있습니다.

선택적 입력의 기본값을 공백으로 설정

텍스트 변수

텍스트 변수의 기본값을 공백으로 설정하려면:

  • 데이터 형식 속성을 텍스트로 설정합니다.
  • 선택 사항으로 표시 컨트롤을 활성화합니다.
  • 기본값 속성이 비어 있는지 확인하세요.

공백을 기본값으로 사용하는 텍스트 변수 입력 구성의 스크린샷.

공백 숫자 입력

숫자 변수의 기본값을 공백으로 설정하려면:

  • 데이터 형식 속성을 숫자로 설정합니다.
  • 선택 사항으로 표시 컨트롤을 활성화합니다.
  • 기본값 속성이 비어 있는지 확인하세요.

공백을 기본값으로 사용하는 숫자 변수 입력 구성의 스크린샷.

공백 부울 입력

부울 변수의 기본값을 공백으로 설정하려면:

  • 데이터 형식 속성을 부울로 설정합니다.
  • 선택 사항으로 표시 컨트롤을 활성화합니다.
  • 기본값 속성이 <공백>으로 설정되었는지 확인하세요.

공백을 기본값으로 사용하는 부울 변수 입력 구성의 스크린샷.

공백 사용자 지정 개체 입력

사용자 지정 개체의 기본값을 공백으로 설정하려면:

  • 데이터 형식 속성을 사용자 지정 개체로 설정합니다.
  • 선택 사항으로 표시 컨트롤을 활성화합니다.
  • 기본값 속성이 <공백>으로 설정되었는지 확인하세요. 이를 달성하려면 속성 옆에 있는 편집을 선택하고 사용자 지정 개체 편집 창에서 JSON 편집기 컨트롤을 활성화합니다. 모든 내용을 삭제한 후 저장을 선택하세요.

공백을 기본값으로 사용하는 사용자 지정 개체 입력 구성의 스크린샷.

공백 목록 입력

목록의 기본값을 공백으로 설정하려면:

  • 데이터 형식 속성을 목록으로 설정합니다.
  • 선택 사항으로 표시 컨트롤을 활성화합니다.
  • 기본값 속성이 <공백>으로 설정되었는지 확인하세요. 이를 달성하려면 속성 옆에 있는 편집을 선택하고 목록 편집 창에서 JSON 편집기 컨트롤을 활성화합니다. 모든 내용을 삭제한 후 저장을 선택하세요.

공백을 기본값으로 사용하는 목록 입력 구성의 스크린샷.

공백 데이터 테이블 입력

데이터 테이블의 기본값을 공백으로 설정하려면:

  • 데이터 형식 속성을 데이터 테이블로 설정합니다.
  • 선택 사항으로 표시 컨트롤을 활성화합니다.
  • 기본값 속성이 <공백>으로 설정되었는지 확인하세요. 이를 달성하려면 속성 옆에 있는 편집을 선택하고 데이터 테이블 편집 창에서 JSON 편집기 컨트롤을 활성화합니다. 모든 내용을 삭제한 후 저장을 선택하세요.

공백을 기본값으로 사용하는 데이터 테이블 입력 구성의 스크린샷.

데스크톱 흐름을 디버깅하는 동안 변수 편집

디자인 콘솔에서 Power Automate 데스크톱은 디버거에서 흐름을 실행하는 동안 일반 변수 유형 편집을 지원합니다. 현재 지원되는 데이터 형식에는 텍스트, 숫자, 날짜/시간 및 부울 값이 포함됩니다.

디버거에서 흐름을 실행하는 동안 변수를 편집하는 방법

디자인 콘솔에서 흐름 변수 값을 수동으로 수정하기 위해 사용할 수 있는 두 가지 방법이 있습니다.
흐름 변수 값을 변경하기 전에 특정 지점에 중단점을 배치합니다. 흐름을 실행한 다음 선택한 중단점에서 흐름이 일시 중지될 때까지 기다립니다. 흐름 변수 창은 콘솔의 오른쪽 하단에 있습니다. 목록에서 변수 이름을 찾고 그 옆을 두 번 클릭하여 변수 뷰어를 엽니다.

숫자 값 수정:

편집이 필요한 변수를 열고 커서를 입력 필드에 놓고 숫자 값을 수동으로 편집합니다. 또는 변수 뷰어의 입력 오른쪽에 있는 현재 값에서 카운트 업 또는 카운트 다운하는 버튼이 있습니다. 값을 숫자 이외의 값으로 변경할 수 없습니다.

변수 뷰어에서 수정 중인 숫자 변수의 스크린샷.

텍스트 값 수정:

편집이 필요한 변수를 열고 커서를 입력 필드에 놓고 텍스트 값을 수동으로 편집합니다. 입력 필드 내에서 텍스트 줄 바꿈을 위한 확인란이 있어 편집기에서 더 쉽게 볼 수 있습니다. 텍스트 값 변수는 숫자를 입력으로 허용하지만 이 값을 수정하고 숫자 값만 허용하는 입력 매개 변수가 있는 작업에 전달하려고 하면 흐름이 해당 지점에 도달하면 예외 오류가 발생한다는 점에 유의하세요.

변수 뷰어에서 수정 중인 텍스트 변수의 스크린샷.

부울 값 수정:

편집이 필요한 변수를 열고 입력 필드에 커서를 놓은 다음 부울 값을 수동으로 편집합니다. 드롭다운 목록을 사용하여 true 또는 false를 선택합니다.

변수 뷰어에서 수정 중인 부울 변수의 스크린샷.

날짜/시간 값 수정:

편집이 필요한 변수를 열고 커서를 입력 필드에 놓고 날짜/시간 값을 수동으로 편집합니다. 허용되지 않는 값을 입력하면 변수 뷰어에 경고 메시지가 나타납니다.

변수 뷰어에서 수정 중인 날짜/시간 변수의 스크린샷.

알려진 문제 및 제한 사항

  • 문제: 데스크톱용 Power Automate 버전 2.14 이상으로 빌드 또는 편집된 흐름은 데스크톱용 Power Automate 이전 버전과 호환되지 않습니다. 데스크톱용 Power Automate의 이전 버전을 사용하여 이러한 흐름을 열거나 실행할 수 없습니다.

    해결 방법: 없음.