노트
사용자 지정 양식 표시 작업은 적응형 카드 기술을 기반으로 합니다. 적응형 카드에 대한 자세한 내용은 이 페이지를 참조하세요.
메시지 상자를 사용하면 텍스트, 날짜 및 파일과 같은 다양한 입력을 입력하거나 정보 및 결과를 화면에 표시하도록 사용자에게 프롬프트를 표시할 수 있습니다.
이 그룹의 대부분의 작업은 단일 입력이 필요한 시나리오를 처리할 수 있지만 일부 자동화에는 입력 또는/및 출력의 조합이 필요할 수 있습니다. 이러한 시나리오를 해결하는 가장 좋은 방법은 사용자 지정 양식 표시 작업입니다.
사용자 지정 양식을 만들려면 사용자 지정 양식 표시 작업을 배포하고 사용자 지정 양식 디자이너 단추를 선택하여 양식 디자이너를 엽니다.
디자이너의 왼쪽에는 텍스트, 날짜 및 파일 입력과 같이 양식에 추가할 수 있는 사용 가능한 모든 입력 요소 그리고 텍스트 및 이미지와 같은 일부 비대화형 요소가 포함된 목록이 있습니다.
사용자 지정 양식에 요소를 추가하려면 두 번 클릭하거나 디자이너의 작업 영역에 끌어다 놓습니다. 양식 디자이너 하단에 있는 미리 보기 창을 사용하여 런타임 동안 구성된 양식이 어떻게 보이는지 확인하세요.
요소를 추가한 후 양식 디자이너의 오른쪽에서 사용 가능한 모든 속성을 처리할 수 있습니다. 사용 가능한 속성은 선택한 요소의 특성에 따라 다를 수 있습니다.
노트
양식 요소 외에도 양식 디자이너는 사용자 지정 양식의 상위 대화 상자 모양을 구성하는 몇 가지 속성을 제공합니다. 구성하려면 작업 영역에서 빈 공간을 선택하고 해당 창에서 사용 가능한 속성을 확인하세요.
사용자가 사용자 지정 양식을 채울 때 제공된 데이터는 CustomFormData 사용자 지정 개체 변수에 저장됩니다. 사용자 지정 개체에 저장된 특정 입력 요소의 값에 액세스하려면 %CustomFormData['ElementID']% 표기법을 사용합니다.
중요
각 요소의 ID는 고유해야 하며 비워둘 수 없습니다. 또한 문자로 시작해야 하며 라틴 문자, 숫자 및 공백을 포함할 수 있습니다. ID 필드에는 변수를 사용할 수 없습니다. 유효하지 않은 ID가 제공되면 양식 디자이너를 닫고 저장한 후 마지막으로 사용한 유효 ID가 자동으로 복원됩니다.
노트
고급 데이터 형식에서 사용자 지정 개체 및 이를 처리하는 방법에 대한 자세한 정보를 찾을 수 있습니다.
입력 및 비대화형 요소 외에도 양식 디자이너는 양식에 추가 기능을 구현하기 위한 몇 가지 작업을 제공합니다.
어떤 단추를 눌렀는지에 따라 다른 기능을 실행할 수 있는 단추로 작업을 고려하세요. 있음를 들어 제출 작업을 저장 단추로 사용하여 나중에 흐름에서 사용할 수 있도록 제공된 사용자 데이터를 수집하고 저장합니다.
노트
작업은 다른 유형의 양식 요소 뒤에 오는 양식 구조의 끝에만 추가할 수 있습니다.
다른 요소와 마찬가지로 각 작업에는 고유하게 설명하는 ID가 있습니다. 작업이 선택되면 해당 ID가 ButtonPressed 변수에 저장됩니다.
양식에 여러 작업이 포함된 경우 이 변수와 조건을 사용하여 어느 것이 눌렸는지 확인하고 각 시나리오에 대해 다른 기능을 구현합니다. 이 작업을 구현하는 방법에 대한 자세한 내용은 사용자 지정 양식 처리를 참조하세요.
다음 스크린샷은 흐름이 실행될 때 이전에 구성된 사용자 지정 양식이 어떻게 보이는지 보여줍니다.
사용자 지정 양식 요소
| 요소 이름 | 형식 | 사양 | 레이아웃 속성 | 유효성 검사 속성 | 스타일 속성 | 배경 이미지 |
|---|---|---|---|---|---|---|
| 사용자 지정 양식 | 상위 대화 상자 | 제목 | 최소 높이(픽셀), 세로 콘텐츠 정렬 | URL, 채우기 모드, 가로 맞춤, 세로 맞춤 | ||
| 문자 입력 | 입력 | ID, 레이블, 기본값, 여러 줄, 스타일, 최대 길이 | 간격, 구분 기호, 높이 | 유효성 검사 필요, 오류 메시지, 패턴 | ||
| 숫자 입력 | 입력 | ID, 레이블, 기본값, 최소값, 최대값 | 간격, 구분 기호, 높이 | 유효성 검사 필요, 오류 메시지 | ||
| 날짜 입력 | 입력 | ID, 레이블, 기본값, 최소값, 최대값 | 간격, 구분 기호, 높이 | 유효성 검사 필요, 오류 메시지 | ||
| 시간 입력 | 입력 | ID, 레이블, 기본값, 최소값, 최대값 | 간격, 구분 기호, 높이 | 유효성 검사 필요, 오류 메시지 | ||
| 토글 입력 | 입력 | ID, 레이블, 제목, 기본값, 켜짐 시 값, 꺼짐 시 값 | 간격, 구분 기호, 높이 줄 바꿈 | 유효성 검사 필요, 오류 메시지 | ||
| 선택 집합 입력 | 입력 | ID, 레이블, 기본값, 다중 선택 허용, 스타일, 선택 | 간격, 구분 기호, 높이, 줄 바꿈 | 유효성 검사 필요, 오류 메시지 | ||
| 파일 입력 | 입력 | ID, 레이블, 기본값 | 간격, 구분 기호, 높이 | 유효성 검사 필요, 오류 메시지 | ||
| 텍스트 블록 | 요소 | ID, 텍스트 | 간격, 구분 기호, 가로 맞춤, 높이, 줄 바꿈, 최대 줄, 최대 너비 | 글꼴 유형, 크기, 두께, 색상, 미세 조정, 기울임꼴, 취소선 | ||
| 이미지 | 요소 | ID, URL, 대체 텍스트 | 간격, 구분 기호, 가로 맞춤, 높이, 높이(픽셀), 너비(픽셀), 크기 | 스타일, 배경색 | ||
| 제출 | 작업 | ID, 제목, 제공된 입력 무시 | ||||
| URL 열기 | 작업 | ID, 제목, URL |
사용자 지정 양식 요소 속성
| 속성 이름 | 선택 항목 | 수락 | 기본값 | 설명 |
|---|---|---|---|---|
| 다중 선택 허용 | 사용 불가 | 부울 값 | False | 다중 선택을 선택할 수 있습니다. |
| 대체 텍스트 | 있음 | 텍스트 값 | 이미지를 설명하는 대체 텍스트 | |
| 배경색 | 있음 | 텍스트 값 | 투명한 이미지에 배경을 적용합니다. 이 속성은 이미지 스타일을 존중합니다. 이 속성에서는 16진수 값만 사용할 수 있습니다. | |
| 선택 | 네 | 제목 및 값 | 선택 집합에서 사용할 선택 항목을 설명합니다. 제목(표시할 텍스트)과 값(선택 항목에 대한 원시 값)으로 구성됩니다. | |
| 색상 | 사용 불가 | 기본값, 어둡게, 밝게, 액센트, 양호, 경고, 주의 | 기본값 | 텍스트 색상 제어 |
| 기본값 | 있음 | 텍스트 값, 숫자 값 | 입력 요소의 기본값 | |
| 오류 메시지 | 있음 | 텍스트 값 | 입력이 잘못되었을 때 표시할 오류 메시지 | |
| 채우기 모드 | 사용 불가 | 덮기, 가로로 반복, 세로로 반복, 반복 | 이미지가 영역을 채우는 방법을 설명합니다. | |
| 글꼴 유형 | 사용 불가 | 기본값, 고정 폭 | 기본값 | 렌더링에 사용할 글꼴 유형 |
| 높이 | 사용 불가 | 자동, 늘이기, 픽셀 | 자동 | 요소의 높이를 지정합니다. '픽셀' 옵션은 이미지 요소에만 사용할 수 있습니다 |
| 높이(픽셀) | 아니요 | 숫자 값 | 0 | 원하는 이미지 높이를 지정합니다. 이미지가 정확한 높이에 맞게 왜곡됩니다. 이것은 'Size' 속성을 재정의합니다. 기본값 0은 특정 높이가 지정되지 않음을 결정합니다 |
| 가로 맞춤 | 사용 불가 | 왼쪽, 가운데, 오른쪽 | 텍스트 블록: 왼쪽 이미지: 왼쪽 |
이 요소가 가로로 배치되는 방식을 제어합니다. 사용자 지정 양식의 경우 배경 이미지가 잘려야 하거나 반복 채우기 모드를 사용하는 경우 배경 이미지를 정렬하는 방법을 설명합니다. |
| ID | 아니요 | 텍스트 값 | 요소에 따라 다릅니다. | 값의 고유 식별자. 제출 조치가 수행될 때 수집된 입력을 식별하는 데 사용됩니다. 유효하지 않은 ID를 일시적으로 사용하고 양식 디자이너를 닫을 경우 마지막으로 사용한 유효한 ID가 적용됩니다. |
| 제공된 입력 무시 | 사용 불가 | 부울 값 | False | 사용 설정되면 이 작업은 취소 단추로 작동하여 선택한 입력을 저장하지 않고 양식을 닫습니다. |
| 이탤릭체 | 사용 불가 | 부울 값 | False | 사용 설정되면 텍스트를 기울임꼴로 표시합니다. |
| 레이블 | 있음 | 텍스트 값 | 이 입력의 레이블 | |
| 최대 길이 | 아니요 | 숫자 값 | 0 | 수집할 문자의 최대 수를 지정합니다. 기본값 0은 최대 길이가 지정되지 않음을 결정합니다 |
| 최대 줄 | 아니요 | 숫자 값 | 0 | 표시할 최대 줄 수를 지정합니다. 기본값 0은 최대 줄이 지정되지 않음을 결정합니다 |
| 최대값 | 네 | 텍스트 값 | 최대값 힌트. 날짜 및 시간 입력의 경우 값은 시스템의 지역 형식으로 표현되어야 합니다 | |
| 최대 너비 | 아니요 | 숫자 값 | 0 | 텍스트 블록의 최대 너비(픽셀)를 지정합니다. 기본값 0은 최대 너비가 지정되지 않음을 결정합니다 |
| 최소 높이(픽셀) | 아니요 | 숫자 값 | 0 | 양식의 최소 높이를 지정합니다. 기본값 0은 최소 높이가 지정되지 않음을 결정합니다 |
| 최소값 | 네 | 텍스트 값 | 최소값 힌트. 날짜 및 시간 입력의 경우 값은 시스템의 지역 형식으로 표현되어야 합니다 | |
| 여러 줄 | 사용 불가 | 부울 값 | False | 사용 설정되면 여러 줄 입력을 허용합니다. |
| 패턴 | 있음 | 텍스트 값 | 이 텍스트 입력의 필수 형식을 나타내는 정규식 | |
| 구분 기호 | 사용 불가 | 부울 값 | False | 사용 설정되면 요소 맨 위에 구분 선을 그립니다 |
| 크기 | 사용 불가 | 텍스트 블록: 기본, 작게, 중간, 크게, 매우 크게 이미지: 자동, 스트레치, 소형, 중형, 대형 |
텍스트 블록: 기본값 이미지: 자동 |
텍스트 또는 이미지의 크기를 제어합니다. |
| 간격 | 사용 불가 | 기본, 없음, 작게, 중간, 크게, 매우 크게, 안쪽 여백 | 기본값 | 이 요소와 앞선 요소 사이의 간격을 제어합니다. |
| 취소선 | 사용 불가 | 부울 값 | False | 사용 설정되면 텍스트에 줄을 긋습니다. |
| 스타일 | 사용 불가 | 문자 입력: 문자, 전화, URL, 이메일 선택 세트 입력: 컴팩트, 확장 이미지: 기본 사용자 |
텍스트 입력: 텍스트 선택 집합 입력: 간결함 이미지: 기본값 |
텍스트 힌트, 선택 세트 또는 이미지의 스타일 |
| 미세 조정 | 사용 불가 | 부울 값 | False | 사용 설정되면 텍스트의 색조를 약간 낮춰 덜 두드러지게 표시합니다. |
| 문자 | 있음 | 텍스트 값 | 새로운 텍스트 블록 | 표시할 텍스트 |
| 제목 | 있음 | 텍스트 값 | 토글 입력: 새로운 토글 입력 제출: 확인 |
사용자 지정 양식의 제목 또는 이 작업을 나타내는 단추의 토글 또는 레이블 |
| URL | 있음 | 텍스트 값 | 이미지의 URL(이미지 요소 및 사용자 정의 양식의 경우) 또는 열려는 URL(URL 열기 작업의 경우) | |
| 유효성 검사 필요 | 있음 | 부울 값 | False | 이 입력이 필수인지 여부를 결정합니다. |
| 해제 시 값 | 있음 | 텍스트 값 | False | 토글이 해제되었을 때의 값 |
| 설정 시 값 | 있음 | 텍스트 값 | True | 토글이 설정되었을 때의 값 |
| 세로 맞춤 | 사용 불가 | 위쪽, 가운데, 아래쪽 | 이미지를 잘라야 하는 경우 또는 반복 채우기 모드를 사용하는 경우 이미지가 정렬되는 방법을 설명합니다. | |
| 세로 콘텐츠 맞춤 | 사용 불가 | 위쪽, 가운데 아래쪽 | 상단 | 컨테이너 내에서 콘텐츠를 수직으로 정렬하는 방법을 정의합니다. 고정 높이 양식 또는 최소 높이가 지정된 양식에만 해당 |
| 두께 | 사용 불가 | 기본, 더 밝게, 더 굵게 | 기본값 | 텍스트 두께를 제어합니다. |
| 너비(픽셀) | 아니요 | 숫자 값 | 0 | 이미지의 원하는 화면 너비입니다. 이것은 'Size' 속성을 재정의합니다. 기본값 0은 특정 너비가 지정되지 않음을 결정합니다 |
| 줄 바꿈 | 사용 불가 | 부울 값 | False | 사용 설정된 경우 텍스트 줄 바꿈을 허용합니다. 그렇지 않으면 텍스트가 잘립니다. |
알려진 문제 및 제한 사항
문제: URL 속성에 백분율 문자가 포함된 경우 미리 보기 창이 있음상대로 작동하는 것처럼 보이지만 잘못된 값 유효성 검사 오류가 발생합니다.
해결 방법: 이 문제는 Power Automate가 백분율 문자를 변수 또는 표현식으로 해석하려고 하기 때문에 발생합니다. 이 경우를 해결하려면 흐름의 앞부분에서 변수에 URL을 저장하고 백분율 문자를 이스케이프한 다음 URL 속성에서 해당 변수를 사용합니다. 미리 보기에는 이미지가 표시되지 않지만 런타임 중에 표시됩니다.