はじめに

本記事では、CData ODBCドライバを使って、PCA商魂・商管DXの顧客データを、Salesforce、kintoneと同期するWindowsフォームのC#アプリケーションを作成します。PCA商魂・商管DXは、ピー・シー・エー株式会社が提供するSaaS型の基幹業務ソフトです。

使用するCData製品

※こちらのリンクから30日の評価版、またはベータ版のインストーラを(.exe)をダウンロードできますので、インストールしてください。

前提

SalesforceのAPIを利用できる権限のアカウントを保有していること
kintoneのアカウントを保有しており、アプリテンプレートの「営業支援パック」でアプリを作成済みである
PCA商魂・商管DXのアカウントを保有していること
上記の3つのODBCドライバがインストール済みであること
Visual Studio がインストール済みであること　※今回はVisual Studio Community 2017を使用しました

ODBCドライバのDSN設定

各ODBCドライバのインストール後、またはインストール先フォルダにある「ConfigureODBC」を起動すると、下記のような「DSN構成」画面が立ち上がりますので、それぞれ接続情報を入力します。

各SaaSの接続情報は下記のとおりです。

PCA Salesの接続情報	設定項目
クライアントID	OAuth Client Id
クライアントシークレット	OAuth Client Secret
コールバックURL	Callback URL
デフォルトデータ領域	Default Data Area
プロダクトコード	Product Code
Web APIサーバのURL	Url

※コールバックURL、クライアントID、クライアントシークレットについては、PCA Web API 利用準備をご覧ください。

Salesforceの接続情報	設定項目
ユーザID	User
パスワード	Password
セキュリティートークン	Security Token

kintoneの接続情報	設定項目
ユーザID	User
パスワード	Password
kintoneのサブドメイン含むサイトURL	Url

※Urlは、https://***.cybozu.com/k/の「/k」は不要です

プロジェクト作成

Visual Studioで「Windowsフォームアプリケーション (.Net Framework)」プロジェクトを新規作成し、コンテナとコントロールを配置していきます。
ここで解説するプログラムは、こちらからダウンロードいただけます。

1．TableLayoutPanelコンテナ

Formのデザイナー画面で、Formを適当な大きさに拡大し、その中に「1行×3列」の「TableLayoutPanel」コンテナを配置します。サイズをFormいっぱいにするため「Dock」プロパティを「Fill」に設定してください。

2．TabControlコンテナ

作成したTableLayoutPanelコンテナの両端の列の中に「TabControl」コンテナを1つずつ配置します。この「TabControl」はどちらもサイズを最大にするため「Dock」プロパティを「Fill」に設定してください。また、左側のTabControlのタブページ数は1、右側のタブページ数は2に設定します。各タブページの見出し（Textプロパティ）は下記のように設定します。

フォーム左側タブページ1 : PCASales
フォーム右側タブページ1 : Saleforce
フォーム右側タブページ2 : kintone

3．DataGridViewの配置とデータソースの設定

これまでの作業でタブページが左側に1つ、右側に2つあります。各タブページの中に「DataGridView」を配置します。サイズは最大にするため「Dock」プロパティを「Fill」に設定してください。

この時点では、Formは下記のように表示されます。

次に、3つの「DataGridView」にデータソースを設定します。下記のように「DataGridView」を選択した際に表示される「▶」をクリックして、「データソースの選択」の「（なし）」右の下矢印をクリックして、「プロジェクトデータソースの追加」リンクをクリックします。

「データソース構成ウィザード」が立ち上がりますので「データベース」―「データセット」を選択して進みます。

次の「データ接続の選択」ウィンドウでは「新しい接続」をクリックして、さらに「データソースの選択」ウィンドウから「Microsoft ODBCデータソース」を選択して「OK」ボタンをクリックします。

続いて「接続の追加」ウィンドウでは「ユーザーデータソース名またはシステムデータソース名を使用」のドロップダウンリストから作成済みの今回使用するデータソースを選択して「テスト接続」をクリックします。テスト接続に成功したら「OK」ボタンをクリックします。3つのDataGridViewには、それぞれ下記のデータソースを指定します。

フォーム左側タブページ1 : CData PCASales Source
フォーム右側タブページ1 : CData Saleforce Source
フォーム右側タブページ2 : CData kintone Source

ここでは何もせず「次へ」をクリックします。

プロジェクト内のアプリケーション構成ファイルに保存する接続文字列に適当な名前をつけて、「次へ」を進みます。

選択したデータソースが持つテーブルのリストが表示されるので適当なテーブルをチェックし、データセット名を入力して「完了」ボタンをクリックします。

3つの各データソースで使用するテーブルと、そのデータセット名は下記のとおりです。このデータセット名は、c#プログラムで参照するため、正しく設定してください。

PCA Sales
- テーブル名 : MasterTMS
- データセット名 : DataSetPCASales
Salesforce
- テーブル名 : Account
- データセット名 : DataSetSalesforce
kintone
- テーブル名 : _顧客管理営業支援パック_
- データセット名 : DataSetKintone

データソース設定が完了すると、下記のように、そのDataGridViewにヘッダー行が表示されます。

