UniversalRequestUtilsSNC - スコープ対象

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • UniversalRequestUtilsSNC API を使用すると、ユニバーサル要求のライフサイクルを処理できます。スクリプトインクルードレコードとして提供されます。

    この API には ユニバーサル要求 (com.snc.universal_request) プラグインが必要であり、 sn_uni_req 名前空間内で提供されます。

    詳細については、「 ユニバーサル要求」を参照してください。

    UniversalRequestUtilsSNC - createUniversalRequest(オブジェクト copyFields)

    ユニバーサル要求を作成し、新しく作成されたユニバーサル要求レコードの sys_id を返します。

    このメソッドは、sn_uni_req 名前空間の UniversalRequestUtils プロトタイプを使用して呼び出されます。例：sn_uni_req.UniversalRequestUtils().createUniversalRequest(<copyFields>)

    表 : 1. パラメーター
    名前 タイプ 説明
    copyFields オブジェクト Universal Requests [universal_request] テーブルの新しいレコードに設定するフィールド名と値を含む JSON オブジェクト。

    フィールド名とフィールド値を { '<field_name>': '<field_value>' } の形式で入力します。次のフィールドは、プライマリチケットに割り当てるために最も便利な詳細情報と考えられます。

    
{
  'assignment_group': 'String',
  'assigned_to': 'String',
  'contact_type': 'String',
  'description': 'String',
  'opened_by': 'String',
  'opened_for': 'String',
  'priority': 'String',
  'restricted': Boolean,
  'short_description': 'String'
};

    リストに入っていないその他のフィールドが、ユースケースの対象である可能性があります。システム内のテーブルフィールドと関連フィールドのリストについては、 Data dictionary tablesを参照してください。

    注:
    copyFields の JSON オブジェクトに primary_ticket または sys_id フィールドを含めないでください。
    copyFields.assignment_group 文字列 オプション。リソースに割り当てられたグループの sys_id。

    デフォルト：デフォルトのアサイン先グループはアサインルールごとに設定されます。

    テーブル:グループ [sys_user_group] テーブル。
    copyFields.contact_type 文字列 オプション。リソースが最初に報告されたメソッド。
    可能な値：
    • chat
    • email
    • phone
    • social
    • web

    最大長：40
    copyFields.description 文字列 オプション。リソースに関連する問題の詳細な説明。

    最大長：4,000
    copyFields.opened_by 文字列 オプション。リソースを最初に開いたユーザーの sys_id。ユーザー [sys_user] テーブルにあります。
    copyFields.opened_for 文字列 オプション。HR サービスデリバリ (HRSD) のケースに必要です。リソースのオープン対象となったユーザーの sys_id。
    copyFields.priority 文字列 オプション。リソースの優先度。数値で指定します。
    可能な値：
    • 1：重大
    • 2：高
    • 3：中
    • 4：低

    デフォルト値：3
    copyFields.restricted ブーリアン

    オプション。ユニバーサル要求のアクセスが制限されているかどうかを示すフラグ。ユニバーサル要求ロールとグループを参照してください。

    有効な値：
    • true：sn_uni_req.sensitiveinfo_agent ロールを持つユーザーのみがユニバーサル要求にアクセスできます。このロールを持つユーザーには、給与の詳細などの機密情報を表示する権限があります。
    • false：ユニバーサル要求へのアクセスに制限はありません。

    デフォルト値：false
    copyFields.short_description 文字列 リソースの簡潔な説明。

    最大長：160
    表 : 2. 返される内容
    タイプ 説明
    文字列 新しく作成された Universal Request レコードの sys_id。

    次の例では、新しい Universal Request でフィールドを設定する方法を示します。このユースケースでは、Inbound Email Actions [sysevent_in_email_action] のスコープ対象の 人事ケースを作成 スクリプトの先頭にこのコードが追加されます。ケースが人事に適用されない場合、エージェントはケースを適切な部門に転送できます。

    var copiedFields = {
  'opened_for': "<user_sys_id>",    
  'short_description': email.subject,
  'restricted': false,
  'priority': '1'
};

// createUniversalRequest() must be called to create the universal request prior to creating the child case

var ur = new sn_uni_req.UniversalRequestUtils().createUniversalRequest(copiedFields);
current.universal_request = ur;