本記事ではkintone連携のサンプルスクリプト（kintone顧客リストアプリで
ホットプロファイルリードデータを取り込む）の設定・利用手順をご案内いたします。
※kintone連携でできることについてはこちらをご確認ください。
※プラグイン（kintone案件管理アプリでホットプロファイルリードデータを取り込む）の
設定・利用手順につきましてはこちらをご確認ください。
概要
サンプルスクリプト動作概要
Kintone顧客リストアプリの取り込みボタン押下によりホットプロファイルのリードを取り込みます。
取り込み対象のリード情報が既に顧客リストアプリに存在する際は、
ホットプロファイル側のリード更新日時が新しい場合のみリードを取り込みます。
※公開APIオプションのお申込みがない場合、ご利用いただけません。
サンプルスクリプト制限事項・注意事項
- 本スクリプトはGoogleChrome バージョン54.0.2840.99 m (64-bit)で動作確認をしております。
- スマートフォンでは、使用することができません。
※kintoneプラグインはjavaスクリプトで書かれています。javaスクリプトの挙動はブラウザに
依存する部分が極めて高く、動作確認を上記chromeで行っておりますことをご了承ください。 -
ホットプロファイルからのデータ取得は一度のボタン押下で更新日時昇順より20件のデータが対象です。
※登録・更新件数が20件に満たない場合もありますので取得件数を増やす等適宜修正ください。 - ホットプロファイルの顧客情報を削除した場合も、Kintoneアプリ側に登録されたデータは
自動的に削除されません。 - ホットプロファイルにてデータ化中の名刺は取得対象に含まれません。
（リードとして登録されているデータが対象です） - 取得できるデータはAPIキーを発行したユーザーのアクセス権限設定の影響を受けます。
- ホットプロファイルオープンAPIの仕様により、リクエスト数が1,000回/5分を超えるとエラーとなります。
※エラーが表示された場合、5分以上時間をあけてから再度取得を行ってください。 - Kintoneアプリ側の登録済みレコードの量が大量になりますと動作が緩慢になる場合があります。
- 1日に240回以上取り込みボタンを押下すると、本スクリプトを設定したKintoneアプリの
リクエスト数が1万件に達する場合があります。
※Kintoneアプリの追加課金対象となる場合があるためご注意ください。 - 本スクリプト内では、一部の処理にDOM操作を含んでいるためKintoneのアップデートの
影響をうける可能性がある実装となっておりますため、参考にする際はご注意ください。 - サンプルスクリプトは、その動作を保証するものではありません。
- サンプルスクリプトの技術的なサポート等は行っていません。
- 本スクリプトを利用するにあたりオープンAPIの利用申し込みが必要となります。
サンプルスクリプト設定・利用方法
1. 事前準備
以下ご準備ください。
| 環境・システム | 提供元 | 備考 |
| ホットプロファイル | 株式会社ハンモック | ・リードが登録してある状態にしてください ・リードを取得したいユーザーのAPI連携を有効にしてください ※API連携有効化手順はこちらをご確認ください |
| サンプルスクリプト ・sample.js ・style.css |
株式会社ハンモック | ハンモックより提供します ※ファイルをご要望の場合、サポートデスクまでお問い合わせください |
| jquery-3.1.1.js | jQuery Foundation | JavaScriptライブラリです サンプルスクリプトと合わせてハンモックからご案内します |
| kintone および顧客リストアプリ | サイボウズ株式会社 | サイボウズ社より入手・作成してください |
※kintoneヘルプサイトもご一読お願いいたします。
2. Kintone顧客リストアプリフォーム設定
新規で顧客リスト管理アプリを作成します。
kintone 顧客リストアプリのフォームを設定します。
次のフィールドを作成・変更し、配置します。
※フォームの設定方法については、kintoneユーザーヘルプを確認ください。
| フィールド名 | フィールドコード | データ型 | 作成・変更内容 |
|---|---|---|---|
| 会社名 | 文字列__1行_ | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください |
| 部署名 | 文字列__1行_0 | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください |
| 担当者名 | 文字列__1行_1 | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください |
| 郵便番号(数字のみ) | Zipcode | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください ※[文字数(整数で指定)]の[最大]の数字を空白にしてください |
| TEL(数字のみ) | TEL | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください |
| FAX(数字のみ) | FAX | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください |
| 都道府県 | pref | 文字列 （1行） |
新規作成してください |
| 住所 | Address | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください |
| メールアドレス | 文字列 （1行） |
フィールドコードを確認し、異なる場合は変更してください | |
| 営業担当者 | owner_user_name | 文字列 （1行） |
新規作成してください |
| 名刺所有者 | user_names | 文字列 （1行） |
新規作成してください |
| リードソース | lead_source_kbn_name | 文字列 （1行） |
新規作成してください |
| リードソース(詳細) | lead_source | 文字列 （1行） |
新規作成してください |
| 備考 | 文字列__複数行_ | 文字列 （複数行） |
フィールドコードを確認し、異なる場合は変更してください |
| リードID | id | 文字列 （1行） |
新規作成してください |
| リードステータス | lead_status_name | 文字列 （1行） |
新規作成してください |
| HPF更新日時 | from_datetime_updated_on | 文字列 （1行） |
新規作成してください |
■フィールド配置例
各フィールドの配置の変更、不要なフィールドの未作成は、いずれも問題ありません。
各フィールドを変更、作成できましたら [ フォームを保存 ] してください。
3. スクリプト編集
sample.js を編集します。
次の箇所を変更し、ファイルを保存してください。
| 行番号 | デフォルトの文字列 | 設定する文字列の説明 |
|---|---|---|
| 14 | 45 | 登録いただくKintoneアプリのアプリIDに書き換えてください |
| 15 | 空欄 | ホットプロファイルのAPIキーを設定してください ※APIキー確認手順はこちらをご確認ください 例：da49dd8b-9501-4d79-b053-39db4xxxxxxx |
| 16 | https://hammock.hotprofile.biz | ホットプロファイルのURLが設定されていることを確認してください 問題無ければ変更不要です |
編集例）
4. kintoneアプリにスクリプトを設定
アプリの設定画面から、設定ファイルをアップロードします。
| 適用範囲 | アプリ管理者だけに適用 |
| PC用のJavaScriptファイル |
以下のファイルをアップロード |
|---|---|
| PC用のCSSファイル | 以下のファイルをアップロード ・style.css |
アップロード後、左上の [ 保存 ] ボタンをクリックします。
設定できましたら [ アプリの更新 ] ボタンをクリックし、変更を適用します。
5. 利用（リード情報を取得する）
[HotProfileリード取込み]ボタンを押下することでホットプロファイルに登録済みの
リード情報を追加・更新できます。
※ホットプロファイルのリード管理にリード情報が1件も登録されていない場合は、
追加・更新されません。
フィールド一覧
kintoneアプリの各フィールドに登録・更新を行う際のデータの対照表です。
別途管理者様にてkintone上でホットプロファイルの情報を参照させる場合、
以下の対照表をもとにフィールドの設定をお願いします。
| kintoneアプリ フィールド名 |
kintoneアプリ フィールドコード |
kintone アプリ データ型 |
HotProfile 項目名 |
備考 |
| 会社名 | 文字列__1行_ | 文字列 （1行） |
会社名 | |
| 部署名 | 文字列__1行_0 | 文字列 （1行） |
部署 | 部署 すべての組織名を返します |
| 担当者名 | 文字列__1行_1 | 文字列 （1行） |
氏名 | |
| 郵便番号(数字のみ) | Zipcode | 文字列 （1行） |
郵便番号 | |
| TEL(数字のみ) | TEL | 文字列 （1行） |
電話番号 | |
| FAX(数字のみ) | FAX | 文字列 （1行） |
FAX | |
| 都道府県 | pref | 文字列 （1行） |
都道府県 | |
| 住所 | Address | 文字列 （1行） |
住所 | |
| メールアドレス | 文字列 （1行） |
メールアドレス | ||
| 営業担当者 | owner_user_name | 文字列 （1行） |
営業担当者 | |
| 名刺所有者 | user_names | 文字列 （1行） |
名刺所有者 | すべての名刺所有者名を[,](カンマ)区切りで並べます |
| リードソース | lead_source_kbn_name | 文字列 （1行） |
リードソース | |
| リードソース(詳細) | lead_source | 文字列 （1行） |
リードソース(詳細) | |
| 備考 | 文字列__複数行_ | 文字列 （複数行） |
メモ | |
| リードID | id | 文字列 （1行） |
- | リードデータの持つ一意キー |
| リードステータス | lead_status_name | 文字列 （1行） |
リードステータス | |
| HPF更新日時 | from_datetime_updated_on | 文字列 （1行） |
更新日 |