RapidStart CRM セットアップ用 Business Central アドオン

高レベルの手順

1. 既存のDataverse対応環境を作成または使用します。
2. Dataverse対応環境にAppSourceからRapidStart CRMをインストールします。
3. Business Centralの会社システムIDを取得します。
4. Business Central内から統合を構成します。
5. Business Central統合アプリケーションユーザーの役割を確認します。
6. レコードマッピングを設定します。
7. 環境をリンクします（オプション）。
8. Dataverse対応環境にAppSourceからRapidStart CRM用のBusiness Centralアドオンをインストールします。
9. RapidStart設定アプリで完了します。

始める前に

Business Centralアドオンのセットアップを開始する前に、これらの要件を確認してください：

• Business CentralとDataverseは、Business Central仮想テーブルのために同じMicrosoft Entraテナント内にある必要があります。
• セットアップ中に必要なBusiness Centralの権限とDataverseシステム管理者アクセスを持つ人間のセットアップ管理者を使用してください。
• 接続する予定のDataverse環境にRapidStart CRMがインストールされていることを確認してください。

ステップ3：会社IDを取得する

会社IDを取得するには、Business CentralでCompaniesを検索します。対象の会社を選択し、Ctrl+Alt+F1を押してページ検査を開きます。表示されたIDをコピーして後で使用するために保存します。

ステップ4：Business Central内から統合を構成する

接続したいBusiness Central環境にログインします。

アドレスバーのBusiness Central環境名に注意してください。URLには会社表示名も表示される場合がありますが、前のステップで会社システムID GUIDをすでに取得しています。

Business Central環境名を、会社システムID GUIDを保存した同じメモにコピーします。

1. ギアをクリック
2. 「支援付きセットアップ」を選択

「他のシステムとの接続」セクションまでスクロールし、「Dataverseへの接続を設定」をクリックします。

1. データ同期を有効にすることを選択
2. 仮想テーブルとイベントを有効にすることを選択
3. 「次へ」をクリック

条件を受け入れて「次へ」をクリック

Dataverseへの接続を「常に許可」として受け入れ、「OK」をクリック

ターゲットDataverse対応環境を選択し、「Ok」をクリック

環境が正しいことを確認し、Dataverse環境にサインインするリンクをクリックします。サインイン後、「次へ」をクリック

推奨されるチーム所有権を選択し、同期なしで完了するように切り替え（後で行います）、「次へ」をクリック

1. Business Central仮想テーブルアプリをインストールするリンクをクリック
2. 「次へ」をクリック（新しいタブがAppSourceに開きます）

「今すぐ取得」ボタンをクリック（このアドオンは無料です）、次のページが開きます：

1. RapidStart CRMをインストールしたターゲット環境を選択します。
2. 条件に同意します。
3. 「インストール」をクリックします。

ソリューションが「インストール中」であることがわかります。完了するまで数分かかることがあります。「インストール済み」と表示されるまで、時々「更新」をクリックしてください。その後、Business Centralブラウザタブに戻って続行します。

「更新」をクリック

仮想テーブルアプリが正常にインストールされたことがわかります。「完了」をクリック

数分後、このページが表示されます。仮想テーブルタブを選択し、「利用可能な仮想テーブル」を選択します。

1. 「アイテム」行を選択して開始
2. 「有効にする」をクリック（これにより、Dataverseにアイテム用の仮想テーブルが作成されます）
3. 「表示」ボックスがチェックされるまで待ちます。数回更新する必要があるかもしれません。

これらの手順を以下の項目に対して繰り返します：salesInvoice、salesInvoiceLine、salesOrder、salesOrderLine、salesQuote、salesQuoteLine、salesShipment、およびsalesShipmentLine。これらを有効にするにはそれぞれ数分かかります。

表示/降順で並べ替えを変更し、これらのテーブルがすべて表示されていることを確認します。この時点で追加の仮想テーブルを追加しないでください。この画面をそのままにしておき（後で戻ります）、新しいタブを開きます。

ステップ5：Business Central統合アプリケーションユーザーを確認する

Business Central-Dataverse同期権限が損傷している場合は、Business CentralでDataverse接続設定を開き、統合ソリューションを再デプロイを使用してください。これにより、Microsoftの統合ソリューションが復元され、Business Central統合セキュリティロールがデプロイされます。

接続テストが成功し、Business Central統合アプリケーションユーザーがMicrosoftのBusiness Central Dataverse Integrationロールを持っていることを確認した後にのみ続行してください。

ステップ6：レコードマッピングとカップリングを設定する

顧客前に構成する参照マッピング

• 通貨： Business Central通貨 → Dataverse取引通貨。方向はBusiness CentralからDataverseへでなければなりません。これらの有効なフィールドマッピングを確認してください：コード → 通貨コード、シンボル → 通貨シンボル、説明 → 通貨名。
• 顧客マッピングに通貨コード → 通貨が含まれていることを確認します。顧客の前に通貨を同期します。Dataverseの基本通貨とBusiness Centralのローカル通貨は一致している必要があり、必要な為替レートが存在する必要があります。
• 支払い条件： 顧客テスト前にアカウント支払い条件に同期します。
• 出荷方法： 顧客テスト前にアカウント貨物条件に同期します。
• 配送業者： 顧客テスト前にアカウント配送方法に同期します。

顧客作成ポリシー

アカウント/会社がどちら側でも作成される可能性がある場合、顧客を双方向に設定します。その後、顧客展開の決定として同期。カップリングされたレコードのみポリシーを選択します：

オプション値の検証

