はじめに

本資料では、Salesforceの取引先データをkintoneに同期するWindowsフォームのC#アプリケーションを作成する手順です。

使用するCData製品

※30日間の無償評価版

前提作業

SalesforeのAPIを利用できる権限のアカウントを保有していること。
kintoneのアカウントを保有しており、アプリテンプレートの「営業支援パック」でアプリを作成済みであること。
上記、ODBCドライバをインストールして、ODBCのDSNの設定が完了しており、Salesforce、および、kintoneへの「接続のテスト」が成功していること。

SalesforceのDSN設定情報

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

kintoneのDSN設定情報

kintoneの接続情報	設定項目
ユーザID	User
パスワード	Password
kintoneのサブドメイン含むサイトURL（例：https://**.cybozu.com）　※https://**.cybozu.com/k/の「/k」は不要	Url

プロジェクトの作成

VisualStudio2017を起動して、メニューバーの「ファイル > 新規作成 > プロジェクト」を開きます。

「新しいプロジェクト」ウィザードが起動するので、「VisualC# > Windowsフォームアプリケーション（.NET Framework）」を選択して、名前に「Salesforce2Kintone」と入力して「OK」ボタンをクリックします。

プロジェクト作成され、Formのデザイナが開きます。

DataGridViewの配置、および、データバインド

くので、Formを適当な大きさに拡大します。左側の「ツールボックス」の検索ボックスに「table」と入力して抽出された「TableLayoutPanel」を選択して、ドラッグ＆ドロップで、Form上に配置します。配置するときに、行列を「１行×３列」に設定して、Formいっぱいに拡大します。「TableLayoutPanel」が選択された状態で、右側のプロパティ内の「配置 > Anchor」を「Top, Left」から「Top, Bottom, Left, Right」に変更します。あわせて「配置 > Columns」を開き、「列と行のスタイル」ウィンドウにて「サイズの型」を以下の通り設定して保存します。

メンバー	サイズの型	値
Column1	Percent	45.00%
Column2	Percent	10.00%
Column3	Percent	45.00%

「TableLayoutPanel」のバランスが取れたところで、「ツールボックス」の検索ボックスにて「DataGridView」と入力して抽出された「DataGridView」を、「TableLayoutPanel」の左にドラッグ＆ドロップで配置します。「DataGridView」右上の小さな再生ボタン「▶︎」をクリックして、「データソースの選択」の「（なし）」右の下矢印をクリックして、「プロジェクトデータソースの追加」リンクをクリックします。

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

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

「ユーザーデータソースまたはシステムデータソース名を使用」のドロップダウンリストから既に作成しているSalesforceのODBC DSN「CData Salesforce Source」を選択して、「テスト接続」をクリックします。テスト接続に成功したら「OK」ボタンをクリックします。

「次へ」ボタンをクリックして進みます。

プロジェクト内のアプリケーション構成ファイルに保存する名称「ConnectionStringSalesforce」を入力して「次へ」を進みます。

Salesforce内のオブジェクトがテーブルリストとして表示されるので取引先に相当する「Account」にチェックを入れ、データセット名を「DataSetSalesforce」として「完了」ボタンをクリックします。

フォームのデザイナに戻り、左側の「DataGridView」に、ヘッダー行が追加されたことを確認します。「DataGridView」を選択して、プロパティ内の「配置 > Dock」を「Fill（四角の真ん中）」に変更します。これにより、「TableLayoutPanel」の中いっぱいに「DataGridView」が拡大されます。

今度は、右側の「DataGridView」にkintoneの情報をバインドする設定を行いましょう。Salesforceの時と同様に「データベース > データセット」を選択して進みます。

「データ接続の選択」の「新しい接続」から、今度は、「ユーザーデータソース名またはシステムデータソース名を使用」からkintoneのODBC DSN「CData Kintone Source」を選択します。「テスト接続」をクリックして、接続に成功したのを確認して「OK」ボタンをクリックします。

「次へ」ボタンをクリックします。

kintone側の接続文字列名を「ConnectionStringKintone」として「次へ」進みます。

kintone内のアプリがテーブルリストとして表示されるので、「顧客管理（営業支援パック）」にチェックを入れてデータセット名は「DataSetKintone」として「完了」ボタンをクリックします。

kintone側の「DataGridView」を選択して、プロパティ内の「配置 > Dock」を「Fill（四角の真ん中）」に変更します。

それでは、Salesforceとkintoneのデータが、「DataGridView」にバインドされるか確認してみます。メニューバー内の「▶︎開始」ボタンをクリックして実行してみます。しばらくすると「Form1」が起動して、Salesforceとkintoneのデータが表示されれば成功です。確認出来たら「■」の停止ボタンをクリックします。

次に、「DataGridView」内の不要な項目を非表示にすることで、より、左（Salesforce）右（kintone）の項目を比較しやすくします。まずは、左側のSalesforce側の「DataGridView」の右上の「▶︎」ボタンをクリックして「列の編集」リンクをクリックします。

