LeadAPIProcessUtilOOB - スコープ指定

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

    • LeadAPIProcessUtilOOB スクリプトインクルードは、リードレコードとそれに関連するリード品目レコードを取得するために、リード REST API によって呼び出されるメソッドを提供します。

    リード APIメソッドが呼び出されたときにリードレコードを取得する方法をカスタマイズする場合は、このスクリプトインクルードのメソッドを LeadAPIProcessUtil スクリプトインクルードで上書きします。LeadAPIProcessUtil スクリプトインクルードで上書きするメソッドの名前は、LeadAPIProcessUtilOOB スクリプトインクルードファイルの名前と同じにする必要があります。

    この API は sn_lead_mgmt_core 名前空間内で提供されます。API にアクセスするには、リード管理データモデル (sn_lead_mgmt_core) プラグインがインスタンスでアクティブ化されており、呼び出し元ユーザーが sn_lead_mgmt_core.lead_integrator ロールを持っている必要があります。

    リード管理の詳細については、「Using Lead Management」を参照してください。

    LeadAPIProcessUtilOOB:processCreateLead (オブジェクト requestBody)

    要求本文を処理し、渡されたパラメーターに基づいてリードとそれに関連するすべての品目を作成します。

    レコードは次のテーブルに挿入されます。
    • リード [sn_lead_mgmt_core_lead]
    • リード品目 [sn_lead_mgmt_core_lead_line_item]
    表 : 1. パラメーター
    名前 タイプ 説明
    requestBody オブジェクト 作成するリードとその関連リード品目の要求本文。

    このオブジェクトの内容の詳細については、「 lead:POST /sn_lead_mgmt_core/lead」を参照してください。
    表 : 2. 戻り値
    タイプ 説明
    JSON オブジェクト 保存されたリードおよびリード品目レコードの詳細。

    データタイプ: オブジェクト

    {
  "body": {Object},
  "status": "String"
}
    <JSONobject>.body 応答本文。

    成功した応答:要求されたリードレコード内のすべてのフィールドと、関連するリード品目レコードのすべてのフィールド。返されるフィールドの説明については、「 lead:POST /sn_lead_mgmt_core/lead」を参照してください。

    エラー応答:要求を処理しようとしたときに検出されたエラーのリスト。これらのエラーメッセージは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ: オブジェクト
    <JSONobject>.status 応答ステータスコード。

    これらのステータスコードは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ：文字列

    次のコード例は、LeadAPIProcessUtil スクリプトインクルードで processCreateLead() メソッドのカスタムコードを追加する場所を示しています。

    var LeadAPIProcessUtil = Class.create(); 

LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { 

// Define overriding functions here 

processCreateLead: function(requestBody) { 
// Add your custom code 
}, 

type: 'LeadAPIProcessUtil' 

});

    LeadAPIProcessUtilOOB:processGetAllLeads (オブジェクト queryParams、文字列 requestUrl)

    渡されたフィルター基準に基づいて、すべてのリードレコードと関連する品目レコードを取得します。このメソッドは、関連付けられたレコード内のすべてのフィールドを返します。

    レコードの詳細は、次のテーブルからフェッチされます。
    • リード [sn_lead_mgmt_core_lead]
    • リード品目 [sn_lead_mgmt_core_lead_line_item]
    表 : 3. パラメーター
    名前 タイプ 説明
    queryParams オブジェクト リードレコードを取得するときに適用するクエリパラメーターを含むオブジェクト。これらは、 lead:GET /sn_lead_mgmt_core/lead エンドポイントで渡されるクエリパラメーターです。
    例： 
    {
  "sysparm_fields":["first_name,last_name,sys_id,lead_line_items"],
  "sysparm_query":["lead_type=new_business"],
  "sysparm_offset":["2"],"sysparm_limit":["25"]
}
    requestUrl 文字列 要求 URL。メソッドが応答内のすべてのページへのリンクを持つように、ページネーションされた応答を処理するときにこの URL を渡します。
    表 : 4. 戻り値
    タイプ 説明
    JSON オブジェクト 要求されたリードおよびリード品目レコードの詳細。

    データタイプ: オブジェクト

    {
  "body": [Array],
  "contentRange": "String",
  "links": "String", 
  "status": "String",
  "totalCount": "Number" 
}

    要求の処理中にエラーが発生した場合、JSON オブジェクトには 本文 パラメーターと ステータス パラメーターのみが含まれます。
    <JSONobject>.body 応答本文。

    成功した応答:各オブジェクトを含むオブジェクトのアレイには、リードレコードと関連するすべてのリード品目レコードが含まれます。要求されたリードレコード内のすべてのフィールドと、関連するリード品目レコードのすべてのフィールドが返されます。返されるフィールドの説明については、「 lead:GET /sn_lead_mgmt_core/lead」を参照してください。

    エラー応答:要求を処理しようとしたときに検出されたエラーのリスト。これらのエラーメッセージは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ：オブジェクトのアレイ
    <JSONオブジェクト>.contentRange ページネーションされた呼び出しで返されるコンテンツの範囲。

    例:offset=2 および limit=3 の場合、このパラメーターの値はアイテム 3-5 です。

    データタイプ：文字列
    <JSONobject>.links ページネーションされた応答の場合、応答に含まれる各ページへのカンマ区切りリンク。
    例：
    <https://servicenow-instance/api/sn_lead_mgmt_core/lead?sysparm_offset=0&sysparm_limit=20>;rel="self",
