(3/4)Tsunagu 連携アプリパック for 勘定奉行 を使ってみる！～勘定奉行からkintoneへの連携編～

#<B>1.はじめに</B>
何回かに分けて、Tsunagu 連携アプリパック for 勘定奉行の使い方について書いています。

##1.1.ご注意ください
●本資料および本資料に関する弊社からの提供物は、使用者の責任で使用ください。
●本資料に記載されている会社名、製品名、サービス名等は各社の商標または登録商標です。

#<B>2.これまでの流れ</B>
前回はkintoneにスペーステンプレートをアップロードし、そこからスペースとアプリを作成しました。今回は勘定奉行からkintoneへのデータ連携の設定方法を紹介したいと思います。
※これまでの流れは [前回の投稿](https://qiita.com/NDK-Nishimura/items/26c74370d2fe5b6cfe4c) をご覧ください。

#<B>3.kintoneへの接続に必要な情報をメモする</B>
kintoneと勘定奉行のデータの受け渡しにはデータ連携ツール：Tsunagu for 奉行を利用します。ここでは、kintoneにアクセスし、Tsunagu for 奉行からの接続に必要な情報をメモしましょう。

1.［設定メニューを表示する］アイコンをクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/b705bee5-4f65-8afe-35a6-5ad31896aefd.png)

2.表示されたメニューの中から、［アプリ管理］をクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/67d555a7-23f2-fa84-0708-96b507e75410.png)

3.表示された［アプリの一覧］から、［ID］と［アプリ名］をメモします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/8225c213-6f91-d58a-5788-0c5a35f910af.png)

#<B>4.Tsunagu for 奉行［体験版］への接続</B>
Tsunagu for 奉行［体験版］はリモートデスクトップ接続して利用します。［体験版］を申し込んだ際に送付されたリモートデスクトップ接続の設定ファイルをダブルクリックして、接続してみましょう。

#<B>5.Tsunagu for 奉行の起動</B>
<font color="Red">※体験版の環境ではTsunaguのサーバ機能をサービスとして起動済みです。</font>開発用クライアント機能の［Tsunagu Studio］の起動から作業を開始しましょう。

1.Tsunagu Studio（以下、Studio） を起動します。
［スタートメニュー］-［すべてのプログラム］-［Tsunagu 1.0］-［Tsunagu Studio］から Studio を起動します。

2.Studio のログイン画面が表示されたらユーザーとパスワードを入力し、ログインします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/9b7795b4-ec90-7004-bf97-da99cbcf2b4e.png)

3.正常に起動すると Studio の画面が表示されます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/cbc71714-c570-3393-8f33-ab32c87dc2ce.png)

#<B>6.kintone への接続設定の追加</B>

##6.1.グローバルリリースの設定
Tsunagu for 奉行では、kintoneや勘定奉行に接続に必要な情報を［グローバルリソース］に登録して使用します。ここでは、kintoneアプリへの接続に必要な情報を登録します。設定はあらかじめ登録してある情報を変更して行います。

1.kintoneへの接続設定を行います。Studio左にある、［コントロールパネル］アイコンをダブルクリックしてください。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/39f82882-d8b2-ae97-aa34-62cf050dc9f9.png)

2.［グローバルリソースの設定］を選択します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/044c45de-30be-e3ff-de07-72a17d25e5c2.png)

##6.2.［勘定科目マスター］アプリへの接続設定の追加

1.［グローバルリリースの設定］ウィンドウの一覧にある［[アプリパック for 勘定奉行]勘定科目マスター］をダブルクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/2dee4e0e-e9a3-24a9-a1b3-b76ba703380d.png)

2.［勘定科目マスター］アプリへの接続に必要な情報の入力を行います。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/d7fc0ba6-0665-1a70-33a2-4dbe5a1495bc.png)

3.［接続テスト］をクリックし、実際に接続できるかを確認します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/ea33b127-d0f6-396f-ed5b-89b3c59eff52.png)
［接続テストに成功しました。］ダイアログが表示されたら、接続テストは成功です。［OK］ボタンをクリックし、ダイアログを閉じた後、［グルーバルリソースのプロパティ］の画面でも［OK］ボタンをクリックし、設定を保存します。

##6.3.その他のアプリへの接続設定
1.［5.2.］と同じ手順で以下のアプリへの接続設定を作成します。
●［補助科目マスター］アプリ	接続名：[アプリパック for 勘定奉行]補助科目マスター
●［部門マスター］アプリ		接続名：[アプリパック for 勘定奉行]部門マスター
●［取引先マスター］アプリ	接続名：[アプリパック for 勘定奉行]取引先マスター
●［摘要マスター］アプリ		接続名：[アプリパック for 勘定奉行]摘要マスター
●［伝票区分マスター］アプリ	接続名：[アプリパック for 勘定奉行]伝票区分マスター
●［物品購入申請］アプリ		接続名：[アプリパック for 勘定奉行]物品購入申請
※接続名は変更しないでください。変更すると、サンプルスクリプトの設定も変更が必要になります。

※いずれのアプリも以下の4つの項目のみを変更します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/26281ffd-95f9-9df9-0d3a-b08b28176b05.png)

##6.4.kintone REST APIへの接続設定
kintone REST APIへの接続設定は、物品購入申請アプリからデータをダウンロードした際、kintoneのプロセス管理のステータスを変更する（ステータスをひとつ進める）ために使用しています。

1.［[アプリパック for 勘定奉行]REST API］をダブルクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/aad93e6c-194d-c680-f8ce-7eabab00e0e9.png)

