※cyzen connect（Yoom）の操作環境はGoogle Chrome推奨です。
「cyzen connect」を使って、cyzenで提出された報告書をkintoneに自動で出力（書き出し）する手順をご紹介します。
一度設定するだけで、以後はcyzenで報告書が作成・更新されると自動で反映されます。（5分程度のタイムラグはあります）
📝前提条件
本手順は、cyzenで作成・更新された報告書情報をcyzen connectを使ってkintoneに連携する基本手順です。
以下の内容は含まれていません。応用編のページを確認いただくか、連携先のkintoneなど別の方法で対応することを想定しています。
重複を加味した連携
→ cyzenで作成・更新があった報告書を全件kintoneに出力する手順になっています。cyzen connectで重複チェックを行うことも可能ですが、kintone上でも行うことができるので本手順からは省いています。（応用編で確認してください）
特定の条件での連携
→ 報告書名を指定して取り込むなど、特定の条件を指定して連携するケースは本手順からは省いています。（応用編で確認してください）
初期導入について
→ 初期移行時に、cyzen内の報告書をkintoneへ全件移行する場合は、以下の方法を推奨します。（cyzen connect 経由での一括連携も可能ですが、タスク数に応じて費用が発生します。）
cyzenから対象の報告書を一括出力
cyzenの管理画面から、現在登録されている報告書を出力します。kintoneでインポート用ファイルを出力
kintoneの報告書登録先の環境から、登録テンプレート（出力ファイル）をエクスポートします。※登録がない場合でも、項目名だけのファイルが出力されます。cyzenのデータをkintoneテンプレートに貼り付け
cyzenで出力した報告書情報を、kintoneテンプレートの各項目列にコピー＆ペーストして整えます。整えたファイルをkintoneにインポート
貼り付けたファイルをそのままkintoneにインポートすれば、報告書の初期登録が完了します。
なお、 cyzenの報告書出力では「報告書ID(レポートID)」が含まれません。
そのため、今後その報告書が更新されてkintoneに連携されると、同じ報告書が「IDなしの旧レコード」と「IDありの新レコード」として2行存在する可能性があります。
その場合は、cyzen connectを使って連携されたID付きの新レコードが最新版ですので、IDなしの旧レコードは削除して問題ありません。
※初期移行後、更新されない報告書については、 IDなしのまま残していただいて構いません。
💡 報告書ID(レポートID)とは？
各報告書の固有のIDで、cyzenでは内部で保持している項目です。
通常の操作画面では意識する必要はありませんが、
cyzen connect でkintoneと連携する際には含まれる
重要な項目です。このIDをkintoneに保持しておくことで、
将来的な更新や重複チェック時のキーとして
活用することが可能になります。
事前に準備すること
cyzen connect 利用契約
→ ライトプラス以上のプランをご利用中のお客様で別途cyzen connectの契約が必要ですkintone環境
→ 出力先となるkintoneの環境をご準備ください出力したい報告書項目の洗い出し
→ 報告書名/報告日時/スポットなど、どの項目を出力するか洗い出しておきます
🔧 設定手順（約10分）
STEP 1：連携先のkintoneアプリを用意する
1. 報告書情報を出力するkintoneアプリを用意します。
2. kintoneアプリ内の項目には、必ず「報告書ID（レポートID）」が設定できる場所を用意してください。「報告書ID（レポートID）」は出力する報告書のキーとなるので、この値が同一のレコードは更新されたと判断することができます。
STEP 2：cyzen connect の設定（①フローボットの新規作成〜フローボットのトリガーの設定）
1. cyzen connectの管理画面にログインします。
2. 画面左側のプロジェクト一覧から、対象プロジェクトを選択（もしくは＋から新規作成）します。
3. プロジェクトをクリックして開き、「フローボット」タブで「新規作成」をクリックします。
4. 「はじめから作成」をクリックします。（テンプレートギャラリーに対象のテンプレートがあればそちらをお使いいただくと簡単に作成できます）
5. フローボットのタイトルを入力します。
（例）cyzen→kintoneに報告書連携
6. 「特定のアプリイベント受信」をクリックし、「cyzen」＞「報告書が作成・更新されたら」を選択します。
7. 以下の項目を入力します。
- タイトル：任意のタイトル（例）報告書が作成・更新された
- アプリ：「cyzen」
- cyzenと連携するアカウント情報：「＋アカウントを追加」をクリックし、任意のアカウント名称とアクセストークン（スタティックトークン*用語集）を指定します。 ※スタティックトークンはcyzenconnectご契約時に、cyzen-supportのアドレスから送付するメールに記載しています。 トリガーアクション：「報告書が作成・更新されたら」
8. 「次へ」をクリックします。
9. 「起動間隔」と「企業ID」を設定します。
※企業IDはcyzen担当者に確認してください。
10. 「テスト」をクリックします。直近で連携対象となっているレコードを使って取得する項目を確認することができます。
a) 「テスト」をクリックします。
b) 「取得した値」に標準で取得される項目が表示されています。ここにある項目は後の処理でkintoneに登録する時に使うことができるので、これ以外を取得したい場合は、「取得する値を追加」から追加する必要があります。
c) 「追加したい値の「＋」をクリックしてください。」の画面が表示され、取得できるデータの一覧が表示されています。
d) 例えば、「スポット名(spot_name)」と「スポット住所(spot_address)」を追加で取得する場合、「＋」をクリックして追加します。
e) 「追加」をクリックすると「取得した値」の一覧に追加されています。
f) 項目名を変更することもできます。
11. 「保存する」をクリックして、フローボットのトリガーの作成が完了です。
STEP 3：cyzen connect の設定（②kintoneへの出力設定）
1. kintoneにレコード追加する処理の設定です。
2. 「＋」をクリックして、オペレーションタイプの選択で「kintone」＞「レコードを追加する」をクリックします。
3. 以下の項目を入力します。
- タイトル：任意のタイトル（例）レコードを追加する
- データベースのアプリ：kintone
- kintoneと連携するアカウント情報：「＋アカウントを追加」をクリックし、以下項目を入力します。
- 実行アクション：「レコードを追加する」
- サブドメイン：kintoneにログインした際のURLの以下●●部分がサブドメインです。 https://●●●●.cybozu.com/k/#/portal
- クライアントID、クライアントシークレット：kintone管理者に確認してください。kintoneでマイアプリとしてyoom登録をすると取得できます。
- クライアント証明書ファイル・パスワード：クライアント証明書認証を設定されている場合のみ
4. データベースの連携：アプリID：kintoneアプリのURL内の「/k/●●●/」の●部分がアプリIDとなります。
5. 「次へ」をクリックします。
6. 「追加するレコードの値」でkintoneの各項目に、cyzenから連携された報告書情報のどの項目を設定するかマッピングさせます。
💡STEP1でkintoneアプリ内の項目に用意した「報告書ID」に、cyzenから連携された「レポートID」をマッピングさせてください。「報告書ID（レポートID）」は出力する報告書のキーとなるので、この値が同一のレコードは更新されたと判断することができます。
⚠️ 注意事項
cyzenでは、内部処理にUTC（協定世界時 *用語集）を使用しているため、出力される日時は 日本時間より9時間早い値になります。
そのため、作成日時や更新日時などを日本時間での表示にする場合は以下のような「+9時間」加算が必要です。
7. 「保存する」をクリックして、報告書の追加設定の完了です。
STEP 4：フローボットをONにして、動作確認を行う
1. フローボットのトリガーを「ON」にします。ONにすると、以降報告書の作成・更新があったらこのフローボットが動きます。
2. cyzenで報告書をを1件作成してみてください。
3. 数分後、自動でkintoneに反映されていることを確認できれば設定完了です。