기록 화면의 동적 변수 지원

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분
  • 기록 화면의 스크립트 화면 필드를 사용하여 동적 필드 값을 표시합니다. 스크립트가 실행되어 양식에 표시되기 전에 필드 값을 결정합니다. 스크립트에서 반환된 값은 데이터베이스 값을 대체하지 않습니다. 예를 들어 이메일 내의 동적 변수에 대해 번역된 컨텐츠를 표시할 수 있습니다.

    주:
    기록 화면의 스크립트 필드는 기록 화면 내의 다른 화면 필드의 경우와 마찬가지로 이 필드가 아닌 범위 모바일 앱 작성기내에서 ServiceNow AI Platform 구성됩니다. 구성 단계의 경우 . 기록 화면에 대한 스크립트 필드 구성

    사용 케이스

    설명에 다른 필드의 개인 정보가 포함되어 있더라도 직원은 모바일 장치에서 선호하는 언어로 HR 케이스와 작업을 볼 수 있습니다. 기록 화면의 스크립트 화면 필드를 사용하여 이러한 변환된 동적 값을 모바일 앱에 표시할 수 있습니다. 이는 설명에 개인 정보가 포함된 경우에도 직원이 HR 케이스의 정확한 번역본을 볼 수 있는 옵션을 제공합니다.

    동적 변수 지원 사용 시 주의할 사항

    상세 정보 화면에서 동적 변수를 구성할 때는 다음 고려 사항을 충족해야 합니다.
    • 유형 필드에서 스크립트를 선택합니다.
    • 양식 필드 필드에서 사용할 동적 변수가 포함된 필드를 선택합니다.
    전체 구성 지침은 다음 문서를 참조하십시오 기록 화면에 대한 스크립트 필드 구성.

    실행 스크립트 필드 작업

    다음 스크립트 형식을 사용하여 모바일 앱에 표시할 값을 반환합니다. 스크립트는 두 개의 필수 속성이 있는 JSON 객체를 반환해야 합니다. Type 은 컨텐츠 형식을 정의하고(예제에서는 HTML), Value 에는 표시할 실제 컨텐츠(예에서는 Hello)가 포함됩니다.

    var json = {
    ‘Type’: ‘HTML’,
    ‘Value’: “<p>Hello! </p>”
    }
    
    JSON 스크립트로 작업할 때는 다음 사항을 고려하십시오.
    • 스크립트에는 유형 속성이 포함되어야 합니다.
    • 유형 속성은 자동, 텍스트, 백분율, 날짜 및 HTML 옵션을 사용할 수 있습니다.
    • JSON의 유형 은 필드에서 선택한 유형과 같아야 합니다.
    • 날짜 값은 다음 형식을 사용해야 합니다: yyyy-MM-dd HH:mm:ss

    예제

    예시 1: 개인화된 케이스 설명 표시
    할당된 사용자의 이름을 참조하는 변수가 포함된 HR 케이스 설명 필드를 고려합니다.
    'Hi {current.assigned_to.first_name}, Unable to access the personal details section in payroll portal.'
    그 이후의 스크립트는 변수를 추출하고 실제 필드 값을 검색한 후 개인화된 설명을 반환합니다.
    'Hi Beth, Unable to access the personal details section in payroll portal.'
    스크립트는 유형이 "텍스트"로 설정된 업데이트된 텍스트를 반환합니다. HTML 컨텐츠의 경우 유형을 "HTML"로 설정합니다.
    (function generateScreenField(current) {
        //Type appropriate comment here, and begin script below 
        var description = current.description;
       var regex = /\$\{(.*?)\}/; 
       var match = description.match(regex); 
       var fieldName = match[1]; 
       var element = current.getElement(fieldName); 
       var fieldValue = element.getValue(); 
       var updatedDescription = description.replace(regex, fieldValue); 
       var json = { 
           'Type': 'Text', 
           'Value': updatedDescription 
       }; 
       return json; 
    })(current);
    
    예시 2: 경과 시간을 백분율로 계산
    스크립트는 시작 날짜와 종료 날짜 사이에 경과한 시간의 백분율을 계산하여 상세 정보 화면의 백분율 필드에 표시합니다.
    주:
    백분율 값은 % 기호 없이 숫자 값과 함께 반환됩니다. 기호는 필드 서식에 의해 처리됩니다.
    (function generateScreenField(current) {
        //Type appropriate comment here, and begin script below 
        //Logic to calculate percentage of time elapsed between start and end dates
        //Return percentage without % symbol
       var json = { 
           'Type': 'Percentage', 
           'Value': timeElapsedPercent 
       }; 
       return json; 
    })(current);
    
    예시 3: 날짜 값을 동적으로 계산
    이 스크립트는 날짜를 계산하여 날짜 필드에 표시합니다. 이 스크립트는 필드가 모바일 앱에 표시되면 실행되고, 논리에 따라 날짜를 계산하고, 올바른 형식으로 반환합니다.
    날짜 형식 요구 사항:
    • 날짜만: yyyy-MM-dd(예: 2025-01-29)
    • 날짜 및 시간: yyyy-MM-dd HH:mm:ss(예: 2025-01-29 14:30:00)
    (function generateScreenField(current) {
        //Type appropriate comment here, and begin script below 
        //Logic to calculate value of the Date field
        //Return Date in the following format: yyyy-MM-dd (without Time)
        var json = { 
           'Type': 'Date', 
           'Value': calculatedDate
       };
    (or)
       //Return DateTime in the following format: yyyy-MM-dd HH:mm:ss (with time)
       var json = { 
           'Type': 'DateTime', 
           'Value': calculatedDate
       };
    
       return json; 
    })(current);