푸시 알림 메시지 내용 구성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분
  • 푸시 알림 메시지 내용을 구성하고 알림을 수신할 모바일 애플리케이션을 선택합니다. 중요 경보 알림을 구성하고, 메시지 모양을 사용자 지정하고, 사용자가 알림을 누를 때 사용되는 딥 링크를 결정할 수 있습니다.

    시작하기 전에

    푸시 알림 메시지 내용을 구성하려면 모바일 딥 링크 생성기를 사용하여 딥 링크를 생성해야 합니다. 자세한 내용은 모바일용 딥 링크 문서를 참조하십시오.

    필요한 역할: admin

    이 태스크 정보

    푸시 메시지 내용 양식을 작성하여 다음을 수행합니다.

    • 알림의 이름 지정
    • 알림이 전송되는 모바일 앱 선택
    • 선택적으로 알림 메시지의 모양을 사용자 지정
    • 사용자가 알림을 누를 때 사용되는 딥 링크 결정
    푸시 알림 메시지 내용은 최대 3개의 추가 필드를 지원합니다. 이러한 필드를 선택적 텍스트 슬롯으로 사용하는 경우 슬롯은 소스 기록의 필드를 표시할 수 있습니다.
    주:
    텍스트 슬롯은 모바일 앱에 고정되어 있으므로 위치나 크기를 변경할 수 없습니다. 각 슬롯은 푸시 알림 메시지 내용 스크립트에서 JSON 객체 내의 상태, 식별자설명에 매핑됩니다.

    추가 필드에 모바일 UI 스타일도 사용할 수 있습니다. 스타일 지정에 대한 자세한 내용은 모바일 UI 스타일 문서를 참조하십시오.

    프로시저

    1. 다음으로 이동 모두 > 시스템 통보 > 푸시 > 푸시 메시지 내용.
    2. 새로 만들기를 선택합니다.
    3. 푸시 메시지 내용 양식에서 다음 필드를 채웁니다.
      표 1. 푸시 메시지 내용 양식
      필드 설명
      이름 이 레코드의 문자열 값입니다.
      주:
      이 이름은 알림에 표시되지 않으며, 구성하는 동안 참조용으로만 사용합니다.
      푸시 앱 알림을 보낼 모바일 앱을 참조합니다.
      • 모바일 에이전트ServiceNow 모바일 애플리케이션을 사용합니다.
      • Now Mobile 앱ServiceNow 요청 애플리케이션을 사용합니다.
      푸시 메시지 생성 알림 링크가 포함된 스크립트 블록입니다. 스크립트 블록에서 JSON 객체는 링크를 반환해야 하고 링크 키가 있어야 합니다. 키에는 모바일 딥 링크 생성기를 통해 생성된 해당 딥 링크 값이 있어야 합니다.
      이 예시는 완료된 양식과 적절한 링크 키 및 해당 딥 링크 값이 있는 JSON 객체를 보여줍니다.모든 필드에 내용이 작성되고 링크 키로 표시된 예시 딥 링크가 있는 푸시 메시지 내용 양식.
    4. 옵션: 알림 컨텐츠에 텍스트 슬롯과 같은 필드를 추가합니다.

      푸시 메시지 생성 스크립트 블록에서 각 필드에 대한 레이아웃 필드 객체를 생성합니다.

      1. 알림 레이아웃 객체를 인스턴스화합니다.
        var layoutGen = new global.NotificationLayoutFieldGenerator();
      2. 알림 레이아웃 스크립트를 사용하고 레이아웃 필드를 생성하는 전역 애플리케이션 범위를 포함합니다.
        스크립트 포함에 대한 자세한 내용은 스크립트 포함 단원을 참조하십시오.
        주:
        알림 레이아웃 생성기 스크립트 포함은 수정하지 마십시오.
      3. 레이아웃 필드를 생성합니다.
        각 레이아웃 필드에는 테이블, Sys_Id이 필요합니다.
        주:
        테이블Sys_Id 값은 current.getTableName()current.sys_id를 사용하여 현재 기록에서 직접 가져와야 합니다. 원하는 테이블에 대한 값이 있어야 하고 딕셔너리 열 이름과 정확히 일치해야 합니다.
        var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority");
      4. 레이아웃 필드를 다른 객체로 원래 JSON 객체에 전달합니다.

        모바일 애플리케이션은 원하는 추가 필드가 포함된 객체인 선택적 레이아웃 키를 수신합니다. 레이아웃 객체에서 각 추가 필드를 상태, 식별자 또는 설명 키와 연결합니다. 참조로 다음 예시를 사용할 수 있습니다.

        (function buildJSON( /*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) { 
        
            var layoutGen = new global.NotificationLayoutFieldGenerator(); 
            var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority"); 
            var text_02 = layoutGen.layoutField(current.getTableName(), current.sys_id, "state"); 
            var text_03 = layoutGen.layoutField(current.getTableName(), current.sys_id, "short_description"); 
        
            var deepLinkGenerator = new global.MobileDeepLinkGenerator("Request"); 
            var link = deepLinkGenerator.getFormScreenLink("b71040b1533a33007bc2ddeeff7b1221", current.getTableName(), current.getValue("sys_id")); 
        
            var json = { 
        
                "Link": link, 
        
                "Layout": { 
        
                    "Status": text_01, 
        
                    "Identifier": text_02, 
        
                    "Description": text_03 
        
                } 
        
            }; 
        
            return json;
        
        })(current, message, attributes);
    5. 옵션: 사용자 지정 알림 제목을 추가합니다.
      사용자 지정 알림 제목을 추가하지 않으면 알림에 기본 모바일 앱 이름이 표시됩니다.
      모바일 앱 이름을 표시하는 표준 알림 메시지 제목과 알림을 설명하는 사용자 지정 제목 간의 차이를 보여주는 이미지입니다.

      푸시 메시지 생성 스크립트 블록의 json 섹션에 다음 예제 코드를 추가합니다.

      var json= {};
      var msg_title  = "System updates!";
      json= {
        "android_title" : msg_title,
        "aps": {
          "alert": {
            "title": msg_title,
          }
        }
      
      샘플 JSON 코드의 요소는 다음과 같습니다.
      • msg_titleSystem updates!iOS 라는 변수는 및 Android.
      • 노드json["android_title"] 은 에 대한 Android변수입니다.
      • 노드 json["aps"]["alert"]["title"]은 에 대한 iOS변수입니다.
    6. 다음 코드를 추가하여 알림을 트리거할 수 있도록 절전 모드 해제를 위해 디바이스를 활성화합니다 Android .

      사용자가 및 Android 장치를 모두 iOS 사용하는 경우 이 코드를 추가해야 합니다. 코드의 JSON 항목은 스크립팅에서 반환된 딕셔너리 이름 값입니다.

      Android 메시지 전달을 제어하는 특정 필드는 에서 sncGoogleKeys지원됩니다. 자세한 내용은 Firebase 클라우드 메시징 HTTP 프로토콜을 참조하세요.
      주:
      priority 장치가 절전 모드인 경우 장치를 깨우 Android 기 위해 매개변수가 높음으로 설정됩니다. 이 매개변수는 최종 사용자에게 중요한 경보를 전달하는 데 도움이 됩니다.
      json["sncGoogleKeys"] = {
          "priority": "high",
          "android": {
            "priority": "high"
          }
      }
      
    7. 업데이트를 선택합니다.

    결과

    딥 링크가 포함된 푸시 알림 메시지 내용 기록이 생성되었습니다.

    다음에 수행할 작업

    푸시 알림 메시지 내용을 구성한 후에는 푸시 알림 메시지 기록과 페어링해야 합니다. 푸시 알림 메시지 구성에 대한 자세한 내용은 푸시 알림 메시지 구성 문서를 참조하십시오.