입력에 대한 입력 양식 화면 속성
입력 양식 화면에서 다양한 유형의 입력을 사용할 수 있으며, 다양한 속성을 사용하여 입력을 구성할 수 있습니다.
입력 속성을 사용하여 모양을 정의하고 입력에 제한 사항을 설정합니다. 예를 들면 최솟값과 최댓값 설정 또는 입력 값을 백분율로 표시 등이 있습니다.
일반 속성
입력 유형에 관계없이 모든 입력 양식 화면에서 이 속성을 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| DescriptionRenderType | 입력 설명의 렌더링 유형을 정의합니다. html: HTML 태그를 사용하여 입력하는 설명 필드에서 텍스트의 서식을 지정할 수 있습니다. |
| DataSourceId | 입력 값을 로드하는 데이터 소스 메커니즘을 생성할 때마다 이 속성을 정의합니다. 자세한 내용은 데이터 소스 문서를 참조하십시오. 주: 이 속성은 서명 입력에서 지원되지 않습니다. |
| ElementIdentifier | 입력 값을 로드하는 데이터 소스 메커니즘을 생성할 때마다 이 속성을 정의합니다. 자세한 내용은 데이터 소스 문서를 참조하십시오. 주: 이 속성은 서명 입력에서 지원되지 않습니다. |
첨부 파일 입력
|
사용자가 입력 양식 화면에 파일을 첨부할 수 있도록 첨부 파일 입력을 사용합니다. 첨부 파일 입력에는 스크립팅된 작업 항목과 파일을 업로드하기 위한 actionResult 객체가 필요합니다.
주: 첨부 파일 입력은 스크립팅된 작업에만 지원됩니다. |
 |
(function WriteBackAction(parm_input, parm_variable, actionResult) {
//other write-back inputs and variables here
actionResult.addAttachment("attach", "incident", gr.getUniqueValue()); //where "attach" is the input name from above screenshot, and “incident” is the table name
})(parm_input, parm_variable, actionResult);
- 첨부 파일 소스를 사용자로 제한
- 첨부 파일의 출처를 제한하여 이미지가 다음 중 하나 또는 모두에서 제공되도록 할 수 있습니다.
- 카메라를 통한 현장
- 사용자의 전화 갤러리에서
- 사용자의 파일 시스템에서
입력 속성 기록에서 HiddenAttachmentSources를 선택합니다. 값 필드에서 카메라, 파일 또는 갤러리를 선택한 다음 저장을 선택합니다. 둘 이상의 첨부 파일 소스를 포함하려면 이 프로세스를 반복합니다. 자세한 내용은 사용자가 사용할 수 있는 첨부 파일 소스 정의 문서를 참조하십시오.
속성 설명 HiddenAttachmentSources 이미지를 소싱하지 않을 위치를 결정합니다. 값 필드에서 다음 소스 값(카메라, 파일 또는 갤러리) 중 하나를 선택합니다. 주:둘 이상의 소스에서 이미지와 파일을 가져오지 않도록 하려면 현재 구성 중인 속성을 저장한 후 속성을 추가합니다 HiddenAttachmentSources .
바코드 입력
바코드 입력을 사용하여 하나 또는 여러 개의 바코드를 스캔합니다. 바코드는 숫자 형태와 다양한 너비의 평행선 패턴으로 된 기계 판독 가능한 코드입니다. 이 코드는 제품, 부품 또는 자산과 같은 항목을 식별하는 데 사용됩니다. 이 입력 유형을 사용하면 모바일 앱을 사용하여 인스턴스에 항목에 ServiceNow 대한 정보를 입력할 수 있습니다.
- 바코드 입력은 단일 스캔, 다중 스캔 또는 그룹화된 스캔에 대해 구성할 수 있습니다. 단일 스캔을 사용하면 사용자가 한 번만 스캔할 수 있습니다. 이 경우 사용자는 스캔 아이콘을 눌러 다시 스캔해야 하며, 이 경우 스캔 값이 지워집니다. 단일 스캔 바코드 입력에 대한 속성을 구성할 필요가 없습니다.
- 다중 스캔 입력은 MaxEntries 속성을 사용하여 구성할 수 있습니다. 입력 양식 화면 바코드 입력이 속성으로 MaxEntries 구성된 경우 사용자는 스캔 인터페이스를 종료하지 않고 여러 바코드를 순차적으로 빠르게 스캔할 수 있습니다.
- 그룹화된 스캔은 세트로 그룹화해야 하는 자산과 연결된 여러 바코드를 스캔하도록 구성할 수 있습니다. 그룹화된 바코드 입력을 구성하려면 바코드 입력만 있는 입력 양식 화면에서 바코드 섹션을 생성해야 합니다. 그런 다음 사용자가 여러 바코드 그룹을 스캔할 수 있도록 그룹화된 바코드 섹션에 대해 섹션 MaxEntries 속성을 구성해야 합니다.
| 속성 | 설명 |
|---|---|
| MaxEntries | 다중 스캔 및 여러 바코드 그룹을 구성하는 데만 사용됩니다. 사용자가 한 번에 스캔할 수 있는 최대 바코드 수를 설정합니다. 예를 들어 사용자가 5번 다시 검색할 수 있도록 값을 5 로 설정할 수 있습니다. 주: 이 속성은 다중 스캔 바코드 입력에만 사용합니다. 바코드 입력이 단일 스캔용인 경우 속성이 필요하지 않습니다. |
바코드 입력으로 입력 양식 화면을 만드는 방법에 대한 자세한 내용은 해당 그룹화된 스캔 바코드 입력으로 입력 양식 화면 구성문서를 참조하십시오단일 및 다중 스캔 바코드 입력으로 입력 양식 화면 구성.
부울 입력
|
True 또는 False 값이 있는 입력에 부울 입력을 사용합니다. 확인란 또는 토글 스위치로 나타나도록 부울 입력을 구성할 수 있습니다. |
 |