このままでは不要な項目が多く見づらいため、各DataGridViewの不要なカラムを非表示にします。DataGridViewを選択した際に表示される「▶」をクリックして、そこで表示されるメニューから「列の編集」をクリックします。「列の編集」ウィンドウが開きますので、下記のように不要なフィールド名を選択後、「削除」ボタンをクリックします。

各DataGridViewに表示するフィールドは下記のとおりです。

PCA Sales（フォーム左側）
- TokuisakiCode
- TokuisakiMei1
- TokuisakiMei2
- YubinBango
- Jyusho1
- Jyusho2
- AitesakiTelNo
- AitesakiFaxNo
Salesforce（フォーム右側のタブページ1）
- Id
- Name
- BillingStreet
- BillingPostalCode
- Phone
- Fax
kintone（フォーム右側のタブページ2）
- RecordId
- Revision
- 郵便番号
- 顧客名
- 住所
- TEL
- FAX

以上の設定作業を、3つのDataGridViewに行ってください。完了後は「▶開始」ボタンをクリックして、アプリケーションを起動してみます。下記のように、各DataGridViewにデータソースがバインドされ、レコードの指定した項目のみが表示されます。

ボタンの配置と同期処理の実装

Formのデザイナー画面で、真ん中の列に「Button」を配置します。そのボタンが中央に来るように「Anchor」プロパティを「None」に設定してください。また「Text」プロパティに“>>”と入力します。最後に、配置したボタンをダブルクリックし、クリックイベントハンドラを追加します。この時、エディターで「Form1.cs」が開かれますので、下記のコードをコピー＆ペーストしてください。

        private void button1_Click(object sender, EventArgs e)
        {
            button1.Enabled = false;

            if (tabControl2.SelectedTab.Text == "Salesforce")
            {
                PCAtoSalesforce();
            }
            else
            {
                PCAtoKintone();
            }

            button1.Enabled = true;

        }

        private void PCAtoSalesforce()
        {
            dataGridView1.Rows.Cast<DataGridViewRow>()
                 .Where(o => o.Selected)
                 .Select((o, i) => new { Row = (DataSetPCASales.MasterTmsRow)((DataRowView)o.DataBoundItem).Row, Index = i })
                 .ToList()
                 .ForEach(selected =>
                 {
                     var name = selected.Row.TokuisakiMei1 + (selected.Row.IsTokuisakiMei2Null() ? "" : selected.Row.TokuisakiMei2);
                     var row = dataSetSalesforce.Account.Rows.Cast<DataSetSalesforce.AccountRow>()
                     .Where(o => o.Name == name)
                     .FirstOrDefault();

                     if (row is null)
                     {
                         row = dataSetSalesforce.Account.NewAccountRow();
                         //row.Id = "";
                         row.Id = selected.Index.ToString();
                     }

                     row.Name = name;
                     row.BillingPostalCode = selected.Row.IsYubinBangoNull() ? "" : selected.Row.YubinBango;
                     row.BillingStreet = (selected.Row.IsJyusyo1Null() ? "" : selected.Row.Jyusyo1) + (selected.Row.IsJyusyo2Null() ? "" : selected.Row.Jyusyo2);
                     row.Phone = selected.Row.IsAitesakiTelNoNull() ? "" : selected.Row.AitesakiTelNo;
                     row.Fax = selected.Row.IsAitesakiFaxNoNull() ? "" : selected.Row.AitesakiFaxNo;

                     if (row.Id == selected.Index.ToString())
                     {
                         dataSetSalesforce.Account.AddAccountRow(row);
                     }

                     accountTableAdapter.Update(dataSetSalesforce);
                 });

            accountTableAdapter.Fill(dataSetSalesforce.Account);
        }

        private void PCAtoKintone()
        {
            dataGridView1.Rows.Cast<DataGridViewRow>()
                .Where(o => o.Selected)
                .Select((o, i) => new { Row = (DataSetPCASales.MasterTmsRow)((DataRowView)o.DataBoundItem).Row, Index = i })
                .ToList()
                .ForEach(selected =>
                {
                    var name = selected.Row.TokuisakiMei1 + (selected.Row.IsTokuisakiMei2Null() ? "" : selected.Row.TokuisakiMei2);
                    var row = dataSetKintone._顧客管理_営業支援パック_.Rows.Cast<DataSetKintone._顧客管理_営業支援パック_Row>()
                    .Where(o => o.顧客名 == name)
                    .FirstOrDefault();

                    if (row is null)
                    {
                        row = dataSetKintone._顧客管理_営業支援パック_.New_顧客管理_営業支援パック_Row();
                        row.RecordId = selected.Index
                        + (dataSetKintone._顧客管理_営業支援パック_.Rows.Cast<DataSetKintone._顧客管理_営業支援パック_Row>().Max(o => (int?)o.RecordId) ?? 0)
                        + 1;
                        row.Revision = 0;
                    }

                    row.顧客名 = name;
                    row.郵便番号 = selected.Row.IsYubinBangoNull() ? "" : selected.Row.YubinBango;
                    row.住所 = (selected.Row.IsJyusyo1Null() ? "" : selected.Row.Jyusyo1) + (selected.Row.IsJyusyo2Null() ? "" : selected.Row.Jyusyo2);
                    row.TEL = selected.Row.IsAitesakiTelNoNull() ? "" : selected.Row.AitesakiTelNo;
                    row.FAX = selected.Row.IsAitesakiFaxNoNull() ? "" : selected.Row.AitesakiFaxNo;

                    if (row.Revision == 0)
                    {
                        dataSetKintone._顧客管理_営業支援パック_.Rows.Add(row);
                    }

                    顧客管理_営業支援パック_TableAdapter.Update(dataSetKintone);
                });

            顧客管理_営業支援パック_TableAdapter.Fill(dataSetKintone._顧客管理_営業支援パック_);
        }