<https://servicenow-instance/api/sn_lead_mgmt_core/lead?sysparm_offset=20&sysparm_limit=20>;rel="last",
<https://servicenow-instance/api/sn_lead_mgmt_core/lead?sysparm_offset=20&sysparm_limit=20>;rel="next"

    データタイプ：文字列
    <JSONobject>.status 応答ステータスコード。

    これらのステータスコードは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ：文字列
    <JSONobject>.totalCount メソッドによって返されたリードレコードの合計数。

    データタイプ：数値 (整数)

    次のコード例は、LeadAPIProcessUtil スクリプトインクルードで processGetAllLeads() メソッドのカスタムコードを追加する場所を示しています。

    var LeadAPIProcessUtil = Class.create(); 

LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { 

// Define overriding functions here 

processGetAllLeads: function(queryParams, requestUrl) { 
// Add your custom code here 
}, 

type: 'LeadAPIProcessUtil' 
});

    LeadAPIProcessUtilOOB:processGetLeadById (文字列 ID)

    指定されたリードレコードとそれに関連する品目レコードを取得します。このメソッドは、関連付けられたレコード内のすべてのフィールドを返します。

    レコードの詳細は、次のテーブルからフェッチされます。
    • リード [sn_lead_mgmt_core_lead]
    • リード品目 [sn_lead_mgmt_core_lead_line_item]
    表 : 5. パラメーター
    名前 タイプ 説明
    ID 文字列 取得するリードレコードのSys_id。

    テーブル:リード [sn_lead_mgmt_core_lead]
    表 : 6. 戻り値
    タイプ 説明
    JSON オブジェクト 要求されたリードおよびリード品目レコードの詳細。

    データタイプ: オブジェクト

    {
  "body": {Object},
  "status": "String"
}
    <JSONobject>.body 応答本文。

    成功した応答:要求されたリードレコード内のすべてのフィールドと、関連するリード品目レコードのすべてのフィールド。返されるフィールドの説明については、「 lead:GET /sn_lead_mgmt_core/lead/{sys_id}」を参照してください。

    エラー応答:要求を処理しようとしたときに検出されたエラーのリスト。これらのエラーメッセージは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ: オブジェクト
    <JSONobject>.status 応答ステータスコード。

    これらのステータスコードは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ：文字列

    次のコード例は、LeadAPIProcessUtil スクリプトインクルードで processGetLeadById() メソッドのカスタムコードを追加する場所を示しています。

    var LeadAPIProcessUtil = Class.create(); 

LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, { 

// Define overriding functions here

processGetLeadById: function(id) { 
  // Add your custom code here
}, 

type: 'LeadAPIProcessUtil' 

});

    LeadAPIProcessUtilOOB - processUpdateLead (オブジェクト requestBody, 文字列 id)

    要求本文を処理し、渡されたパラメーターに基づいて、指定されたリードとそれに関連するすべての品目を更新します。

    次のテーブルのレコードが更新されます。
    • リード [sn_lead_mgmt_core_lead]
    • リード品目 [sn_lead_mgmt_core_lead_line_item]
    表 : 7. パラメーター
    名前 タイプ 説明
    requestBody オブジェクト 更新するリードの要求本文とその関連リード品目フィールド。

    このオブジェクトの内容の詳細については、「 lead:パッチ/sn_lead_mgmt_core/lead/{sys_id}」を参照してください。
    ID 文字列 更新するリードレコードのSys_id。

    テーブル:リード [sn_lead_mgmt_core_lead]
    表 : 8. 戻り値
    タイプ 説明
    JSON オブジェクト 保存されたリードおよびリード品目レコードの詳細。

    データタイプ: オブジェクト

    {
  "body": {Object},
  "status": "String"
}
    <JSONobject>.body 応答本文。

    成功した応答:更新されたリードレコードのすべてのフィールドと、関連するリード品目レコードのすべてのフィールド (更新の有無を問わない)。返されるフィールドの説明については、「 lead:パッチ/sn_lead_mgmt_core/lead/{sys_id}」を参照してください。

    エラー応答:要求を処理しようとしたときに検出されたエラーのリスト。これらのエラーメッセージは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ: オブジェクト
    <JSONobject>.status 応答ステータスコード。

    これらのステータスコードは、 LeadAPIConstants スクリプトインクルードで定義されます。

    データタイプ：文字列

    次のコード例は、LeadAPIProcessUtil スクリプトインクルードで processUpdateLead() メソッドのカスタムコードを追加する場所を示しています。

    var LeadAPIProcessUtil = Class.create();

LeadAPIProcessUtil.prototype = Object.extendsObject(LeadAPIProcessUtilOOB, {

// Define overriding functions here 

processUpdateLead: function(requestBody, id) { 
// Add your custom code here
},

type: 'LeadAPIProcessUtil' 

});