다음과 같은 속성을 부울 입력에 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| RenderType | 부울 입력에 대한 렌더링 유형을 지정합니다.
|
선택 입력
|
선택 입력을 사용하여 사용자에게 선택 옵션을 제공합니다. 수동으로 이러한 선택 항목을 만들거나 기존 테이블과 필드를 사용하여 선택 항목을 제공할 수 있습니다. 사용자가 단일 선택 항목 또는 여러 선택 항목을 선택할 수 있도록 선택 입력을 구성합니다. 범주에서 둘 이상의 칩을 선택하는 옵션은 칩에 + 기호로 표시됩니다. 사용자가 단일 입력 양식 화면에서 사용 가능한 모든 옵션을 볼 수 있도록 표시할 칩 수를 정의합니다. 표시할 정의된 칩 수가 정의된 양을 초과하면 모두 보기 버튼이 표시됩니다. 모두 보기 버튼을 탭하여 모든 옵션이 나열된 페이지를 엽니다. |
|
다음과 같은 속성을 선택 입력에 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| MultiSelect | 사용자가 입력에 대해 여러 선택 항목을 선택할 수 있도록 하는 옵션입니다. 값은 true 또는 false여야 합니다. 다중 선택 옵션은 칩에 "+" 기호로 표시됩니다. |
| Table | 선택 필드가 있는 테이블입니다. 주: 수동으로 선택 항목을 만드는 대신 기존 테이블과 필드의 선택 항목을 사용하려면 이 옵션을 사용합니다. 속성을 사용하여 Field 이 테이블에서 필드를 선택해야 합니다. |
| Field | 선택 항목이 있는 필드입니다. 주: 수동으로 선택 항목을 만드는 대신 기존 테이블과 필드의 선택 항목을 사용하려면 이 옵션을 사용합니다. 이 속성에 정의된 필드는 속성에 정의된 Table 테이블에 있어야 합니다. |
| Inline | 선택 입력을 표시하는 방법을 선택하는 옵션입니다. 기본적으로 이 값은 false이며, 이는 선택 항목이 동일한 화면에 있으므로 별도의 화면으로 이동할 필요가 없음을 의미합니다. 시각적 예제는 선택 입력 소개의 이미지를 참조하세요. true를 선택하면 사용자가 선택한 후 추가 화면으로 이동해야 하는 목록 유형 옵션이 표시됩니다. |
| InlineMaxItems | 입력 양식 화면 섹션 내에 표시할 칩 수를 정의하는 옵션입니다. 값 필드에서 다음 입력을 사용할 수 있습니다.
|
| RenderType | 선택 옵션을 선택 입력에 대한 이미지로 렌더링하는 옵션입니다. 값은 이미지여야 합니다. |
사용자 지정 맵 입력
|
사용자 지정 맵 입력을 사용하여 모바일 앱의 내부 맵에 링크를 추가합니다. 사용자는 이러한 맵을 사용하여 책상, 회의실, 사물함 등의 자원까지 길을 찾고 예약할 수 있습니다. 또한 관리자는 사용자 지정 맵 입력의 정렬 및 필터링을 활성화하는 쿼리 조건으로 매개변수화된 데이터 항목을 구성할 수도 있습니다. 중요사항:
매개변수화된 데이터 항목을 지원하는 사용자 지정 맵 입력은 속성 ScreenId 만 사용해야 합니다. 매개변수형 데이터 항목을 지원하는 사용자 지정 맵 입력에 다른 유형의 속성을 사용하지 마십시오. 고급 참조 한정자를 사용하여 매개변수화된 데이터 항목을 사용하는 기존 사용자 지정 맵 입력을 수정하는 경우 속성 ScreenId 만 사용하고 다른 모든 속성은 제거합니다. |
|
| 속성 | 설명 |
|---|---|
| CustomMapConfigId | sys_sg_custom_map_config 테이블의 sys_id입니다. |
| CustomMapDefaultProviderId | sys_sg_custom_map_provider 테이블에 있는 제공자 기록의 sys_id입니다. |
| CustomMapInputs | sys_sg_input 테이블에 있는 층의 sys_id입니다. 이 값은 JSON 배열로 입력해야 합니다. |
| ScreenId | 사용자 지정 맵 입력을 정렬하고 필터링하는 데 사용되는 매개변수형 데이터 항목의 sys_id입니다. 중요사항: 이 속성은 다른 사용자 지정 맵 입력 속성과 함께 사용할 수 없습니다. 사용자 지정 맵 입력과 ScreenId 함께 속성을 사용하는 경우 입력에 다른 속성을 사용하지 마십시오. |
| TargetTable | sn_wsd_core_space로 설정합니다. |
날짜/시간 입력
|
사용자가 날짜 및 시간 값을 입력할 수 있도록 날짜/시간 입력을 사용합니다. 날짜와 시간 또는 날짜만 있는 입력을 구성할 수 있습니다. |
 |