支払い条件、出荷方法、配送業者に使用されるBusiness Centralの列挙値IDは、対応するDataverseオプションIDと一致している必要があります。表示テキストやコードラベルだけでは不十分です。Business CentralにDataverseに存在しないカスタム列挙値が含まれている場合、IDの不一致を修正するための完全な同期は行われません。

1. 支払い条件、出荷方法、配送業者の変更されたレコードを同期を実行します。
2. 顧客をテストする前に、Dataverseオプションマッピングと同期エラーログを確認します。
3. IDが一致していない場合、顧客フィールドマッピングの安全なデフォルトを使用します：支払い条件コード → 支払い条件 = FromIntegrationTable；出荷方法コード → 住所1：貨物条件 = FromIntegrationTable；配送業者コード → 住所1：配送方法 = FromIntegrationTable。
4. これらの3つのフィールドを双方向に変更するのは、開発者が両側に一致するオプションIDを追加した後のみです。
5. セットアップ中にオプションIDを発明したり、番号を変更したりしないでください。カスタムDataverse値とBusiness Central列挙拡張は、正確に同じIDを使用する必要があります。

開いていたブラウザのBusiness Centralタブに戻ります。

1. 「統合」タブをクリック
2. 次に「統合テーブルマッピング」

顧客の決定：Microsoftの標準的なDataverseユーザーからBusiness Central営業担当者への同期を顧客が望む場合、営業担当者を保持します。この標準的な同期が意図的に使用されない場合にのみ、このマッピングを削除または無効にします。

1. 連絡先を選択
2. カップリングを選択
3. 次に「マッチベースのカップリング」をクリック。
4. 上記と一致させて「OK」をクリック

1. 通貨を選択
2. カップリングを選択
3. 次に「マッチベースのカップリング」をクリック。
4. 上記と一致させて「OK」をクリック

顧客のためにマッピング/フィールドを選択
1. 「リストを編集」を選択
2. そして「アカウント番号」を有効にします。

顧客のために、カップリング/マッチベースのカップリングを選択します。スクリーンショットに示された顧客/アカウント識別子フィールドを使用して一致させ、両側で同じ顧客を一意に識別する一致フィールドを確認します。

支払い条件のために、カップリング/マッチベースのカップリングを選択します。Business Centralの支払い条件レコードを、設定されたIDによって対応するDataverseの支払い条件オプション値に一致させます。

出荷方法のために、カップリング/マッチベースのカップリングを選択します。Business Centralの出荷方法を、設定されたIDによって対応するDataverseの貨物条件オプション値に一致させます。

配送業者のために、カップリング/マッチベースのカップリングを選択します。Business Centralの配送業者を、設定されたIDによって対応するDataverseの配送方法オプション値に一致させます。

ベンダーのためにマッピング/フィールドを選択
1. 「リストを編集」を選択
2. そして「アカウント番号」を有効にします。

ベンダーのために、カップリング/マッチベースのカップリングを選択します。スクリーンショットに示されたベンダー/アカウント識別子フィールドを使用して一致させ、両側で同じベンダーを一意に識別する一致フィールドを確認します。

ステップ7：環境をリンクする（オプション）

誰かが誤って環境を削除するのを防ぐために、環境をリンクすることができます。Business Centralに戻ります。

1. ギアアイコンを選択
2. 次に管理センターを選択

ターゲット環境リンクを選択

「リンク」をクリックし、Dataverse環境を選択

ステップ8：AppSourceからRapidStart CRM用のBusiness Centralアドオンをインストール

MicrosoftのAppSourceを開き、ビジネスアカウントでログインしていることを確認するには、このリンクをクリックしてください。

インストールを開始するには「今すぐ取得」を選択します。

1. 仮想テーブルソリューションをインストールした環境を選択します。
2. 条件に同意します。
3. インストールをクリックします。インストールには数分かかることがあります。

ソリューションが「インストール中」であることがわかります。完了するまで数分かかることがあります。「インストール済み」と表示されるまで、時々「更新」をクリックしてください。

ステップ9：RapidStart設定アプリで完了

RapidStart CRMに移動し、RapidStart設定アプリを選択します。

RapidStart CRMのアプリセレクターから、またはメーカー ポータルからRapidStart設定アプリを開くことができます：
1. サイドバーでアプリを選択します。
2. RapidStart設定アプリの実行アイコンをクリックします。

1. RapidStart設定アプリにいることを確認します。
2. サイドバーで「アプリとアドオン」を選択します。
3. Business Centralアドオンの「構成」をクリックします。

このウィザードを使用して、欠落している項目を完了し、コネクタを管理します。

トラブルシューティング

接続IDが見つからない

フローが接続IDが見つからないと報告した場合、RapidStart設定アプリまたはPower AutomateでDataverseとBusiness Centralの接続参照を修復し、フローを再度オンにします。接続を再作成するだけでは、接続参照が古い接続にバインドされている場合は不十分です。

通貨マッピングエラー

顧客の同期が通貨で失敗した場合、通貨マッピングを復元または確認し、コード → 通貨コードが有効であることを確認し、通貨を同期し、顧客通貨がDataverseに存在することを確認してから顧客を再試行します。

オプションの不一致

支払い条件、出荷方法、または配送業者の値が有効なDataverse範囲外であるために同期が失敗した場合、Business Centralの列挙値IDがDataverseのオプションIDと一致していません。影響を受けた顧客フィールドマッピングにはFromIntegrationTableを使用し、一致するIDがデプロイされるまで使用します。

削除されたレコードを指すカップリング

レコードがカップリングされているように見えるが、同期が削除されたか欠落しているレコードを指している場合、Business Centralで古いカップリングを削除し、正しいDataverseアカウントまたは連絡先に新しいカップリングを作成してから同期を再実行します。