次の例では、 PrimitiveUtil() を呼び出し、Lead To Cash エンティティマッピング [sn_l2c_core_entity_mapping] テーブルのマッピング構成 ID である sn_l2c_cust_flows_sp_to_order に基づいて実装が選択されます。

//Utility to invoke createInstance API  
var util = new sn_l2c_core.PrimitiveUtil(); 
var context = {"isMultiSelect": true}; // Set the context.isMultiSelect parameter as true to enable multi-select use cases.

//Invokes the extension point and specifies an implementation based on sourceToTargetConfigID of a L2C flow.  
var service = util.getPrimitivesEPService('sn_l2c_cust_flows_sp_to_order’, context)

次の例では、 PrimitiveUtil() を呼び出し、Lead To Cash エンティティ [sn_l2c_core_entity] テーブルの configId l2c_order に基づいて実装を選択します。

//Utility to invoke createInstance API   
var util = new sn_l2c_core.PrimitiveUtil();  
var context = {"isMultiSelect": true, “entityConfigId”: “l2c_order”};  
// Set the context.isMultiSelect parameter as true to enable multi-select use cases. 
// Set the context.entityConfigId parameter if createInstance needs to be invoked with only configId. 
 
//Invokes the extension point and uses default implementation based on entityConfigId of a L2C flow.   
var service = util.getPrimitivesEPService('’, context); 

以下のスクリプト例では、 createInstance() メソッドを呼び出して、販売済み製品、その階層全体、および特性のデータをロードします。

//Utility to invoke createInstance API 
var util = new sn_l2c_core.PrimitiveUtil();  
 
//Invoke extension point, picks an implementation based on sourceToTargetConfigID of a L2C flow, the Mapping Config ID  in "sn_l2c_core_entity_mapping" table. 
var service = util.getPrimitivesEPService('sn_l2c_cust_flows_sp_to_order'); 
 
//Invoke createInstance API with required params 
var SPInstance = service.createInstance(null, '4e03cda2ec873110f87727ef5883a2cf'); 
 
//Print the returned JSON 
gs.info("SPInstance: "+JSON.stringify(SPInstance));  
 
//The returned JSON can be used for subsequent methods of the flow such as delta(), effect() and commitInstance()

出力:

{ 
  "lineItems": [ 
    { 
      "table": "sn_install_base_sold_product", 
      "sys_id": { 
        "value": "4e03cda2ec873110f87727ef5883a2cf" 
      }, 
      "attributes": { 
        "name": { 
          "value": "Quadplay Home Tech Hub Bundle" 
        }, 
        "account": { 
          "value": "9e2fd2ee11b43110f877366201dea674" 
        } 
      }, 
      "lineItems": [ 
        { 
          "table": "sn_install_base_sold_product", 
          "sys_id": { 
            "value": "9e0301e2ec873110f87727ef5883a23a" 
          }, 
          "attributes": { 
            "name": { 
              "value": "Internet and OTT Bundle" 
            }, 
          "_state": "active",
          "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            } 
          }, 
          "lineItems": [ 
          ], 
          "characteristics": [] 
        } 
      ], 
      "characteristics": [ 
        { 
          "table": "sn_prd_pm_product_characteristics", 
          "sys_id": { 
            "value": "8d669b6665ebf110f877d71ec56bf75c" 
          }, 
          "attributes": { 
            "sys_id": { 
              "value": "8d669b6665ebf110f87d71ec56bf75c" 
            },
          "_state": "active", 
          "characteristic_value": { 
              "value": "" 
            }, 
          "characteristic": { 
              "value": "4f31999fd0a63110f8770dbf976be178" 
            }, 
          "characteristic_option": { 
              "value": "4f31999fd0a63110f8770dbf976be179" 
            }, 
          "sold_product": { 
              "value": "4e03cda2ec873110f87727ef5883a2cf" 
            } 
          } 
        } 
      ] 
    } 
  ] 
}

複数選択

次のスクリプトは、 isMultiSelect を使用して createInstance() メソッドを呼び出し、2 つの販売済み製品のデータを階層と特性全体とともにロードする方法を示しています。

//Utility to invoke createInstance API  
var util = new sn_l2c_core.PrimitiveUtil();   

//Set context variable isMultiSelect true to enable multi-select 
var context = {"isMultiSelect": true}; 
//Invoke extension point, picks an implementation based on sourceToTargetConfigID of a L2C flow, the Mapping Config ID  in “sn_l2c_core_entity_mapping” table.  
var service = util.getPrimitivesEPService('sn_l2c_cust_flows_sp_to_order’, context);  
  
//Multiple sold products selected  
var selectedLineitems = '4e03cda2ec873110f87727ef5883a2cf,036a2349284d0210f877b68370fb2e93'; 

//Invoke createInstance API with required params  
var SPInstance = service.createInstance(null, selectedLineitems);  
  
//Print the returned JSON  
gs.info("SPInstance: "+JSON.stringify(SPInstance));   
  
//The returned JSON can be used for subsequent APIs of the flow such as Delta, Effect and Commit Instance 

応答：

{  
  "items": [ 
    { 
      "lineItems": [ 
        { 
          "table": "sn_install_base_sold_product", 
          "sys_id": { 
            "value": "4e03cda2ec873110f87727ef5883a2cf" 
          }, 
          "attributes": { 
            "name": { 
              "value": "Quadplay Home Tech Hub Bundle" 
            }, 
            "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            } 
          }, 
          "lineItems": [ 
            { 
              "table": "sn_install_base_sold_product", 
              "sys_id": { 
                "value": "9e0301e2ec873110f87727ef5883a23a" 
              }, 
              "attributes": { 
                "name": { 
                  "value": "Internet and OTT Bundle" 
                }, 
                "account": { 
                  "value": "9e2fd2ee11b43110f877366201dea674" 
                } 
              }, 
              "lineItems": [], 
              "characteristics": [] 
            } 
          ] 
        } 
      ] 
    }, 
    { 
      "lineItems": [ 
        { 
          "table": "sn_install_base_sold_product", 
          "sys_id": { 
            "value": "036a2349284d0210f877b68370fb2e93" 
          }, 
          "attributes": { 
            "name": { 
              "value": "Quadplay Home Tech Hub Bundle" 
            }, 
            "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            } 
          }, 
          "lineItems": [ 
            { 
              "table": "sn_install_base_sold_product", 
              "sys_id": { 
                "value": "4b6a2349284d0210f877b68370fb2e9c" 
              }, 
              "attributes": { 
                "name": { 
                  "value": "Internet and OTT Bundle" 
                }, 
                "account": { 
                  "value": "9e2fd2ee11b43110f877366201dea674" 
                } 
              }, 
              "lineItems": [], 
              "characteristics": [] 
            } 
          ], 
          "characteristics": [],
          "_state": "active" 
        } 
      ] 
    } 
  ] 
}

entityConfigId を指定して createInstance() を呼び出す

以下のスクリプト例では、 createInstance() メソッドを呼び出して、注文のデータ、その階層全体、およびその特性をロードします。この例は、SPから注文へのフローで、販売済み製品に添付されている販売契約データをフェッチすることを示しています。

// Utility to invoke createInstance API
var util = new sn_l2c_core.PrimitiveUtil();

var quoteToSA = "sn_l2c_quote_to_sales_agreement_pricing";

var context = {
  "entityConfigId": "sn_l2c_sales_agreement"
};

var spToOrder = "sn_l2c_cust_flows_sp_to_order";

var service = util.getPrimitivesEPService(spToOrder, context);

var createInstanceOutput = service.createInstance("c8e1e678432242105eba72eb3ab8f261");

gs.info("Sales Agreement JSON " + JSON.stringify(createInstanceOutput));

// The returned JSON can be used for subsequent methods of the flow such as delta(), effect() and commitInstance()

出力:

{
  "table": "sn_sales_agmt_core_sales_agreement",
  "sys_id": {
    "value": "c8e1e678432242105eba72eb3ab8f261"
  },
  "attributes": {
    "account": {
      "value": "051f62b0d7300200e5982cf65e610333"
    },
    "short_description": {
      "value": "1 year sales agreement for Spark Technologies"
    }
  },
  "lineItems": [
    {
      "table": "sn_sales_agmt_core_sales_agreement_line",
      "sys_id": {
        "value": "4104369034641210f877af77d9dd31bb"
      },
      "attributes": {
        "sales_agreement": {
          "value": "c8e1e678432242105eba72eb3ab8f261"
        },
        "short_description": {
          "value": "Home Automation Bundle"
        }
      },
      "lineItems": [
        {
          "table": "sn_sales_agmt_core_sales_agreement_line",
          "sys_id": {
            "value": "45e6fa4a436a02105eba72eb3ab8f247"
          },
          "attributes": {
            "sales_agreement": {
              "value": "c8e1e678432242105eba72eb3ab8f261"
            },
            "short_description": {
              "value": "Outdoor Camera"
            }
          },
          "lineItems": [],
          "characteristics": [],
          "pricingAdjustments": []
        },
        {
          "table": "sn_sales_agmt_core_sales_agreement_line",
          "sys_id": {
            "value": "73e6fa4a436a02105eba72eb3ab8f25a"
          },
          "attributes": {
            "sales_agreement": {
              "value": "c8e1e678432242105eba72eb3ab8f261"
            },
            "short_description": {
              "value": "Indoor Camera"
            }
          },
          "lineItems": [],
          "characteristics": [],
          "pricingAdjustments": []
        }
      ],
      "characteristics": [],
      "pricingAdjustments": []
    }
  ]
}

allowedContextType を使用した関係者の部分同期

次の createInstance() スクリプトは、header と headerRelatedParty を使用して allowedContextTypes を設定して、sn_l2c_quote_to_opportunity テーブル内のこれら 2 つの入力済みセクションのみを出力します。

var util1 = new sn_l2c_core.PrimitiveUtil();
var service1 = util1.getPrimitivesEPService('sn_l2c_quote_to_opportunity'); // WITH HEADER FLOW
var quoteId = '04ba9004f11f3110f8777d7194f166f6';
var additionalParams1 = {
    allowedContextTypes: ["header", "headerRelatedParty"]
};

var quoteInstance = service1.createInstance(quoteId, null, false, additionalParams1);
gs.info(JSON.stringify(quoteInstance));

出力。出力には、 allowedContextTypesで定義されている 2 つの入力済みセクションのみが含まれます。他のすべてのコンテキストタイプ (lines、childLines、特性など) は空または省略され、部分的な同期が可能です。

{
  "table": "sn_quote_mgmt_core_quote",
  "sys_id": {
    "value": "04ba9004f11f3110f8777d7194f166f6"
  },
  "attributes": {
    "renewal_adjustment_value": { "value": "" },
    "contract_start_date": { "value": "2024-01-01" },
    "total_net_new_amount": { "value": "USD;0" },
    "agreement_start_date": { "value": "" },
    "total_one_time_price": { "value": "USD;214" },
    "consumer": { "value": "" },
    "billing_location": { "value": "" },
    "document_template": { "value": "" },
    "pricelist": { "value": "19d29513d0e63110f8770dbf976be122" },
    "assignment_group": { "value": "a4b31c0cf1db3110f8777d7194f166e9" },
    "partner_contact": { "value": "" },
    "auto_generated_for_renewal": { "value": "false" },
    "contract_end_date": { "value": "2025-12-31" },
    "active": { "value": "true" },
    "billing_state": { "value": "" },
    "external_system": { "value": "" },
    "renewal_adjustment_type": { "value": "" },
    "source_opportunity": { "value": "" },
    "total_annual_recurring_price_v2": { "value": "USD;1596" },
    "internal_signer": { "value": "" },
    "costbook": { "value": "a3042cdce405c210f8773750028d6f72" },
    "payment_terms": { "value": "" },
    "shipping_location": { "value": "" },
    "seller_organization": { "value": "" },
    "contact": { "value": "4d147a386f0331003b3c498f5d3ee437" },
    "external_id": { "value": "" },
    "transaction_date": { "value": "2023-12-18 23:37:11" },
    "version": { "value": "1" },
    "billing_zip": { "value": "" },
    "previous_quote": { "value": "" },
    "assigned_to": { "value": "b9b19484f1db3110f8777d7194f166d1" },
    "total_monthly_recurring_price_v2": { "value": "USD;133" },
    "agreement_end_date": { "value": "" },
    "contract_type": { "value": "" },
    "renewal_adjustment_basis": { "value": "" },
    "header_api": { "value": "" },
    "channel": { "value": "agent_assist" },
    "existing_contract": { "value": "" },
    "state": { "value": "draft" },
    "header_id": { "value": "04ba9004f11f3110f8777d7194f166f6" },
    "account": { "value": "86837a386f0331003b3c498f5d3ee4ca" },
    "quote_type": { "value": "add" },
    "billing_street": { "value": "" },
    "same_as_shipping_address": { "value": "false" },
    "work_notes": { "value": "" },
    "comments": { "value": "" },
    "short_description": {
      "value": "B2B - Quadplay Home Tech Hub Bundle"
    },
    "partner": { "value": "" },
    "sales_agreement": { "value": "" },
    "total_renewal_amount": { "value": "USD;0" },
    "sa_quote": { "value": "false" },
    "external_signer": { "value": "" },
    "shipping_city": { "value": "" },
    "discount_percentage": { "value": "" },
    "expiration_date": { "value": "" },
    "billing_city": { "value": "" },
    "currency": { "value": "USD" },
    "shipping_country": { "value": "" },
    "billing_country": { "value": "" },
    "record_number": { "value": "QT0000001" },
    "shipping_state": { "value": "" },
    "initial_quote": {
      "value": "04ba9004f11f3110f8777d7194f166f6"
    },
    "shipping_street": { "value": "" },
    "shipping_zip": { "value": "" },
    "total_amount": { "value": "USD;1897.2689" },
    "term_month": { "value": "24" },
    "total_upsell_downsell_amount": { "value": "USD;0" },
    "auto_renew": { "value": "false" }
  },
  "ramp": [],
  "lineItems": [],
  "headerRelatedParty": [
    {
      "table": "sn_quote_mgmt_core_quote_related_party",
      "sys_id": {
        "value": "a822ac20740f3690f877229405634411"
      },
      "attributes": {
        "type": {
          "value": "e12455b553716210c6caddeeff7b12d3"
        },
        "seller_organization": { "value": "" },
        "active": { "value": "true" },
        "responsibility": {
          "value": "c7ccc21b65ed1910f87764df53db7725"
        },
        "order": { "value": "20" }
      }
    }
  ]
}

複数選択の結合

次の例では、ランプされた販売済み製品 (1 つのランプを持つ複数の販売済み製品) をフェッチし、すべてのランプとすべてのエンティティをフラットな構造に結合します。

/******** Sold Product to Order - MultiSelectMerge for Ramped SPs ********/ 

var util = new sn_l2c_core.PrimitiveUtil(); 
var service = util.getPrimitivesEPService('sn_l2c_cust_flows_sp_to_order'); 

var spIDs = 'aedfb2a6e9de4210f8774eb53302a639,28490592cc253210f87793fd12b09a97'; 
var additionalParams = { 
"multiSelectMerge": true, 
"fetchRecordSysIds": [{ 
"sn_install_base_sold_product_ramp": "5b8c9d9ac429b210f87756e9cf81cc6b" 
}] 
}; 
var SPInstance = service.createInstance(null, spIDs, false, additionalParams); 

gs.info("SPInstance: " + JSON.stringify(SPInstance)); 

{
  "ramp": [{"sys_id": {...}}], 
  "lineItems": [{"sys_id": {...}}, {"sys_id": {...}}] 
}

次の例では、最初に PrimitiveUtil ユーティリティ メソッドと getPrimitiesEPService() を呼び出し、次にソースとターゲットの JSON オブジェクトを指定することで、delta() メソッドを呼び出す方法を示しています。

//Utility to invoke Delta API 
var util = new sn_l2c_core.PrimitiveUtil();  
 
//Invoke extension point, picks an implementation based on sourceToTargetConfigID of a L2C flow, the Mapping Config ID  in “sn_l2c_core_entity_mapping” table. 
var service = util.getPrimitivesEPService('sp_order_macd'); 
 
//Invoke delta API with required params 
// sourceJSON can be the output of createInstance or null 
//dirtyJSON is the modified sourceJSON 
var deltaOutput= service.delta(sourceJSON, dirtyJSON);  
 
//Print the returned JSON 
gs.info(" deltaOutput: "+JSON.stringify(deltaOutput));  
 
//The returned JSON can be used for subsequent APIs of the flow such as Effect and Commit Instance

出力 JSON は、販売済みベース製品に複数の品目が追加されたことを示しています。

{ 
  "lineItems": [ 
    { 
      "table": "sn_install_base_sold_product", 
      "sys_id": { 
        "value": "-1" 
      }, 
      "attributes": { 
        "name": { 
          "value": "Quadplay Home Tech Hub Bundle" 
        }, 
        "account": { 
          "value": "9e2fd2ee11b43110f877366201dea674" 
        } 
      }, 
      "lineItems": [ 
        { 
          "table": "sn_install_base_sold_product", 
          "sys_id": { 
            "value": "-1" 
          }, 
          "attributes": { 
            "name": { 
              "value": "Internet and OTT Bundle" 
            }, 
            "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            } 
          }, 
          "lineItems": [ 
            { 
              "table": "sn_install_base_sold_product", 
              "sys_id": { 
                "value": "-1" 
              }, 
              "attributes": { 
                "name": { 
                  "value": "Solana Sports streaming channel" 
                }, 
                "account": { 
                  "value": "9e2fd2ee11b43110f877366201dea674" 
                } 
              }, 
              "lineItems": [], 
              "characteristics": [], 
              "_action": "add" 
            } 
          ], 
          "characteristics": [], 
          "_action": "add" 
        } 
      ], 
      "characteristics": [ 
        { 
          "table": "sn_prd_pm_product_characteristics", 
          "sys_id": { 
            "value": "-1" 
          }, 
          "attributes": { 
            "characteristic_value": { 
              "value": "" 
            }, 
            "characteristic": { 
              "value": "4f31999fd0a63110f8770dbf976be178" 
            }, 
            "characteristic_option": { 
              "value": "4f31999fd0a63110f8770dbf976be179" 
            }, 
            "sold_product": { 
              "value": "4e03cda2ec873110f87727ef5883a2cf" 
            }, 
            "action": { 
              "value": "add" 
            } 
          }, 
          "_action": "add" 
        } 
      ], 
      "_action": "add" 
    } 
  ] 
} 

複数選択

次の例は、最初に PrimitiveUtil と getPrimitivesEPService を呼び出し、次に複数の行またはヘッダー ID のソースとターゲットの JSON オブジェクトを指定することによって、複数選択 delta() メソッドを形成する方法を示しています。フローごとにサービスを 1 回だけ取得し、すべての LeadtoCashCore メソッドに同じサービスを使用します。

/Utility to invoke Delta API  
var util = new sn_l2c_core.PrimitiveUtil();   

//Set context variable isMultiSelect true to enable multi-select 
var context = {"isMultiSelect": true}; 
 
//Invoke extension point, picks an implementation based on sourceToTargetConfigID of a L2C flow, the Mapping Config ID  in “sn_l2c_core_entity_mapping” table.  
var service = util.getPrimitivesEPService(‘sn_l2c_cust_flows_sp_to_order’, context);  
  
//Invoke delta API with required params  
// sourceJSON can be the output of createInstance for multiple lineIDs or headerIDs or null  
//dirtyJSON is the modified sourceJSON  
var deltaOutput= service.delta(sourceJSON, dirtyJSON);   
  
//Print the returned JSON  
gs.info(" deltaOutput: "+JSON.stringify(deltaOutput));   
  
//The returned JSON can be used for subsequent APIs of the flow such as Effect and Commit Instance

出力 JSON は、販売済みベース製品に複数の品目が追加されたことを示しています。

{ 
  "items": [ 
    { 
      "lineItems": [ 
        { 
          "table": "sn_install_base_sold_product", 
          "sys_id": { 
            "value": "4e03cda2ec873110f87727ef5883a2cf" 
          }, 
          "attributes": { 
            "name": { 
              "value": "Quadplay Home Tech Hub Bundle" 
            }, 
            "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            } 
          }, 
          "lineItems": [ 
            { 
              "table": "sn_install_base_sold_product", 
              "sys_id": { 
                "value": "9e0301e2ec873110f87727ef5883a23a" 
              }, 
              "attributes": { 
                "name": { 
                  "value": "Internet and OTT Bundle" 
                }, 
                "account": { 
                  "value": "9e2fd2ee11b43110f877366201dea674" 
                } 
              }, 
              "lineItems": [], 
              "characteristics": [], 
              "_action": "disconnect" 
            } 
          ], 
          "characteristics": [], 
          "_action": "disconnect" 
        } 
      ] 
    }, 
    { 
      "lineItems": [
        { 
          "table": "sn_install_base_sold_product", 
          "sys_id": { 
            "value": "036a2349284d0210f877b68370fb2e93" 
          }, 
          "attributes": { 
            "name": { 
              "value": "Quadplay Home Tech Hub Bundle" 
            }, 
            "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            } 
          }, 
          "lineItems": [ 
            { 
              "table": "sn_install_base_sold_product", 
              "sys_id": { 
                "value": "4b6a2349284d0210f877b68370fb2e9c" 
              },
              "attributes": { 
                "name": { 
                  "value": "Internet and OTT Bundle" 
                }, 
                "account": { 
                  "value": "9e2fd2ee11b43110f877366201dea674" 
                } 
              }, 
              "lineItems": [], 
              "characteristics": [], 
              "_action": "disconnect" 
            } 
          ], 
          "characteristics": [], 
          "_action": "disconnect" 
        } 
      ] 
    } 
  ] 
}

//Utility to invoke effect API 
var util = new sn_l2c_core.PrimitiveUtil();  
 
//Invoke extension point, picks an implementation based on sourceToTargetConfigID of a L2C flow, the Mapping Config ID  in “sn_l2c_core_entity_mapping” table. 
var service = util.getPrimitivesEPService('sp_order_macd'); 
 
//Invoke effect API with required params 
var effectOutput = service.effect(deltaOutput, null); 
 
//Print the returned JSON 
gs.info("effectOutput: " + JSON.stringify(effectOutput)); 
 
//The returned JSON can be used in the subsequent commitInstance() method.

出力:

{ 
  "sys_id": "-1", 
  "table": "sn_ind_tmt_orm_order", 
  "_glide_action": "INSERT", 
  "_source_object": {}, 
  "lineItems": [ 
    { 
      "sys_id": "-1", 
      "table": "sn_ind_tmt_orm_order_line_item", 
      "attributes": { 
        "account": { 
          "value": "9e2fd2ee11b43110f877366201dea674" 
        }, 
        "short_description": { 
          "value": "Quadplay Home Tech Hub Bundle" 
        } 
      }, 
      "_glide_action": "INSERT", 
      "_source_object": { 
        "sys_id": "-1", 
        "table": "sn_install_base_sold_product" 
      }, 
      "lineItems": [ 
        { 
          "sys_id": "-1", 
          "table": "sn_ind_tmt_orm_order_line_item", 
          "attributes": { 
            "account": { 
              "value": "9e2fd2ee11b43110f877366201dea674" 
            }, 
            "short_description": { 
              "value": "Internet and OTT Bundle" 
            } 
          }, 
          "_glide_action": "INSERT", 
          "_source_object": { 
            "sys_id": "-1", 
            "table": "sn_install_base_sold_product" 
          }, 
          "lineItems": [ 
            { 
              "sys_id": "-1", 
              "table": "sn_ind_tmt_orm_order_line_item", 
              "attributes": { 
                "account": { 
                  "value": "9e2fd2ee11b43110f877366201dea674" 
                }, 
                "short_description": { 
                  "value": "Solana Sports streaming channel" 
                } 
              }, 
              "_glide_action": "INSERT", 
              "_source_object": { 
                "sys_id": "-1", 
                "table": "sn_install_base_sold_product" 
              }, 
              "lineItems": [], 
              "characteristics": [] 
            } 
          ], 
          "characteristics": [] 
        } 
      ], 
      "characteristics": [ 
        { 
          "sys_id": "-1", 
          "table": "sn_ind_tmt_orm_order_characteristic_value", 
          "attributes": { 
            "characteristic_option": { 
              "value": "4f31999fd0a63110f8770dbf976be179" 
            }, 
            "characteristic": { 
              "value": "4f31999fd0a63110f8770dbf976be178" 
            }, 
            "characteristic_option_value": { 
              "value": "" 
            } 
          }, 
          "_glide_action": "INSERT", 
          "_source_object": { 
            "sys_id": "-1", 
            "table": "sn_prd_pm_product_characteristics" 
          } 
        } 
      ] 
    }, 
  "_state": {
      "value": "active"
}
   ],
  "_records_count":
    {
        "sn_ind_tmt_orm_order":
        {
            "insert": 1
        },
        "sn_ind_tmt_orm_order_line_item":
        {
            "insert": 3
        },
        "sn_ind_tmt_orm_order_characteristic_value":
        {
            "insert": 1
        }
    }
}

次の例は、各 LeadtoCashCore メソッドを使用して、ソースからターゲットへのエンティティの詳細を取得、適用、およびコミットする方法を示しています。この例では、 commitInstance() メソッドを使用して、変更された JSON をインスタンスの「見込み顧客から現金へ」エンティティにコミットします。

//Utility to invoke commitInstance API 
var util = new sn_l2c_core.PrimitiveUtil();  
 
//Invokes the PrimitiveUtil extension point, picks an implementation based on sourceToTargetConfigID of a Lead to Cash (L2C) flow. The Mapping Config ID  in “sn_l2c_core_entity_mapping” table. 
var service = util.getPrimitivesEPService('sp_order_macd'); 
 
//Invoke commitInstance API with the required params
var effectOutput = service.effect(sourceInstance);
 
//Print the returned JSON 
gs.info("commitOutput: "+JSON.stringify(commitOutput));  

出力:

{
  "status": "success",
  "error": "",
  "message": "Commit operation successfully processed.",
  "displayMessage": "Commit operation successfully processed.",
  "dataObject": {
    "sys_id": "-1",
    "table": "sn_ind_tmt_orm_order",
    "_glide_action": "INSERT",
    "_source_object": {},
    "lineItems": [
      {
        "sys_id": "-1",
        "table": "sn_ind_tmt_orm_order_line_item",
        "attributes": {
          "account": {
            "value": "86837a386f0331003b3c498f5d3ee4ca"
          },
          "sold_product": {
            "value": "e4bbf902b7343300ece839a6ee11a937"
          },
          "short_description": {
            "value": "Network Monitoring"
          }
        },
        "_glide_action": "INSERT",
        "_source_object": {
          "sys_id": "e4bbf902b7343300ece839a6ee11a937",
          "table": "sn_install_base_sold_product"
        },
        "lineItems": [
          {
            "sys_id": "-1",
            "table": "sn_ind_tmt_orm_order_line_item",
            "attributes": {
              "account": {
                "value": "86837a386f0331003b3c498f5d3ee4ca"
              },
              "sold_product": {
                "value": "23dbbd02b7343300ece839a6ee11a98e"
              },
              "short_description": {
                "value": "Remote Monitoring"
              }
            },
            "_glide_action": "INSERT",
            "_source_object": {
              "sys_id": "23dbbd02b7343300ece839a6ee11a98e",
              "table": "sn_install_base_sold_product"
            },
            "lineItems": [],
            "characteristics": [],
            "coveredProducts": [],
            "_commitObjectInfo": {
              "sys_id": "d2d5b868488d5610f877a23d5db8922f",
              "status": "success"
            }
          }
        ],
        "characteristics": [],
        "coveredProducts": [],
        "_commitObjectInfo": {
          "sys_id": "92d5b868488d5610f877a23d5db89229",
          "status": "success"
        }
      }
    ],
    "_commitObjectInfo": {
      "sys_id": "46d5b0a4488d5610f877a23d5db892ef",
      "status": "success"
    }
  },
  "headerID": "46d5b0a4488d5610f877a23d5db892ef",
  "rootLineIDs": [
    "92d5b868488d5610f877a23d5db89229"
  ]
}

var util = new sn_l2c_core.PrimitiveUtil();

// Extension point for SP → Order flow (example from uptake doc)
var service = util.getPrimitivesEPService('sn_l2c_cust_flows_sp_to_order');

// Parent Sold Product sys_id
var spID = 'aedfb2';

// Ramp sys_id that should be included in output
var rampID = '8565f'; 

// NEW: additionalParams.fetchRecordSysIds (selective record fetch)
var additionalParams = {
  "fetchRecordSysIds": [{
    "sn_install_base_sold_product": spID,
    "sn_install_base_sold_product_ramp": rampID
  }]
};

// createInstance: headerId = null for no-header entities
var sourceInstance = service.createInstance(null, spID, false, additionalParams);
gs.info("createInstance output: " + JSON.stringify(sourceInstance));

/*
 * Expected high-level output shape (no-header):
 * {
 *   "ramp": [ { "sys_id": "...", "attributes": {...} } ],
 *   "lineItems": [ { "sys_id": "...", "attributes": {...} } ]
 * }
 */ 


// ---- Typical next steps in Primitives flow (delta/effect/commit) ----
// In a real flow you usually have a target instance too.
// For illustration we reuse the same structure as a placeholder.
var targetInstance = sourceInstance;

// Compute changes -> effect -> commit
var effectOutput = service.effect(sourceInstance);
var commitOutput = service.commitInstance(effectOutput);

gs.info("commitInstance output: " + JSON.stringify(commitOutput));

/*
 * In no-header scenarios, commitInstance returns dataObject that groups
 * root entity types (ex: lineItems, ramp) instead of a single root.
 */

/***************************************************************
 * Goal: createInstance returns a flat structure:
 *   - lineItems: [ ...all selected SPs... ]
 *   - ramp:     [ ...all ramps... ]
 */

var util = new sn_l2c_core.PrimitiveUtil();
var service = util.getPrimitivesEPService('sn_l2c_cust_flows_sp_to_order');  

// Multiple SPs selected
var spIDs = 'aedfb2,28490592';  

// Selective ramp sys_id(s) to include (merged output)
var rampID = '5b8c9d9';  

var additionalParams = {
  "multiSelectMerge": true,
  "fetchRecordSysIds": [{
    "sn_install_base_sold_product_ramp": rampID
  }]
};  

var mergedInstance = service.createInstance(null, spIDs, false, additionalParams);
gs.info("Merged createInstance output: " + JSON.stringify(mergedInstance));

/*
 * Expected high-level output shape for merge:
 * {
 *   "ramp":     [ { ... }, { ... } ],
 *   "lineItems":[ { ... }, { ... } ]
 * }
 */  


// Optional: Commit example (same pattern)
var effectOutput = service.effect(mergedInstance);
var commitOutput = service.commitInstance(effectOutput);
gs.info("commitInstance output: " + JSON.stringify(commitOutput));