NetSuite の始め方| N/record: record.transform.promise(options)メソッド

前の記事NetSuiteの始め方 | Understanding SuiteScript 2.x Modulesで、レコードの操作に使用されるSuiteScriptモジュールおよびN/recordモジュールNetSuiteの始め方 | N/record Module Overviewを学習しました。次に、N/record: record.transform.promise(options) Methodの要素の1つを詳しく確認します。

record.transform.promise(options)メソッドは、あるレコード・タイプを別のレコード・タイプに変換(注文書を請求書に変換するなど)するために使用され、JavaScript Promisesを使用して非同期に機能します。

構文

record.transform.promise(オプション)

パラメータ

options (Object): 変換の実行方法を指定するオブジェクト。必須プロパティ:

• fromType (文字列):変換元のレコード・タイプ(例: record.Type.SALES_ORDER)。
• fromId (数値):ソース・レコードの内部ID。
• toType (文字列):変換先のレコード・タイプ(例: record.Type.INVOICE)。
• isDynamic (ブール、オプション):新しいレコードが動的か静的か。
• defaultValues (オブジェクト、オプション):新しいレコードのデフォルト・フィールド値を含むプレーン・オブジェクト。

戻り値

Promise (約束): 変換されたレコード・オブジェクトに正常に変換されます。

使用例

/**
 * @NApiVersion 2 .1
 * @NScriptType ScheduledScript 
 */
define(['N/record', 'N/log'], function(record, log) {
  
  // 定期スクリプトのメイン・エントリ・ポイント
  const execute = async (context) => {
    try {
      // 注文書を請求書に変換しようとしました
      // 5567を注文書レコードの実際の内部IDに置き換えます
      const invoiceRecord = await record.transform.promise({
        fromType: record.Type.SALES_ORDER, // Source record type
        fromId: 5567,                      // ソースレコード内部ID
        toType: record.Type.INVOICE,       // 目的のレコードタイプ
        isDynamic: true                    // 変換されたレコードに動的モードを使用
      });
  
  // 新しい内部IDを返す請求書レコードを保存
      const invoiceId = await invoiceRecord.save();

      // 正常に変換され、新しい請求書レコードIDが記録
      log.debug({
        title: 'Transformation Successful',
        details: 'Created Invoice ID: ' + invoiceRecord.id