Playbook データインポートタスクの構成アカウントライフサイクルイベント

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む10読むのに数分
  • を使用するプレイブックデータアカウントライフサイクルイベントインポートタスクを設定します。

    データインポートタスクを設定するには、次のロールが必要です。
    • sn_acct_lc.agent
    • 1 つ以上の プレイブック ロール。詳細については、「Playbooks roles」を参照してください。

    次の表に、データインポートタスクの構成に関連するさまざまなタスクを示します。

    表 : 1. データインポートタスク
    タスク セクション
    ターゲットテーブルにデータをインポートするための Excel テンプレートを作成します。 Excel テンプレートを作成
    ターゲットテーブルに移動する前に、インポートデータを格納できるステージングテーブルを作成します。 ステージングテーブルの作成
    データソースを作成し、テンプレートファイルをレコードに添付します。 データソースを作成する
    変換マップを設定します。 変換マップの構成
    Playbook アクティビティ プレイブック をプロセスに追加します。 データインポートタスクを追加
    注:
    次のセクションでは、ベースシステムで利用可能な場所テーブルのデータインポートタスクを構成する方法について説明します。これらのセクションで使用される名前と値は例ですが、このプロセスに従って、データインポートタスクに使用する任意のテーブルを設定できます。

    Excel テンプレートを作成

    ターゲットテーブルにデータをインポートするための Excel テンプレートを作成します。

    1. [ All ] に移動し、[Search] フィルターに「 cmn_location.list 」と入力します。
    2. [カスタマイズ] アイコンを選択し、テンプレートに含める列を選択します。必要に応じてフィルター条件を入力し、列オプション アイコンを選択し、 Excel (.xlsx) にエクスポート を選択します。
    3. [ ダウンロード ] を選択して、エクスポートされたファイルをダウンロードします。
    4. ダウンロードした Excel ファイルを開き、既存のデータをすべて消去して、 [ 保存] を選択します。
    5. 前に選択した列がファイルに含まれていることがわかります。このファイルは、データをインポートするための Excel テンプレートとして使用できます。

    ステージングテーブルの作成

    ターゲットテーブルに移動する前にインポートデータを格納できるステージングテーブルを作成します。

    1. 移動先 すべて > システム定義 > テーブル.
    2. 新規 を選択し、次の詳細を入力します。
      • ラベル: 場所テーブルの名前を入力します (例: 場所のデータインポート)。
      • 名前: テーブルの内部名を入力します。たとえば、 sn_acct_lc_account_onb_import_locations
      • 拡張テーブル:テクノロジーインポート行を選択します。
    3. [モジュールを作成] チェックボックスをオフにして、[ コントロール ] タブを選択します。
    4. [ユーザー ロール] フィールドに「 sn_acct_lc.agent 」と入力し、[ 保存] を選択します。
    5. 列 タブを選択し、新規 を選択します。以下の詳細を入力します。
      • タイプ:文字列。すべての列は文字列型である必要があります。
      • 列ラベル:テンプレートファイルのフィールド名(列名)を入力します。
      • 列名: u_接頭辞を使用して列ラベルを入力します。たとえば、[列ラベル] に「Street」と入力した場合は、ここに「u_street」と入力します。
      • 最大長: 必要に応じて列の最大長を指定します。
      前の手順に従って、テンプレート ファイルからすべての列を追加します。
    6. [関連リンク] で [レイアウトリスト] を選択します。[List view (リストビュー)] ドロップダウンから [New (新規 )] を選択し、このテーブルの 2 つのリストビューを作成します。
      • ready_to_publish:このビューにすべての論理フィールドを追加します。このビューは、[データインポート] タスクレコードで [公開準備完了] バケットを選択すると表示されます。
      • needs_attention:すべての論理フィールドと [コメント] フィールドをこのビューに追加します。このビューは、データインポートタスクレコードで [要注意] バケットを選択すると表示されます。
    7. [関連リンク] の下の [レイアウト] フォームを選択します。
    8. [ビュー名] ドロップダウンから [ 新規 ] を選択し、import_viewを作成します。すべての論理フィールドと [コメント] フィールドをこのビューに追加します。このビューは、[データインポート] タブからステージングテーブルレコードを開こうとすると表示されます

    データソースを作成

    データソースを作成し、テンプレートファイルをレコードに添付します。
    1. 移動先 すべて > 管理 > データソース.
    2. 新規 を選択し、次の詳細を入力します。
      • 名前: データソースの名前を入力します。
      • インポートセットテーブル名:内部テーブル名を入力します。たとえば、 sn_acct_lc_account_onb_import_locations
    3. 作成したデータソースレコードにテンプレートファイルを添付します。

    変換マップの構成

    変換は、生のフィールド入力値を組織にとってより意味のある標準化された値に変換します。管理者は、特定のフィールドのルールと条件を定義することで、いつ変換が行われるかを制御します。

    データインポート構成の一部として、ベースシステムで提供される次の必要な変換スクリプトを構成する必要があります。変換スクリプトを構成するには、次の手順を実行します。

    1. 移動先 すべて > 変換マップ.
    2. アプリケーションを検索します アカウントライフサイクルイベント
    3. Account Onboarding Customer Location 変換マップを選択します。
      [変換スクリプト] タブを選択します。次のスクリプトを表示できます。
      • onComplete
      • onAfter
      • onBefore
    4. いずれかのスクリプトを選択して必要に応じて変更し、[ 更新 ] を選択して変更を保存します。
    onComplete スクリプト
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    	//Check if there is any Needs Attention Record is present or not.
    	//If Yes, then script will create a new import set record and attach all the Needs Attention records to the new Import Set.
    	//Also, it will update the new import set reference on the import Task Table.
    	var util = new sn_acct_lc.AlonStagingRecordState();
    	util.onCompleteTransformMap(source, import_set);
    })(source, map, log, target);
    onAfter スクリプト
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    
    	// Add your code here
    	
    	var alonStagingUtil = new sn_acct_lc.AlonStagingRecordState();
    	alonStagingUtil.afterTransform(source);
    	if(source.sys_import_state == TechOnbEditableContants.SN_IMPORT_TRANFORM_IGNORED) {
    		return;
    	}
    	
    
    })(source, map, log, target);
    onBefore
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    
    	// Add your code here
    	var alonStagingUtil = new sn_acct_lc.AlonStagingRecordState();
    	var status = alonStagingUtil.beforeTransform(source.import_state);
    	if(status == TechOnbEditableContants.SN_IMPORT_TRANFORM_IGNORE) {
    		ignore = true;
    	}
    
    })(source, map, log, target);

    データインポートタスクを追加

    構成したデータインポートタスクを、Process Automation Designer で定義された アカウントライフサイクルオンボーディングプロセス に追加します。

    1. 移動先 すべて > Process Automation Designer.
    2. アカウントライフサイクルのオンボーディングプロセスを選択します。
    3. [Data Capture & Validation] レーンに移動し、[ Add an activity] を選択します。
    4. [ Account lifecycle events (取引先ライフサイクルイベント )] を選択し、[ Create & View Tech Task Record (技術タスクレコードの作成と表示)] を選択します。
    5. 新しく追加されたタスクの [編集 ] アイコンを選択して、プロパティを表示します。
    6. [ すべてのプロパティを表示 ] を選択し、 [ 詳細設定] を選択します。
    7. [全般] タブで、ラベル名と説明を入力します。
    8. [開始時期] フィールドで、[ 前回を含む] を選択します。このオプションを使用すると、タスク内のすべてのアクティビティを並行して実行できます。
    9. [自動化] タブを選択し、[入力] セクションで次のように入力します。
      • テーブル:レコードが作成されるテーブル。[Account Lifecycle Import Task (sn_ti_core_imp_task)] を選択します。
      • キャンセル条件:タスクがキャンセルステータスに移行する前に満たす必要がある条件を指定します。
      • クローズ条件:タスクが [クローズ済み] ステータスに移行する前に満たす必要がある条件を指定します。
      • オンボーディングケース:[アカウントオンボーディングケースレコード] トリガーを選択して、このレコードをアカウントオンボーディングケースに関連付けます。
      • レコードビュー:Playbook に表示される アカウントライフサイクルイベント フォームビューの名前。ここに tech_pad_imp_task_view を入力してください。
      • 責任名:リストから ServiceNow 開発者/管理者ユーザーロールを選択します。このロールは、内部チームメンバーに割り当てられます (Playbook の開始ステージの [内部チームの責任のアサイン] タスクで定義)。詳細は参照 アカウントライフサイクルイベント Playbook の使用 )。このロールを持つユーザーは、データインポートタスクを実行できます。
    10. [ Add Field (フィールドの追加 )] を選択し、[Import Task (インポートタスク)] テーブルから アカウントライフサイクルイベント 次のフィールドにデータを入力します。
      • ソーステーブル:ステージングテーブルの内部名を追加します。たとえば、 sn_acct_lc_account_onb_import_locations
      • ターゲット表: ターゲット表の内部名を追加します。たとえば、 cmn_location
      • データソース:データソースを選択します。たとえば、 cmn_location_template.xlsx
      • データインポートステータス:デフォルト値は 1 (データはまだロードされていません) に設定されています。
      • 状態: 既定の状態は 1 (オープン) に設定されています。
      • 種類: [データ キャプチャ] を選択します。
      • アカウント:ケースタスクに関連付けられているアカウントオンボーディングケースを選択します。
      • 親:アカウントオンボーディングケースに関連付けられた親レコードを選択します。
      • 表示: これを False に設定します
    11. 必要に応じて [件名] と [説明] を入力し、[ 完了 ] を選択してから [ アクティブ化] を選択します。

    データインポートタスクを構成した後、 アカウントライフサイクルイベント Playbook を使用して顧客のオンボーディングを行うことができます。詳細については、「アカウントライフサイクルイベント Playbook の使用」を参照してください。