모바일 GlideForm(g_form) - 클라이언트

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 모바일 GlideForm(g_form) API는 모바일 플랫폼에서 양식으로 작업할 수 있는 메서드를 제공합니다.

    모바일 장치를 대상으로 하는 모든 스크립트에서 이러한 메서드를 사용합니다.

    MobileGlideForm(g_form) - addDecoration(문자열 필드 이름, 문자열 아이콘, 문자열 텍스트)

    필드 옆에 장식 아이콘을 추가합니다.

    표 1. 매개변수
    이름 유형 설명
    fieldName 문자열 필드 이름입니다.
    아이콘 문자열 필드 옆에 표시할 글꼴 아이콘입니다.
    텍스트 문자열 아이콘의 텍스트 제목(화면 판독기에 사용됨)입니다.
    표 2. 반환
    유형 설명
    void

    이 예시에서는 호출자 옆에 VIP 아이콘을 추가합니다.

    function onChange(control, oldValue, newValue, isLoading) {
          // if the caller_id field is not present, then we can't add an icon anywhere
          if (!g_form.hasField('caller_id'))
              return;
          
          if (!newValue)
             return;
          
          g_form.getReference('caller_id', function(ref) {
          g_form.removeDecoration('caller_id', 'icon-star', 'VIP');
          
          if (ref.getValue('vip') == 'true')
               g_form.addDecoration('caller_id', 'icon-star', 'VIP');			
          });
          }

    MobileGlideForm(g_form) - getLabel(문자열 필드 이름)

    양식 레이블 텍스트를 가져옵니다.

    표 3. 매개변수
    이름 유형 설명
    fieldName 문자열 필드 이름입니다.
    표 4. 반환
    유형 설명
    문자열 레이블 텍스트입니다.
    if (g_user.hasRole('itil')) {
          var oldLabel = g_form.getLabel('comments');
          g_form.setLabel('comments', oldLabel + ' (Customer visible)');
          }

    MobileGlideForm (g_form) - hasField(String fieldName)

    필드가 양식에 있는지 확인합니다.

    현존한다는 것은 그것이 보일 수 있다는 것을 의미하는 것이지, 보인다는 것을 의미하는 것이 아니다.

    표 5. 매개변수
    이름 유형 설명
    fieldName 문자열 찾을 필드입니다.
    표 6. 반환
    유형 설명
    부울 필드가 양식에 있으면 True입니다. false입니다. 양식에 있다는 것은 필드가 g_form의 일부임을 의미합니다. 여전히 숨겨졌거나, 읽기 전용이거나, 필수이거나, 유효하지 않을 수 있습니다.

    이 예에서는 assignment_group 필드가 양식에 있는 경우 assigned_to 필드를 필수 필드로 만듭니다.

    if (g_form.hasField('assignment_group'))
          g_form.setMandatory('assigned_to', true);
        

    MobileGlideForm (g_form) - removeDecoration(String fieldName, String icon, String text)

    필드 옆에 있는 장식 아이콘을 제거합니다.

    표 7. 매개변수
    이름 유형 설명
    fieldName 문자열 필드 이름입니다.
    아이콘 문자열 제거할 아이콘입니다.
    텍스트 문자열 아이콘의 텍스트 제목입니다.
    표 8. 반환
    유형 설명
    void
    function onChange(control, oldValue, newValue, isLoading) {
          // if the caller_id field is not present, then we can't add an icon anywhere
          if (!g_form.hasField('caller_id'))
               return;
          
          if (!newValue)
               return;
          
          g_form.getReference('caller_id', function(ref) {
               g_form.removeDecoration('caller_id', 'icon-star', 'VIP');
          
               if (ref.getValue('vip') == 'true')
                    g_form.addDecoration('caller_id', 'icon-star', 'VIP');			
          });
          }

    MobileGlideForm (g_form) - setLabel(String fieldName, String label)

    양식 레이블 텍스트를 설정합니다.

    표 9. 매개변수
    이름 유형 설명
    fieldName 문자열 필드 이름입니다.
    레이블 문자열 필드 레이블 텍스트입니다.
    표 10. 반환
    유형 설명
    void

    이 예제에서는 주석 레이블을 변경합니다.

    if (g_user.hasRole('itil')) {
          var oldLabel = g_form.getLabel('comments');
          g_form.setLabel('comments', oldLabel + ' (Customer visible)');
          }