ステップ: NetSuite データ ソースの設定
インテグレーションを使用して、NetSuite インスタンスから情報を抽出することができます。
Adaptive Planning
ユーザーは、NetSuite アダプタを介して NetSuite インスタンス内のデータにアクセスできます。NetSuite のデータ ソースを設定するには、次の手順を実行します。
- "インテグレーション" > "インテグレーション設定"へ移動します。
- "コンポーネント ライブラリ"の"データ ソース"フォルダを展開します。NetSuite データ ソースは個別にライセンスされています。データ ソースの一覧にこのアダプタが表示されない場合は、Workday カスタマー センターでケースを作成してください。
- "NetSuite データ ソース"をクリックします。画面の中央エリアに新規データ ソースの設定およびその他の情報が表示されます。
- データ ソースの情報を入力します。
- トークン に基づく認証 (TBA) を有効化: 最新の NetSuite バージョンに更新すると、デフォルトでチェックボックスがオンになります。NetSuite 管理者が NetSuite UI で生成したコンシューマー キー、コンシューマー シークレット、トークン ID、およびトークン シークレットを含む NetSuite 認証情報を選択する必要があります。
- 認証情報:管理者が UI で生成したコンシューマー キー、コンシューマー シークレット、トークン ID、およびトークン シークレットを含む NetSuite 認証情報を選択します。NetSuite 認証情報を設定する方法については、 ここに移動してください。
- アカウントのタイムゾーン: ドロップダウン リストから、アカウントの正しいタイムゾーンを選択します。(ここで選択するタイム ゾーンは、このユーザー アカウントの NetSuite ユーザー インターフェイス内で使用されているタイムゾーンと同一でなければなりません。NetSuite で"Home" > "Set Preferences" > "Localization"に移動します。)
- データ入力のバッチ期間: データ入力のバッチ時間を選択します。デフォルト値は 1 週間 (168 時間) です。この値は、差分インポートされた NetSuite テーブルの一度の更新パスで抽出されるデータの時間数です。これにより、スケジューラのチャンクを設定し、大規模なバッチジョブと小規模なバッチ ジョブとのバランスを維持できます。NetSuite データが非常に大量にある場合は、この値を下げてください。値が小さいほど、特定のカレンダー期間に必要な穴埋めのループが多くなります。入力する値は、ジョブ サイズ、小規模ジョブと大規模ジョブの割合、所要時間、システム リソースなど、サイト固有の変数に大きく左右されます。
- ログ レベル:ドロップダウン リストからログ レベルを選択し、このデータ ソースをどこまで詳細に記録するかを指定します。次のオプションがあります。
- エラー: 重大なエラーのみを記録します。
- 情報: データ ソースが更新されたときなど、すべての基本情報を記録します。
- 詳細: すべてのフェーズとアクションに関する非常に詳細な情報を提供します。(このレベルは、主にデバッグや監査に使用されます。一般的な用途よりも多くのログ情報が生成される可能性があります。)
- "アクション" メニューから、"保存"をクリックします。
新規エージェントの接続情報をテストするには、"アクション" メニューで
"接続テスト"
をクリックします。システムは、データ ソース フィールドの情報を使用して NetSuite への接続を試みます。システムが NetSuite に接続できる場合は "OK"
をクリックします。接続に問題がある場合は、Workday カスタマー センターでケースを作成してください。NetSuite に接続できたら、データ構造をインポートできます。これで、NetSuite 内のテーブルおよび列が表示されます。
NetSuite データ ソースから構造をインポート
- "アクション"メニューで"構造のインポート"をクリックします。テーブルと列が"データ コンポーネント"メニューに表示されます。
データは、以下の容量で NetSuite ユーザー アカウントと同期されます。
- インテグレーションは、最適な同期方法を選択します。
- インテグレーションは、最初は差分データの取得を試みます。
- 元のデータ ソースが差分データの取得をサポートしていない場合、インテグレーションは、ステージング領域のデータの完全なリフレッシュを行います。
NetSuite の構造のインポートおよび Adaptive 転記トランザクションのサマリ テーブル
インテグレーションには、
AdaptivePostingTransactionSummary
テーブルと呼ばれる NetSuite 向けの基本事項のテーブルがついてきます。AdaptivePostingTransactionSummary
および関連するテーブルは、構造のインポート
中はデフォルトで表示されます。このテーブルは、NetSuite ソース システムからもっとも頻繁に要求されるデータ要素を示しています。このテーブルは、PostingTransactionSummary
テーブルと関連テーブルを自動的に結合します。その結果、最も頻繁に要求される NetSuite カテゴリのビジネス フレンドリ名が公開されます。
- 科目
- 分類
- アイテム
- 部門
- 場所
- 子会社
- 顧客
"名称" 列は各テーブルに含まれます。
"科目タイプ"
列は、"科目"
タブから自動的に有効化されます。カテゴリ テーブルは、"構造のインポート"
の実行時に自動的にインポートされます。必要のない科目タイプは、「SQL フィルタの作成」で説明されているように、"Planning ローダ" の SQL フィルタを使って除外する必要がある場合もあります。
結合テーブルで利用できるデフォルトの属性のうち 1 つ以上を削除することもできます。お使いのモデルに必要なカテゴリだけを選んでください。それ以外のカテゴリはすべて結合から取り除き、元の列も PostingTransactionsSummary からのインポートから除外しましょう。
NetSuite データ ソースにテーブルを追加
データの構造をインポートしたら、インポートする情報を指定できます。NetSuite の標準テーブル セットは、すでに有効になっています。他のテーブルを追加でインポートしたい場合は、画面の "インポートするテーブル" セクションを使って、インポートされた NetSuite データの設定を行ってください。
ユーザー アカウントからインポートするテーブルを指定するには:
- "データ コンポーネント"メニューでデータ ソースのエントリを展開します。各テーブルは、個別のアイテムとして表示されます。
- インポートするテーブルを、画面中央の "インポートするテーブル" セクションにドラッグ アンド ドロップします。各テーブルを "インポートするテーブル" セクションにドラッグすると、テーブルのタブが表示され、テーブルの情報が "インポートするテーブル" セクションに表示され、追加した情報のタイプを確認できます。各テーブルのタブにはドロップダウン メニューがあり、名前の横にある矢印をクリックするとアクセスできます。
列の管理
作業しているテーブルに列が多数ある場合は、"列を管理" を使用してどの列をインポートするかをすばやく編集できます。"列を管理" ダイアログ ボックスにはテーブルの列が表示されるため、インポートする列をオンまたはオフにすることができます。
インポートする列を管理するには:
- テーブル名の右にあるタブの矢印をクリックします。
- フローティング メニューで "列を管理" をクリックします。
- インポートする列の横にあるチェックボックスをオンにします。列をオンにすると、ポップアップの内容を保存した後でプレビュー ウィンドウに列が表示されます。列をオフにすると、プレビュー ウィンドウから列が削除されます。isDeleted などの、システムが生成するフィールドのインポート ステータスを変更することはできません。個々の列のインポート ステータスは、以下の方法で変更できます。
- 列のプロパティを選択してプロパティを設定する。
- 列をデザイナーにドラッグ アンド ドロップする。
テーブルのカスタマイズ
テーブルごとにデータのインポート方法をカスタマイズできます。
テーブル設定をカスタマイズするには、次のようにします。
- テーブル名の右にあるタブの矢印をクリックします。
- フローティング メニューで"テーブル設定"をクリックします。
- テーブル設定を入力します。
- データ インポート モード:ドロップダウン リストには以下のオプションのみが表示されます。
- 最適な同期方法を自動的に選択するデータ ソース: これがデフォルトです。データ ソースが NetSuite を確認し、最適な方法でステージング領域のデータを NetSuite 内の情報と同期します。(毎回全体を読み取るテーブルもあれば、差分更新を使用するテーブルもあります。)
- データ インポートのフィルタ:インポートしている情報をフィルタリングまたはフォーマットする SQL 式を入力します。SQL フィルタは NetSuite からデータを抽出する前に適用され、インポートする必要があるデータの量を削減します。それによってステージング領域に取り込まれるデータをさらに細かく制御できます。フィールドをクリックすると、"SQL 式を編集" ダイアログ ボックスが表示されます。(ここで入力したフィルタは、ステージング領域のプレビュー データではなく、NetSuite 内の実際のデータに適用されます。)すべてのデータ ソースが同じレベルの SQL フィルタリング機能をサポートしているわけではありません。
- 期間パラメータ:NetSuite のテーブルPostingTransactionBalanceおよびPostingTransactionSummaryはデフォルトでインポートします。インポートの前に期間パラメータの構成が必要です。インポートを選択するConsolidatedExchangeRateまたはBudgetExchangeRateテーブルでは、期間パラメータの構成も必要です。このようなテーブルに対して期間パラメータを構成しないと、インポートは次のようなメッセージとともに失敗します。Required parameter is not configuredNetSuite には、きわめて限定的ながら非 SQL フィルタリング機能があります。非常に単純な式のみがサポートされています。
- "適用"をクリックして設定を適用します。
- 各テーブルに対して手順 1〜3 を繰り返します。
- "保存"をクリックして、データ ソースに設定を保存します。
列のオプション設定
"インポートするテーブル" を使用中は、データ ソースまたはインポート後のステージング領域に存在する状態でのデータのプレビューを表示できます。各列のオプションを変更するには、見出しにマウスを合わせ、その名前の横にあるドロップダウン メニューをクリックします。
- 昇順で並べ替え:この列に基づいてテーブル全体を昇順で並べ替えます。
- 降順で並べ替え:この列に基づいてテーブル全体を降順で並べ替えます。
- 列の設定:このダイアログを使用して、ステージング テーブル内の列のプロパティを変更します。
- 名前:ヘッダーに表示される列の名前。
- 列のタイプ:列で使用されるデータのタイプ。
- 列タイプを変換:このドロップダウン メニューから新しいタイプを選択します。
- インポートから列を除外:インポートするデータからこの列を削除する場合に選択します。
- カスタム列を削除:このオプションを選択して列を削除します。(カスタム列でのみ使用可能です。)
サブクエリー列の作成
サブクエリー列を使い、他の関連テーブルの条件に基づいて NetSuite の行をフィルタリングできます。たとえば NetSuite の "オポチュニティ" レコードを、1 つ以上の "見積もり" レコードの有無をもとにフィルタリングできます。
サブクエリーの列を使用して以下を行うことができます。
- 主テーブル/列と関連テーブル/列を選ぶ。
- 関連テーブルの特定の条件をチェックする。
- そのチェックの結果をもとに牽引テーブルに適切な値を挿入する。
テーブルごとにデータのインポート方法をカスタマイズできます。
サブクエリー列を作成するには、次のようにします。
- "データ コンポーネント" メニュー内で、データ ソースの "カスタム列" フォルダを展開します。
- "サブクエリー列" コンポーネントを、画面中央の "インポートするテーブル" セクションにドラッグ アンド ドロップします。
- 列の設定を入力します。
- 名前:サブクエリー列の名前を入力します。
- 列のタイプ:この表示専用フィールドは、ブール値列として識別されます。
- 関連テーブル:比較に使用する関連テーブルを選択します。
- 結合式:このフィールドをクリックし、結合条件を入力します。"SQL 結合式を編集" ダイアログ ボックスが表示されます。(SQL 結合の作成に関する詳細情報は 、ステップ: SQL 結合テーブルと列の追加を参照してください。)
- 結合値のルール:ドロップダウン リストから、以下の SQL 結合値オプションのうち 1 つを選択します。"存在する"、"存在しない"、"合計"、"カウント"、"最小"、または "最大"。
- "適用"をクリックして設定を適用します。
- "保存"をクリックして、データ ソースに設定を保存します。
ステージング テーブルからデータをダウンロード
単一のステージング テーブルからデータをダウンロードできます。
単一のステージング テーブルからデータをダウンロードするには:
- "インポートするテーブル" セクションのテーブルの見出しにある下矢印をクリックします。
- "データをダウンロード"を選択します。
- "この操作により、データをダウンロードするための URL を含む E メールが送信されます" というプロンプトで、"送信"をクリックします。データ デザイナーに関連付けられた E メール アカウントに、URL を記載した E メールがインテグレーションから送信されます。
- E メールを開いて URL をクリックします。データは .csv 形式でダウンロードされます。
詳細フィルタの使用
"ソース" ドロップダウン メニューの下にある "詳細フィルタ" をクリックすると、"インポートするテーブル" プレビュー領域にデータのフィルタリング用オプションが表示されます。"詳細フィルタ" は、ステージング テーブル内のデータのサブセットをステージング テーブル内で、あるいは ("ソース" ドロップダウン メニューから "NetSuite" を選択した場合) 遠隔ソースから直接、表示および閲覧できるツールを提供します。
プレビュー領域は、特にステージング領域 (または NetSuite) のデータのごく一部をプレビューするためのものです。"スプレッドシート" 科目で利用できるデータを探索して、ステージング領域をチェックすることで予定のデータが入手できることを確認できます。この機能を使用して、使用するデータ インポートのフィルタを絞り込むこともできます。(プレビュー機能で設定されたフィルタは、ステージング領域の実際のデータには影響しません。)
"詳細フィルタ" のオプションは次のとおりです。
- 個別の行:重複する行を非表示にするには、このボックスをオンにします。
- 最大行数:プレビュー領域に表示される行数を制限するには、テキスト ボックスに数値を入力します。
- 列:このドロップダウン メニューの列をオンまたはオフにし、列を表示または非表示にします。
このリストから列を削除しても、その列はインポート リストから削除されません。
- SQL フィルタ: 大型のテキスト ボックスをクリックし、(先に示した) "SQL 式を編集" ダイアログ ボックスを表示します。ここで SQL フィルタを入力し、プレビューする行を制限することができます。"適用" をクリックして、フィルタの SQL 構文を自動的にチェックします。(エラーがある場合は、式にエラー箇所が示されます。)入力した式は、"データ インポートのフィルタ" フィールドに表示されます。詳細な SQL 構文のヘルプについては、"メモ" セクションでこちらをクリックしてください 。NetSuite には、きわめて限定的ながら非 SQL フィルタリング機能があります。非常に単純な式のみがサポートされています。
"フィルタを削除"
("ソース" ドロップダウンの隣) をクリックし、プレビュー ウィンドウの設定をクリアします。 NetSuite は特定の列をキー列に指定します。この情報はステージング テーブルに持ち込まれます。この情報は変更しないでください。
NetSuite からデータをインポート
NetSuite データ ソースを設定して保存すると、データをインポートできます。
NetSuite からデータをインポートするには:
- "アクション" メニューから、"データのインポート"をクリックします。選択したデータは、任意の SQL 式でフィルタリングされ、ステージング領域に読み込まれます。ステージング領域でデータをプレビューできます。
情報はクリアするまでステージング領域に残ります。
ステージング領域からデータをクリアするには:
- "アクション" メニューの"ステージング テーブルをクリア"をクリックします。データ ソース内のすべてのテーブルのステージング領域がクリアされます。
ベスト プラクティス:
NetSuite トランザクション タイプをインポートする場合、 対応する NetSuite トランザクション タイプのみを使用してください。NetSuite 保存済の検索条件のインポート
"NetSuite 保存済の検索条件" からのインポートは、2024 年 8 月 12 日より前に NetSuite インテグレーションを設定した場合のみ利用できます。
保存済の検索条件のインポートには、NetSuite アダプタが必要です。このデータ ソースの SSO 認証も設定する必要があります。
NetSuite 保存済の検索条件をインポートするには、データ デザイナーで保存済の検索条件を設定し、保存済の検索条件の構造をインポートする必要があります。インテグレーション内の保存済の検索条件は、NetSuite のカスタム レコード、カスタム フィールド、およびカスタム セグメントをサポートします。
データ デザイナーで保存済の検索条件を設定
- "アクション" メニューから、"保存済の検索条件の管理"をクリックします。
- "保存済の検索条件の管理"ダイアログ内で、ナビゲーション ツリーの下の "アクション" ボタンをクリックして "保存済の検索条件を追加" を選択するか、"保存済の検索条件" フォルダを右クリックして "保存済の検索条件を追加" を選択します。保存済の検索条件に "名前" をつけます。
- "NetSuite レコード タイプ"を選択します。
- "NetSuite 保存済の検索条件"を選択します。
- "適用"をクリックします。
保存済の検索条件の構造をインポート
- "管理された保存済の検索条件" ダイアログ内で、以前に作成した "保存済の検索条件" をクリックして選択します。
- ナビゲーション ツリーの下の "アクション" ボタンをクリックして、"アクション" メニューの"構造のインポート"を選択するか、"保存済の検索条件" を右クリックして、"構造のインポート"を選択します。
- "保存済の検索条件" 構造のインポートが成功したら、"管理された保存済の検索条件" ダイアログを閉じます。
- ステージング領域に、インポートした保存済の検索条件構造が個別のタブに表示されます。
"アクション" ペイン内の "構造のインポート" をクリックすると、"データ コンポーネント" パネル内のすべての "保存済の検索条件" がインポートされることに留意してください。
ベスト プラクティス:
"保存済の検索条件" 構造のインポートの結果が "NetSuite サマリ結果" の列を含まないことを確認してください。これは NetSuite Web サービス API による制限です。インポートできる "NetSuite 保存済の検索条件" の数は最大で 1000 です。
"NetSuite 保存済の検索条件データ インポート モード" を選択
- ステージング領域で、タブ内の矢印アイコンをクリックし、"NetSuite 保存済の検索条件" のテーブルを表示します。
- ドロップダウンから"テーブル設定"を選択します。以下の 2 つのオプションが利用できます。
- データのインポートが実行されるたびにすべてのレコードを置き換える:これがデフォルトです。インポート実行時にすべてのデータを置き換えられます。
- 送信された期間範囲内のあるすべてのレコード:パラメータを使って期間範囲を選択し、パラメータが適用される "保存済の検索条件" テーブルの日時列を選択できます。このダイアログ内の"パラメータを編集"をクリックし、使用する期間範囲パラメータを作成します。期間範囲のインポートを選択する場合、期間パラメータを設定する必要があります。設定しないと、インポートは失敗します。
- "適用"をクリックします。
- "アクション" パネルで"保存"をクリックします。
保存済の検索条件からデータをインポート
- "アクション" パネルから、"データのインポート"をクリックします。
- "NetSuite 保存済の検索条件" データはステージング領域にインポートされます。
NetSuite 保存済の検索条件の消去
- "アクション" ペインから、"管理された保存済の検索条件"をクリックします。
- "管理された保存済の検索条件" から保存済の検索条件を右クリックし、"削除"を選択します。保存済の検索条件は "保存済の検索条件の管理" ダイアログ一覧からは削除されますが、検索の構造は "構造のインポート" を再び実行するまで "データ コンポーネント" ペインおよび "ステージング" 領域に残ります。
NetSuite 内で NetSuite 保存済の検索条件が削除された場合、構造のインポートを実行する時にその検索は利用できない旨を告げるメッセージが表示されます。インテグレーション内ですでにデータ インポートに使用中の保存済の検索条件が NetSuite で変更された場合、以降のデータ インポートの成功は保証されません。
ベスト プラクティス:
NetSuite 内で、特にインテグレーションで使うための保存済の検索条件を作成し、他の NetSuite ユーザーに変更または削除されないように名前をつけます。ベスト プラクティス:
NetSuite において、保存済の検索条件の結果から返ってくるコンテンツを表示できる適切な権限を持っていることを確認してください。コンテンツを表示できる権限がない場合は、検索はゼロ レコードを返し、エラー メッセージは表示されません。これは NetSuite のオンライン ヘルプに記載されている NetSuite の制限です。 If you reference a saved search for which you do not have the permission, the exception is ignored and fields have no value (are not in the SOAP response at all).
インポートする NetSuite ファイル キャビネットのファイルの選択
NetSuite ファイル キャビネットの CSV ファイルを管理、選択して、ステージング テーブルとしてインポートできます。
ドリルスルーの実行元 Adaptive Planning NetSuite に戻る
Adaptive Planning
NetSuite に戻る NetSuite ドリルスルーは、2024 年 8 月 12 日より前に NetSuite インテグレーションを設定した場合のみ利用できます。
NetSuite からインポートしたデータのドリルスルーを有効化することができます。ドリルスルーのリンクは、Planning シートおよび NetSuite からインポートされた実績のレポートで利用可能になります。NetSuite のドリルスルーを設定するためには、内部識別子が Planning ローダ内の列マッピングの一部として使われていることを確認してください。NetSuite 外部システムを設定し、Planning ローダが使用するプロファイルに対応させる必要があります。
NetSuite 側の複数の列を単一の "計画" 属性にマッピングするよう設定する場合は、タプル SQL 列を使ってそれらの NetSuite 列をデータ ソース内で 1 つにまとめる必要があります。
詳細については、Planning データ ローダの作成のマッピング プロファイルの理解に関するセクションを参照してください。
- Planning から NetSuite へのドリルスルーを有効化するステップの概要
- 作業を開始する前に、Planning の"インテグレーション" > "NetSuite セットアップ"メニュー内の "強化されたバンドルベースのドリルスルー" チェックボックスがオンになっていることを確認します。属性マッピングを定義する NetSuite 外部システムを設定します。定義済みの属性マッピングに必要なデータ ソースの調整を行います。
- 同じ Planning 属性に複数の NetSuite カテゴリがマッピングされている場合は、NetSuite データ ソースに再度アクセスして、列の多対 1 マッピング向けの "タプル SQL 列" を追加します。
- "インポートするテーブル" 内で"Adaptive 転記トランザクションのサマリ"テーブルをクリックします。
- "Adaptive 転記トランザクションのサマリ"のドロップダウンで "列を管理" を選択します。
- 有効化AccountInternalId。
- 以下を有効にします。InternalIdsドリルする予定の他の属性
- データ ソースを保存します。
属性マッピングのデータ ソースの調整を使用して、必要なローダ調整を行います。- 上記の NetSuite データ ソースの設定が完了したら、NetSuite 実績データをインポートするように Planning データ ローダ を設定します。
- "NetSuite 外部システムの設定" 手順において設定した外部システムにプロファイルをリンクします。
- このプロファイルを Planning ローダに添付します。
- "列マッピング"タブをクリックします。
- 科目行の場合:
- "ソース ID"列で以下を選択します。accountInternalIdソース テーブルの
- "ソース表示名"列で表示名を選択します。
- ドリルしたい他の標準属性のそれぞれについて、上記の手順を繰り返します。
- ローダを保存します。
これらの手順をすべて完了すると、ドリルできるようになります。