다음과 같은 속성을 날짜/시간 입력에 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| RenderType | 날짜/시간 입력에 대한 렌더링 유형을 지정합니다.
|
| IncludeTimezone |
입력이 추가되는 모바일 장치의 시간대입니다. 값은 true 또는 false여야 합니다. true로 설정하면 모바일 클라이언트는 날짜 및 시간 값과 함께 장치 시간대 정보를 다음 형식으로 백엔드 인스턴스에 보냅니다. YYYY-MM-DDThh:mm:ss.sssTZD 주:
장치 시간대는 플랫폼에 구성된 사용자 프로파일 시간대와 다릅니다. 이 속성이 구성되지 않은 경우 모바일 클라이언트는 날짜/시간 입력 값에 장치 시간대 정보를 포함하지 않습니다. 이 동작이 기본값입니다. 날짜/시간 입력 값은 다음 형식입니다. YYYY-MM-DD hh:mm:ss 다양한 작업 유형에 대한 날짜/시간 입력의 IncludeTimezone 속성을 설정하는 방법에 대한 자세한 내용은 문서를 다양한 작업 항목 유형에 대한 날짜/시간 입력 설정참조하십시오. 작업 항목 유형에 대한 자세한 내용은 다음 문서를 참조하십시오 작업 항목 구성. |
| MaxRangeDays |
날짜/시간 입력이 추가될 때 미래 날짜를 선택할 수 있는지 여부를 결정하는 선택적 속성입니다. 이 특성은 양수 및 음의 정수 값을 모두 지원합니다. 0으로 설정하면 MaxRangeDays 사용자가 미래 날짜를 선택할 수 없으며 현재 또는 과거 날짜로 제한됩니다. 주:
MaxRangeDays, MaxRangeHours및 와 함께 MinRangeDays사용할 수 있습니다MinRangeHours. |
| MinRangeDays |
날짜/시간 입력이 추가될 때 과거 날짜를 선택할 수 있는지 여부를 결정하는 선택적 속성입니다. 이 특성은 양수 및 음의 정수 값을 모두 지원합니다. 0으로 설정하면 MinRangeDays 사용자가 과거 날짜를 선택할 수 없으며 현재 또는 미래 날짜로 제한됩니다. 주:
MinRangeDays, MaxRangeHours및 와 함께 MaxRangeDays사용할 수 있습니다MinRangeHours. |
| MaxRangeHours |
날짜/시간 입력이 추가될 때 미래 시간을 선택할 수 있는지 여부를 결정하는 선택적 속성입니다. 이 특성은 양수 및 음의 정수 값을 모두 지원합니다. 0으로 설정하면 MaxRangeHours 사용자가 미래 날짜 시간을 선택할 수 없으며 현재 또는 과거 날짜 시간으로 제한됩니다. 주:
MaxRangeHours, MinRangeDays및 와 함께 MaxRangeDays사용할 수 있습니다MinRangeHours. |
| MinRangeHours |
날짜/시간 입력이 추가될 때 지난 시간을 선택할 수 있는지 여부를 결정하는 선택적 속성입니다. 이 특성은 양수 및 음의 정수 값을 모두 지원합니다. 0으로 설정하면 MinRangeHours 사용자가 과거 날짜 시간을 선택할 수 없으며 현재 또는 미래 날짜 시간으로 제한됩니다. 주:
MinRangeHours, MinRangeDays및 와 함께 MaxRangeDays사용할 수 있습니다MaxRangeHours. |
숫자 입력
|
사용자가 숫자 값을 입력할 수 있도록 숫자 입력을 사용합니다. 선택 사항인 최솟값과 최댓값을 정의하여 입력에 대한 숫자 범위를 지정합니다. 선택적으로 숫자 입력을 백분율로 표시하도록 구성할 수 있습니다. 기본적으로 숫자 입력은 소수를 지원합니다. 숫자에 대한 기본 상자 입력을 사용하려면 입력 기록 내에서 모든 필수 필드를 작성하고 입력 유형 필드에서 번호를 선택합니다. |
 |