プロジェクトをリビルド後、「▶開始」ボタンをクリックし、アプリケーションを起動します。PCASalesのDataGridViewで適当な行を選択した状態で、“>>”ボタンをクリックしてください。右側の表示されているタブのDataGridViewにそのレコードが追加されれば成功です。今回のプログラムは、右側に表示中のDataGridViewにバインドされているデータソースに対して、データの追加・更新を行いますので、タブを切り替えて「Salesforce」と「kintone」双方で試してみてください。

「kintone」タブでは成功しますが、「Salesforce」タブでは、「列'IsDeleted'にnullsを使用することはできません」というエラーが発生し失敗します。

このエラーは、SalesforceタブのDataGridViewにバインドされたデータソース「DataSetSalesforce」のNull値を許容しないフィールドがNullのまま、レコードが追加されたことが原因です。今回扱うデータは会社名、郵便番号、住所、TEL、FAXのみで、その他のフィールドは初期化もしないため、原因となっている「DataSetSalesforce」のフィールドのプロパティを変更します。

Visual Studioの「ソリューションエクスプローラー」から「DataSetSalesforce.xsd」を右クリックし、表示されるメニューから「デザイナーの表示」を選択します。

下記のようなペインが表示されます。ここに表示されているフィールド名をクリックするとプロパティが表示されます。これを見ると、「IsDeleted」フィールドの「AllowDBNull」プロパティはFalseなので、これをTrueに変更します。この他に「OwnerId」、「CreatedDate」、「CreatedById」、「LastModifiedDate」、「LastModifiedById」、「SystemModstamp」、これらのフィールドについても、同様に「AllowDBNull」プロパティをTrueに変更します。

プロジェクトをリビルド後、アプリケーションを起動し、「Salesforce」タブのDataGridViewにレコードが追加できることを確認してください。

次に「kintone」タブを選択し、追加済みのレコードを選択し、“>>”ボタンをクリックしてみてください。

「From1.cs」内の下記のUpdateするところで「[RecordId]列は読み取り専用です。この列の値を更新出来ません。」というエラーが発生します。これは、kintone側のレコード毎に保有のキー項目であるRecordIdは更新出来ないため発生します。そこで、必要な項目のみ更新するように変更します。

先ほどと同様に、Visual Studioの「ソリューションエクスプローラー」から「DataSetKintone.xsd」を右クリックし、表示されるメニューから「デザイナーの表示」を選択します。その後、下記のように、「顧客管理（営業支援パック）　Table Adapter」のアイコンをクリックして、右下の「プロパティ」が「顧客管理（営業支援パック）　Table Adapter」になった事を確認して、「UpdateCommand」のプラスボタンを開き、「CommandText」を右側の「...」をクリックします。　

クエリビルダーが開きますので、下記のようにクエリを変更します。

UPDATE                    Kintone."顧客管理（営業支援パック）"
SET                       郵便番号 = ?, 住所 = ?, TEL = ?, FAX = ?
WHERE                     (RecordId = ?)

プロジェクトをリビルド後、アプリケーションを起動し、もう1度、「kintone」タブを選択し、追加済みのレコードを選択し、“>>”ボタンをクリックしてみてください。「kintone」タブのDataGridViewの当該レコードの「Revision」が2になれば成功です。

kintoneにログインし、テーブルを見るとデータが追加されていることが分かります。

実は、この「kintone」タブで起こったエラーは「Salesforce」でも発生します。そのため、同様の手順でクエリビルダーを起動し、下記のようにクエリを編集してください。

UPDATE                    Salesforce.Account
SET                       BillingStreet = ?, BillingPostalCode = ?, Phone = ?, Fax = ?
WHERE                     (Id = ?)

最後に「PCASales」タブから「Salesforce」タブに、追加済みのレコードも含め、全てのレコードをコピーしてみます。

実行が完了したら、Salesforceにログインしデータを確認します。Salesforce側で追加したデータを確認できたら完成です。

まとめ

本記事では、PCA商魂・商管DXの顧客データを、Salesforceとkintoneに同期するWindowsフォームのC#アプリケーションを作成する手順について解説しました。このように、CData ODBCドライバを使うと、最小限のプログラミングでSaaS間のでデータを連携させることができます。プログラムは、こちらからダウンロードいただけます。