【cyzen→kintone】スポットを追加・更新する

「cyzen connect」を使って、cyzen上で登録されたスポット情報をkintoneに自動で出力（書き出し）する手順をご紹介します。

一度設定するだけで、以後はcyzenでスポット登録すると自動で反映されます。（5分程度のタイムラグはあります）

前提条件
事前準備
設定手順
関連ページ

📝前提条件

本手順は、cyzenで登録・更新されたスポット情報をcyzen connectを使ってkintoneに連携する基本手順です。

以下の内容は含まれていません。応用編のページを確認いただくか、連携先のkintoneなど別の方法で対応することを想定しています。

重複を加味した連携
→ cyzenで登録・更新があったスポットを全件kintoneに出力する手順になっています。cyzen connectで重複チェックを行うことも可能ですが、kintone上でも行うことができるので本手順からは省いています。（応用編で確認してください）
拡張項目の連携
→ 拡張項目を連携するには、通常の設定に加えて拡張項目を取得する設定が必要になるので、本手順からは省いています。（応用編で確認してください）
特定の条件での連携
→スポットタグを指定して取り込むなど、特定の条件を指定して連携するケースは本手順からは省いています。（応用編で確認してください）
初期導入について

→ 初期移行時に、cyzen内のスポット情報をkintoneへ全件移行する場合は、以下の方法を推奨します。（cyzen connect 経由での一括連携も可能ですが、タスク数に応じて費用が発生します。）
- 1) cyzenからスポットを一括出力
  　cyzenの管理画面から、現在登録されているスポット情報をCSV形式で出力します。
- 2) kintoneでインポート用ファイルを出力
  　kintoneのスポット登録先の環境から、登録テンプレート（出力ファイル）をエクスポートします。※登録がない場合でも、項目名だけのファイルが出力されます。
- 3) cyzenのデータをkintoneテンプレートに貼り付け
  　cyzenで出力したスポット情報を、kintoneテンプレートの各項目列にコピー＆ペーストして整えます。
- 4) 整えたファイルをkintoneにインポート
  　貼り付けたファイルをそのままkintoneにインポートすれば、スポットの初期登録が完了します。
なお、cyzenでスポット出力したデータには「スポット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アプリを用意する

スポット情報を出力するkintoneアプリを用意します。
kintoneアプリ内の項目には、必ず「スポットID」が設定できる場所を用意してください。「スポットID」は出力するスポットのキーとなるので、この値が同一のレコードは更新されたと判断することができます。

STEP 2：cyzen connect の設定（①フローボットの新規作成〜フローボットのトリガーの設定）

cyzen connectの管理画面にログインします。
画面左側のプロジェクト一覧から、対象プロジェクトを選択（もしくは＋から新規作成）します。
プロジェクトをクリックして開き、「フローボット」タブで「新規作成」をクリックします。
「はじめから作成」をクリックします。（テンプレートギャラリーに対象のテンプレートがあればそちらをお使いいただくと簡単に作成できます）
フローボットのタイトルを入力します。
（例）cyzen→kintoneにスポット連携
「特定のアプリイベント受信」をクリックし、「cyzen」＞「スポット情報が登録・更新されたら」を選択します。
以下の項目を入力します。
1. タイトル：任意のタイトル（例）スポットが登録・更新された
2. アプリ：「cyzen」
3. cyzenと連携するアカウント情報：「＋アカウントを追加」をクリックし、任意のアカウント名称とアクセストークン（スタティックトークン*用語集）を指定します。
  ※スタティックトークンはcyzenconnectご契約時に、cyzen-supportのアドレスから送付するメールに記載しています。
4. トリガーアクション：「スポット情報が登録・更新されたら」
「次へ」をクリックします。
「起動間隔」と「企業ID」を設定します。
※企業IDはcyzen担当者に確認してください。
「保存する」をクリックして、フローボットのトリガーの作成が完了です。

STEP 3：cyzen connect の設定（②kintoneへの出力設定）

kintoneにレコード追加する処理の設定です。
「＋」をクリックして、オペレーションタイプの選択で「kintone」＞「レコードを追加する」をクリックします。
以下の項目を入力します。
1. タイトル：任意のタイトル（例）レコードを追加する
2. データベースのアプリ：kintone
3. kintoneと連携するアカウント情報：「＋アカウントを追加」をクリックし、以下項目を入力します。
  1. サブドメイン：kintoneにログインした際のURLの以下●●部分がサブドメインです。
    https://●●●●.cybozu.com/k/#/portal
  2. クライアントID、クライアントシークレット：kintone管理者に確認してください。kintoneでマイアプリとしてyoom登録をすると取得できます。
  3. クライアント証明書ファイル・パスワード：クライアント証明書認証を設定されている場合のみ
4. 実行アクション：「レコードを追加する」
データベースの連携：アプリID：kintoneアプリのURL内の「/k/●●●/」の●部分がアプリIDとなります。
「次へ」をクリックします。
「追加するレコードの値」でkintoneの各項目に、cyzenから連携されたスポット情報のどの項目を設定するかマッピングさせます。

💡STEP1でkintoneの項目内に用意した「スポットID」に、cyzenから連携された「スポットID」をマッピングさせてください。「スポットID」は出力するスポットのキーとなるので、この値が同一のレコードは更新されたと判断することができます。

⚠️ 注意事項
cyzenでは、内部処理にUTC（協定世界時 *用語集）を使用しているため、出力される日時は 日本時間より9時間早い値になります。
そのため、作成日時や更新日時などを日本時間での表示にする場合は以下のような「+9時間」加算が必要です。
「保存する」をクリックして、スポットの追加設定の完了です。