| 속성 | 설명 |
|---|---|
| CustomErrorMessage | 지정할 수 있는 사용자 지정 오류 메시지를 설정합니다. 이 메시지는 연결된 UI 규칙 조건이 충족될 때 표시됩니다. |
| Max | 입력의 최대값을 지정합니다. |
| Min | 입력의 최소값을 지정합니다. |
| RenderType | 숫자 입력에 대한 렌더 유형을 지정합니다.
주: 렌더링 유형과 함께 사용할 수 있는 속성을 보여 주는 표는 문서를 참조하십시오 번호 렌더링 유형 및 호환 가능한 입력 속성. |
| SkipValidationWhenHidden | 주: true 또는 false로 설정할 수 있습니다. 기본적으로 false 로 설정되어 있으며, 이는 기본적으로 연결된 UI 규칙 확인이 숨겨진 입력에서 실행됨을 의미합니다. 숨겨진 입력에 대한 확인을 건너뛰려는 경우에만 이 값을 예 로 설정합니다.이 속성은 라인 및 백분율 렌더링 유형에만 사용할 수 있습니다. |
| 속성 | 설명 |
|---|---|
| DefaultValue |
사용자가 슬라이더를 처음 볼 때 표시되는 값입니다. 값을 입력하지 않으면 표시되는 값은 0입니다. 기본값은 최소값과 최대값 사이여야 합니다. 주:
이 정의된 값은 우선권을 갖는 로딩 메커니즘이 구성되지 않는 한 시작점입니다. 입력 양식 화면의 로딩 메커니즘 문서를 참조하십시오. |
| StepSize | 슬라이더의 각 단계 크기입니다. 단계는 최대값과 최소값 사이에서 나눌 수 있는 숫자여야 합니다. 예를 들어 최소 숫자는 20이고 최대 숫자는 80이며 StepSize는 2, 5 또는 10과 같은 숫자일 수 있습니다. |
| ReferencePoint | true로 설정하면 마커가 슬라이더에 추가되어 사용자에게 시각적 참조점을 제공합니다. 주: 시각적 명확성을 위해 이 입력 특성은 VisualStepsEnabled 입력 특성과 함께 사용하면 안 됩니다. |
| VisualStepsEnabled | true로 설정하면 슬라이더에 지정된 StepSize 입력 특성에 따라 시각적 증분이 표시됩니다. 주: 시각적 명확성을 위해 이 입력 특성은 입력 특성 ReferencePoint와 함께 사용하면 안 됩니다. |
| EnforceStepSize | true로 설정하면 사용자가 숫자 상자에 StepSize 값과 일치하지 않는 값을 입력할 수 없습니다. |
| Decoration | 사용자가 섹션을 탭하거나 값을 입력할 때 나타나는 해당 레이블로 슬라이더의 섹션을 정의합니다. 각 섹션은 시각적 표현을 돕기 위해 특정 색상과 연결할 수 있습니다. 자세한 내용은 숫자 입력에 대한 슬라이더 옵션 구성 문서를 참조하십시오. |
순위 입력
|
사용자가 기본 설정 또는 우선순위에 따라 사용 가능한 선택 항목을 정렬할 수 있도록 순위 입력을 사용합니다. 사용자는 표시되는 선택 항목을 누르고 끌어서 놓습니다. 순위 입력에 대한 선택 항목은 수동으로 정의해야 합니다. |
이 항목에 나열된 일반 속성 외에 순위 입력에 대한 속성이 없습니다.
참조 입력
테이블의 필드를 참조하는 입력에 참조 입력을 사용합니다. 이러한 입력은 인스턴스의 양식에서 참조 필드 와 같은 역할을 합니다. 조건, 참조 한정자, 검색 옵션을 사용하여 참조 입력을 구성하면 사용자가 필요한 것을 빠르게 찾을 수 있습니다.
선택 사항인 검색 옵션은 "텍스트용" 키워드 검색을 사용하며, 모바일 뷰 내의 요소를 검색할 수 있습니다.
다음과 같은 속성을 참조 입력에 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| SourceTable | 참조 한정자에 대한 소스 테이블입니다. |
| SourceFieldName | 소스 테이블에서 참조된 필드의 필드 이름입니다. |
| TargetTable | 참조 한정자의 대상으로 지정할 테이블입니다. |
다음 추가 속성은 선택 사항입니다.
| 속성 | 설명 |
|---|---|
| MultiSelect | 사용자가 입력에 대해 여러 선택 항목을 선택할 수 있도록 하는 옵션입니다. 값은 true 또는 false여야 합니다. |
| MobileViewId | 참조 목록 항목에 사용할 모바일 뷰 ID(뷰 구성)입니다. |
| EnableSearch | 검색 창을 표시하는 옵션입니다. 값은 true 또는 false여야 합니다. |
| SearchPlaceholder | 검색 창에 자리 표시자로 나타나는 텍스트입니다. |
| Conditions | 참조 목록에 조건을 적용하기 위해 인코딩된 쿼리를 입력합니다. 이러한 쿼리를 만드는 방법에 대한 자세한 내용은 인코딩된 쿼리 문자열을 참조하세요. |
| SearchType | 검색에 사용되는 쿼리를 정의합니다. 값은 starts_with 또는 contains가 될 수 있습니다. 이 속성이 구성되지 않은 경우 인스턴스는 기본적으로 표시 레이블 열에서 을 사용합니다 starts_with . |
이 예는 인시던트 [incident] 테이블의 할당 대상 필드에 대해 입력 양식 화면 입력을 생성합니다. 이 입력을 생성하려면 3가지 필수 속성인 TargetTable, SourceTable 및 SourceFieldName을 사용해야 합니다.
- 사용자는 사용자 목록에서 할당할 인시던트를 선택합니다. 따라서 TargetTable 속성을 sys_user로 설정합니다.
- 인시던트 기록에 사용자를 추가하므로 SourceTable 속성이 인시던트로 설정됩니다.
- SourceFieldName을 assigned_to로 설정하여 선택한 사용자가 할당 대상 필드에 할당되도록 합니다.
서명 입력
서명 입력을 사용하여 입력 양식 화면에서 전자 서명을 캡처합니다. 서명 입력은 입력 양식 화면 섹션 또는 페이지에 포함할 수 있습니다.
서명 입력과 함께 선택적 IsOverlay 속성을 사용할 수 있습니다. 기본적으로 서명은 전체 모달 창에서 렌더링됩니다. IsOverlayValue 특성을 true로 설정하면 서명이 반 모달 창에서 렌더링됩니다.
| 속성 | 설명 |
|---|---|
| IsOverlay | 서명 입력이 반 모달 창에서 열리는지 여부를 설정합니다. 값을true 또는 false로 설정할 수 있습니다. true 값은 절반 모달 창에서 열리도록 서명을 구성합니다. 주: 서명 입력이 페이지의 유일한 입력으로 구성되고 isOverlay 특성이 trueisOverlay로 설정된 경우 특성이 무시되고 서명 입력이 전체 화면에 표시됩니다. |
문자열 입력
|
텍스트 입력에 문자열 입력을 사용합니다. 이 입력에 대해 최대 문자 길이를 정의할 수 있습니다. |
 |