「列の編集」の「選択された列」に以下の項目のみ残し、「OK」ボタンをクリックします。

選択された列	備考
Id	内部キー項目
Name	取引先名
BillingStreet	住所
BillingPostalCode	郵便番号
Phone	電話番号
Fax	Fax

同様に右側のkintone側の「DataGridView」の右上の「▶︎」ボタンをクリックして「列の編集」リンクをクリックします。「列の編集」の「選択された列」に以下の項目のみ残し、「OK」ボタンをクリックします。

選択された列	備考
RecordId	内部キー項目
Revision	レコードバージョン番号
郵便番号
顧客名
住所
TEL
FAX

再度、Salesforceとkintoneのデータが、必要項目のみ「DataGridView」にバインドされるか確認してみます。メニューバー内の「▶︎開始」ボタンをクリックして実行してみます。しばらくすると「Form1」が起動して、Salesforceとkintoneの項目が設定した項目のみ表示されれば成功です。確認出来たら「■」の停止ボタンをクリックします。

同期処理の実装

「ツールボックス」の検索ボックスにて「button」と検索して抽出された「Button」コントロールを、「TableLayoutPanel」の間に配置します。デフォルトでは右上に寄った配置となるため、「配置 > Anchor」を「None」に変更することで中央に移動します。また、「表示 > Text」をコピーを行う処理として「>>>」に変更して、ボタンをドラッグ＆ドロップ操作で縦に広げて大きくします。追加した「Button」コントロールをダブルクリックします。

「Form1.cs」のコードが表示されます。下イメージの「ここ」部分に下記のコードをコピーします。


            //// エラー処理は省略

            this.button1.Enabled = false;

            this.dataGridView1.Rows.Cast<DataGridViewRow>()
                .Where(o => o.Selected)
                .Select((o, i) => new { Row = (DataSetSalesforce.AccountRow)((DataRowView)o.DataBoundItem).Row, Index = i })
                .ToList()
                .ForEach(selected =>
                {
                    var row = this.dataSetKintone._顧客管理_営業支援パック_.Rows.Cast<DataSetKintone._顧客管理_営業支援パック_Row>()
                        .Where(o => o.顧客名 == selected.Row.Name)
                        .FirstOrDefault();

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

                    row.顧客名 = selected.Row.Name;
                    row.郵便番号 = selected.Row.IsBillingPostalCodeNull() ? "" : selected.Row.BillingPostalCode;
                    row.住所 = selected.Row.IsBillingStreetNull() ? "" : selected.Row.BillingStreet;
                    row.TEL = selected.Row.IsPhoneNull() ? "" : selected.Row.Phone;
                    row.FAX = selected.Row.IsFaxNull() ? "" : selected.Row.Fax;

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

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

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

            this.button1.Enabled = true;

コピー＆ペーストして、構文エラー（赤い波線）が出るようであれば、Datasetの名称など、これまでの設定内容と照らし合わせてください。特に構文エラーがない場合は、プロジェクトをリビルドして、再度、「▶︎開始」でプロジェクトを実行してみます。

Formが起動するので、左側のSalesforceのデータを一レコード選択した状態で、「>>>」ボタンをクリックしてみてください。右側に一レコード追加されれば成功です。

実際に、kintoneの画面を開き、追加されているか確認してみましょう。

もう一度、左側のSalesforceのデータの同じ一レコード選択した状態で、「>>>」ボタンをクリックしてみてください。今度はエラーで止まりました。

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

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

右側の「ソリューションエクスプローラー」から「DataSetKintone.xsd」を選択して、右クリックから「デザイナーの表示」を開きます。

「顧客管理（営業支援パック）　Table Adapter」のアイコンをクリックして、右下の「プロパティ」が「顧客管理（営業支援パック）　Table Adapter」になった事を確認して、「UpdateCommand」のプラスボタンを開き、「CommandText」を右側の「...」から開きます。　

「クエリービルダー」が開くので、下記の「郵便番号、住所、TEL、FAX」のみ更新するように変更します。

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

「OK」ボタンをクリッっくして「クエリービルダー」を閉じて、再度、、プロジェクトをリビルドして、再度、「▶︎開始」でプロジェクトを実行してみます。既にkintone側にコピー済みのレコードを再度Salesforce側のレコードを選択してコピーしてみます。kintone側のRevisionが「1」から「２」にカウントアップすれば成功です。

それでは、左側のSalesforce側のレコードをすべて選択して、コピーを実行してみましょう。

実行が完了したらkintone側の画面でみてみましょう。Salesforce側の取引先（Account）情報が、kintone側の顧客管理（営業支援パック）に同期されたことを確認出来たら完成です。

まとめ

資料では、Salesforceの取引先データをkintoneに同期するWindowsフォームのC#アプリケーションを作成する手順について説明しました。このように、最小限のプログラミングで、そして、ODBCというRDBと同じ規格で、Salesforceとkintoneの両方のSaasに接続してデータ連携を行うことが出来ます。