2.kintone REST API への接続に必要な情報の入力を行います。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/946e5fc7-833d-ba55-9846-678b68ff6f97.png)

3.［接続テスト］をクリックし、実際に接続できるかを確認します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/ab2f4d71-cf35-bdfb-788a-3ce9f71e22bb.png)
［接続テストに成功しました。］ダイアログが表示されたら、接続テストは成功です。［OK］ボタンをクリックし、ダイアログを閉じた後、［グルーバルリソースのプロパティ］の画面でも［OK］ボタンをクリックし、設定を保存します。

#<B>7.サンプルスクリプトのアップロード</B>

##7.1.サンプルスクリプトのアップロード
サンプルスクリプトをTsunagu for 奉行に読み込ませます。

1.Tsunagu Studioにある［マイ プロジェクト］アイコンをダブルクリックしてください。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/39a89008-a7ff-95d5-86aa-9cf9a7c306ce.png)

2.［ファイル］メニューから［ローカルからアップロード］を選択します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/cdc56a27-c3d8-5df8-7560-060b475f9d03.png)

3.フォルダ［アプリパック for 勘定奉行］を選択し、［開く］ボタンをクリックします。
※上記フォルダは Windows デスクトップの［Tsunagu連携アプリパック for 勘定奉行］フォルダの中の［Tsunagu for 奉行 サンプルスクリプト］フォルダにあります。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/362e7798-2a0e-9af0-0f31-53821b4f3946.png)

4.［新しいプロジェクトとしてアップロード］を選択し、［OK］ボタンをクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/b10fcc5c-db8b-0dd2-a3b0-ac00c3033ba0.png)

5.［アップロード完了］のダイアログが表示されれば、アップロード完了です。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/6d1876e6-5b8d-486a-8fc4-9846239c4c9e.png)

6.［アプリパック for 勘定奉行］のスクリプトがアップロードされました。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/91e0761f-8926-2867-b337-beca60cd9488.png)

#<B>8.サンプルスクリプトの動作確認</B>

##8.1.サンプルスクリプトの動作確認

1.Tsunagu Studioにある［マイ プロジェクト］アイコンをダブルクリックしてください。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/0e444029-f92c-83a1-33b3-d36946eab721.png)

2.先程、アップロードした［アプリパック for 勘定奉行］をダブルクリックし、プロジェクトを［デザイナ］で開きます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/220b9e9f-5886-37d9-cb51-10ef82ec280a.png)

##8.2.［勘定科目マスターの連携］の動作確認
~~※サンプルスクリプトの［勘定科目マスターの連携］処理では、kintoneアプリのデータを全件削除した後、全件登録しなおしています。あらかじめデータが登録されている場合、データそのものはもちろん、各データに対するコメントや変更履歴も削除され、消失します。必ず、実行の是非を判断ください。~~
<font color="Red">※kintoneアダプタの機能向上に伴い、UPSERT処理に対応しました。</font>

1.［プロジェクトエクスプローラ］で［勘定科目マスターの連携］をダブルクリックします。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/bfbcbef9-d762-d5ca-f5d4-79fabee24ba1.png)

2.画面上部の［スクリプトのデバッグ実行の開始／再開］ボタンをクリックし、スクリプトを実行します。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/5cb57111-4741-e3e0-9aa8-982c31a0c67d.png)

3.［スクリプトの実行に成功しました］のダイアログが表示されれば、実行成功です。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/c2fab273-6829-e2eb-8de5-8b06f95f73ba.png)

4.kintoneの［勘定科目マスターアプリ］にアクセスすると、勘定奉行の勘定科目マスターが連携されていることが確認できます。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/a48f0e63-65aa-718e-cc49-4751d4974cae.png)

##8.3.その他の［マスターの連携］の動作確認
1.［7.2］と同じ手順で以下のサンプルスクリプトを実行します。
●補助科目マスターの連携
●部門マスターの連携
●取引先マスターの連携
●摘要マスターの連携
●伝票区分マスターの連携
~~※サンプルスクリプトの［補助科目マスターの連携］、［部門マスターの連携］、［摘要マスターの連携］、［伝票区分マスターの連携］の各処理では、kintoneアプリのデータを全件削除した後、全件登録しなおしています。あらかじめデータが登録されている場合、データそのものはもちろん、各データに対するコメントや変更履歴も削除され、消失します。必ず、実行の是非を判断ください。~~
<font color="Red">※kintoneアダプタの機能向上に伴い、UPSERT処理に対応しました。</font>

2.いずれのサンプルスクリプトも［スクリプトの実行に成功しました］のダイアログが表示されれば、実行成功です。
![image.png](https://qiita-image-store.s3.amazonaws.com/0/132039/9220ae2a-1566-e791-9315-42083d359a41.png)

3.kintoneの［各マスター系アプリ］にアクセスすると、勘定奉行のマスターデータが連携されていることが確認できます。

#<B>9.最後に</B>
　ここまでの手順で、Tsunagu 連携アプリパック for 勘定奉行（以下、連携アプリパック）に、勘定奉行のマスタをアップロードすることができました。Tsunagu for 奉行を使うことで、煩雑になりがちなkintoneアプリへのデータアップロード作業をカンタンに実現し、手間をかけずに運用することができます。次回はkintoneアプリに入力した購買申請データから、勘定奉行の仕訳伝票データを生成し、勘定奉行にインポートするところまでを見てみたいと思います。