다음과 같은 속성을 문자열 입력에 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| Inline | 입력 인라인을 표시하거나 별도의 모달에서 입력을 여는 옵션입니다. 값은 true 또는 false여야 합니다. |
| MaxLength | 입력 값의 최대 문자 수입니다. |
| ShowDeleteAll | 입력 필드에 텍스트가 있을 때마다 삭제 버튼을 표시하는 옵션입니다. 이 값은 true 또는 false여야 하며 기본적으로 false 로 설정됩니다. |
| ConfirmDeletion | 를 사용할 ShowDeleteAll때 텍스트가 삭제되기 전에 사용자에게 확인 메시지를 표시하는 옵션입니다. 값은 true 또는 false여야 하며 기본적으로 true 로 설정됩니다. |
화면 입력
화면 입력을 사용하여 목록 화면을 선택 가능한 목록 입력으로 변환합니다. 사용자는 여러 목록 항목을 선택하고 캐시에 대한 쓰기 저장 작업을 수행할 수 있습니다.
다음과 같은 속성을 화면 입력에 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| ScreenId | 선택 가능한 목록 입력에 사용되는 목록 화면을 구성합니다. 값은 목록 화면의 sys_id입니다. |
| GetDataFromParent | 상위 화면에서 선택 가능한 목록 입력으로 목록 화면을 변환합니다. 상위 목록 화면에 적용되는 필터는 화면 입력으로 이월됩니다. 이 속성을 사용하려면 true를 입력하십시오. 기본적으로 인스턴스에서는 꺼져 있습니다. |