カテゴリー内の他の記事

Sansan for kintone

フォローする

2019年10月以降は本プラグインはご利用頂けません。

 Sansan API アップデートに伴う改修について

本記事で紹介しているプラグインは Sansan API ver1.1 を利用しています。
Sansan API ver1.x は2019年9月30日に廃止予定です。
cybozu developer network では、今回の廃止において ver2.x への改修はしません。

そのため、2019年10月以降は本プラグインはご利用頂けません。
ご不便、ご迷惑をおかけし大変申し訳ございませんが、ご理解のほどよろしくお願いいたします。

また、TiS 様よりSansan API ver2.x の対応をしている kintone 連携プラグインが無償公開されていますので、そちらも合わせてご確認ください。

Sansan名刺連携プラグイン

Index

注意事項

  • サンプルプラグインは、その動作を保証するものではありません。
  • サンプルプラグインの技術的なサポート等は行っていません。
  • 本プラグイン内では、一部の処理にDOM操作を含んでいます。アップデートの影響をうける可能性がある実装となっており、参考にする際はご注意ください。
  • 本プラグインは新デザインを想定して作成しております。旧デザインでは動作不良を起こす可能性がありますのでご注意ください。
  • 本プラグインをv2.0.2以前のプラグインからアップデートする際はプラグインの設定画面より設定を再保存する必要があります。
  • 設定画面で保存する際、エラーが出る場合は[コピー先フィールド]内の項目を初期値から変更いただくことで対応いただけます。
  • kintoneプラグインはスタンダードコースでのみご利用いただけます。ライトコースではご利用いただけませんのでご注意ください。

概要

Sansan, Inc.の提供する名刺管理サービス「Sansan」を利用している方向けのプラグインです。Sansanの詳細はこちら

アプリに Sansan for kintone プラグインを追加すれば、 Sansan で管理している顧客情報を参照し、コピーすることができます。
アプリの指定したフィールドの値をキーワードに検索を行い、検索条件に一致したデータがルックアップにより表示されます。
※本プラグインは、アプリストアの「顧客リスト」に適用することを想定しています。

検索対象には、Sansan の次の情報を指定できます。

  • 会社名
  • 氏名
  • メールアドレス
  • 電話番号
  • 携帯番号

▼主要なアップデート情報
2016/07/19: 複数の名刺データを一括登録できるようになりました。
2016/08/18: レコード一覧画面で Sansan に検索する対象をドロップダウンで選択する機能が追加されました。
2016/09/16:「名刺交換日」、「郵便番号」、「Fax」をコピー先フィールドとして指定できるようになりました。
2017/03/13:レコード一括登録時のUpsert機能[レコード一覧画面]が追加されました。その他追加機能は「更新履歴」を参照ください。

Sansan for kintone を利用する

STEP1:フォームを設定する

アプリのフォームを設定します。次のフィールド、スペースを配置します。

  • 検索キーワードにするフィールド
    Sansan の検索キーワードとして使用するフィールドを配置します。次の種類のフィールドを使用できます。
    • 文字列(1行)フィールド
    • リンクフィールド
  • コピー先フィールド
    Sansan より取得した戻り値をコピーするフィールドを配置します。次の種類のフィールドを使用できます。
    • 文字列(1行)フィールド
    • リンクフィールド
  • 検索ボタンを配置するフィールド(※ルックアップ機能を利用する場合)
    検索ボタンを表示する場所に、「スペース」フィールドを配置します。
    また、配置したフィールドには、任意の「要素ID」を指定する必要があります。

フィールド配置例

ほかのフィールドの配置は任意です。

「検索キーワードにする」フィールドの右側に「スペース」フィールドを横長に配置することで、標準機能のルックアップのように使用できます。

STEP2:アプリにプラグインを追加する

アプリにSansan for kintoneプラグインを追加します。プラグインの追加方法は、kintone ヘルプを参照してください。
プラグインを追加する

STEP3:プラグインを設定する

  1. アプリ管理画面の「詳細設定」>「プラグイン」を開き、Sansan for kintone プラグインの歯車マークをクリックします。
  2. 各項目を設定します。(※はアップデートにより追加された項目です。
    項目名 説明
    Sansan API Key

    Sansan の管理画面で発行した、API Keyを入力するフィールド。(必須項目)

    使用する機能※

    本プラグインで使用する機能のON/OFFを切り替えることができる。

    • ルックアップ機能[レコード追加/編集画面]
    • レコード一括登録機能[レコード一覧画面]※
    • レコード一括登録時のUpsert機能[レコード一覧画面]※
    ルックアップ機能設定項目:
    検索ボタン配置スペース

    ここで指定した「スペース」フィールドに、「取得」「クリア」「期間」の枠なしボタンを配置する。
    ※フィールドコードの設定がない「スペース」フィールドに関しては表示しない。

    ルックアップ機能設定項目:
    検索キーフィールド

    このフィールドに入力した文字を元に Sansan のデータを検索する。
    次のフィールドタイプのフィールドを選択肢に出し設定できる。

    • 文字列(1行)
    • リンク(メールアドレス)
    • リンク(電話番号)
    ルックアップ機能設定項目:
    コピー元のSansanフィールド

     

    kintone側の検索フィールドの値に、このSansanフィールドが該当した場合、検索結果を返す。
    次のフィールドをドロップダウンで設定できる。

    • 会社名
    • 氏名
    • メールアドレス
    • 電話番号
    • 携帯番号
    Upsert機能設定項目:
    Upsert用キーフィールド※

    Upsert機能で使用するキーフィールドを選択します。重複禁止が設定された文字列一行フィールドのみ選択可。「人物ID」での利用を想定。

    コピー先フィールド※

    Sansanの戻り値をコピーするフィールドを予め設定する。
    以下のフィールドをドロップダウンで設定できる。太字はアップデートによる追加項目

    • 名刺ID:文字列(1行)
    • 会社ID:文字列(1行)
    • 人物ID:文字列(1行)
    • 名刺交換日:文字列(1行) or 日付 or 日時
    • 名刺登録日時:文字列(1行) or 日付 or 日時
    • 名刺所有者ID:文字列(1行)
    • 名刺所有者名:文字列(1行)
    • 氏名:文字列(1行)
    • 氏名カナ:文字列(1行)
    • 部署名:文字列(1行)
    • 役職名:文字列(1行)
    • E-mail:文字列(1行)or リンク(メールアドレス)
    • 携帯:文字列(1行)or リンク(電話番号)
    • 会社名:文字列(1行)
    • 郵便番号:文字列(1行)
    • 住所:文字列(1行)
    • TEL:文字列(1行)or リンク(電話番号)
    • TEL2:文字列(1行)or リンク(電話番号)
    • Fax:文字列(1行)or リンク(電話番号)
    • メモ:文字列(1行)or 文字列(複数行)
    • URL:文字列(1行)or リンク(Webサイトのアドレス)

    プラグイン設定画面
    Sansan_plugin_image.png
  3. [保存]をクリックします。
  4. 「アプリの設定」画面で[設定完了]をクリックすると、プラグインの設定がアプリに反映されます。

STEP4:プラグインを利用する

ルックアップ機能[レコード追加/編集画面]

レコードの追加/編集画面でSTEP3に設定されたスペースに「取得/クリア/期間」ボタンが作成されます。

  • 「取得」ボタンをクリックした場合
    • 設定画面で設定した、「検索キーフィールド」「コピー元のSansanフィールド」を元に、Sansanに検索リクエストを送信します。
    • 検索結果の戻り値をウィンドウに表示します。
    • 各列左端に「選択」ボタンを表示されます。「選択」ボタンをクリックすると設定画面で設定した通り、Sansanから取得した結果がkintoneのレコードにコピーされます。
  • 「クリア」ボタンをクリックした場合
    • kintone上のコピー先にコピーしてある値をクリアします。
  • 「期間」ボタンをクリックした場合
    • 「名刺登録日」か「名刺更新日」の期間でSansanに検索リクエストを送信します。※2017/03/13 アップデート追加機能
    • 開始日付と終了日付を入力するウィンドウを表示します。
    • 「OK」ボタンをクリックすると、設定された期間を元にSansanに検索リクエストを送信します。
    • 検索結果の戻り値をウィンドウに表示します。
    • 各列左端に「選択」ボタンを表示されます。「選択」ボタンをクリックすると設定画面で設定した通り、Sansanから取得した結果がkintoneのレコードにコピーされます。

レコードの追加/編集画面

「取得」ボタンクリック時の画面

「期間」ボタンクリック時の画面

Sansan_plugin_image3.png

レコード一括登録機能[レコード一覧画面] ※2016/07/19 アップデート追加機能

レコードの一覧画面でヘッダー部分に検索項目を選択するドロップダウン、一括登録用の検索フォーム、虫眼鏡マークのボタン、タグマークのボタンが表示されます。

  • ドロップダウン ※2016/08/18 アップデート追加機能
    • Sansan のデータに検索をかける際の検索キーを選択します。
  • 検索フォーム
    • この検索フォームに入力した文字を元に Sansan のデータを検索します。
  • 虫眼鏡マークのボタンをクリックした場合
    • 「ドロップダウンの値」と「検索フォームの値」を元に、Sansanに検索リクエストを送信します。
    • 検索結果の戻り値をウィンドウに表示します。
    • 各列左端にチェックボックスが表示されます。登録したい名刺データにチェックを入れて「登録」ボタンを押すと設定画面で設定した通り、Sansanから取得した結果がkintoneのレコードに一括登録されます。
  • タグマークのボタンをクリックした場合
    • Sansan より「共有タグ」のみを取得し、一覧を表示します。表示順は昇順となります。
    • 「選択」ボタンをクリックすると選択したタグの名刺データの一覧を表示します。
      このとき「検索フォーム」に値が入力されていた場合、「ドロップダウンの値」を元に絞り込むことができます。
    • 各列左端にチェックボックスが表示されます。登録したい名刺データにチェックを入れて「登録」ボタンを押すと設定画面で設定した通り、Sansanから取得した結果がkintoneのレコードに一括登録されます。
  • カレンダーマークのボタンをクリックした場合
    • 「名刺登録日」か「名刺更新日」の期間でSansanに検索リクエストを送信します。※2017/03/13 アップデート追加機能
    • 開始日付と終了日付を入力するウィンドウを表示します。
    • 「OK」ボタンをクリックすると、設定された期間を元にSansanに検索リクエストを送信します。
    • 検索結果の戻り値をウィンドウに表示します。
    • 各列左端にチェックボックスが表示されます。登録したい名刺データにチェックを入れて「登録」ボタンを押すと設定画面で設定した通り、Sansanから取得した結果がkintoneのレコードに一括登録されます。

レコードの一覧画面

Sansan_plugin_image6.png

虫眼鏡マークのボタンクリック時の画面

Sansan_plugin_image2.png

登録ボタンクリック時の画面

タグマークのボタンクリック時の画面

「選択」ボタンクリック以降は「虫眼鏡マークのボタンクリック時の画面」と「登録ボタンクリック時の画面」と同様です。

レコード一括登録時のUpsert機能[レコード一覧画面] ※2017/03/13 アップデート追加機能

  • レコード一括登録時に取得項目に「人物ID」項目がセットされており、かつ対象フィールドに重複禁止の設定がされている場合にUpsert機能を利用することができます。
  • Upsert成功時に登録件数と更新件数がアラートで表示されます。

レコード一括登録前の画面
Sansan_plugin_image4.png

Upsert成功時の画面

Sansan_plugin_image5.png

 

サンプルプラグイン

GitHubにアクセスしてフォルダごとダウンロードしてください。そのフォルダ内の「examples/sansan」に、今回のファイル群があります。
「sansan」 配下のファイル構成及び使用ライブラリは次のとおりです。

sansan/ 
       css/
        -51-modern-default.css
        -config.css
-desktop.css
html/
-config.html image/ -icon.png js/ -common.js
-config.js
-desktop_lookup.js
-desktop_postRecords.js
-kintoneUtility.min.js
manifest.json

Cybozu CDNより以下のライブラリを使用しています。

  • jQuery
  • jQuery UI
  • Moment.js
  • SweetAlert
  • Spin.js
  • JSRender
  • Font Awesome

こちらの手順を参考にパッケージングします。

パッケージングしたサンプル

プラグイン開発のためのサンプルであり、サポート対象外であることをご理解の上、ダウンロードしてください。

SAMPLE_sansan_plugin_v3.0.2.zip

更新履歴

2016/02/15 v1.0 を公開しました
2016/02/22 v1.0.1 を公開しました: 名刺交換日がなしのデータが最新のデータと扱われる不具合を修正しました。
2016/07/19 v2.0 を公開しました:
以下の機能追加及び修正を行いました。

  • レコード一覧画面で Sansan データの参照が可能になりました。
  • レコード一覧画面でタグ検索機能が追加されました。
  • レコード一覧画面で複数の名刺データの取り込み機能が追加されました。
  • ルックアップ機能とレコード一括登録機能のON/OFF機能が追加されました。
  • 「人物ID」と「URL」のコピー先フィールドとして指定できるようになりました。
  • その他軽微な修正を行いました。

2016/08/18 v2.0.1 を公開しました:
以下の機能追加及び修正を行いました。

  • レコード一覧画面で Sansan に検索する項目をドロップダウンで選択する機能が追加されました。
  • タグ検索でスピナーが表示されない不具合を修正しました。
  • その他軽微な修正を行いました。

2016/09/16 v2.0.2 を公開しました:
以下の機能追加及び修正を行いました。

  • 「名刺交換日」、「郵便番号」、「Fax」をコピー先フィールドとして指定できるようになりました。
  • その他軽微な修正を行いました。

2017/03/13 v3.0.0 を公開しました:
以下の機能追加及び修正を行いました。

  • 人物IDをキーとしたレコード一括登録時のUpsert機能[レコード一覧画面]が追加されました。
  • 「名刺ID」、「会社ID」、「名刺登録日時」、「名刺所有者のユーザID」、「氏名カナ(姓カナ+名カナ)」、「電話番号2」、「メモ」をコピー先フィールドとして指定できるようになりました。
  • レコード一覧画面で「期間指定」による検索ができるようになりました。
  • ダイアログに全件チェック用のチェックボックスを追加しました。
  • 「期間指定」検索ダイアログで「名刺更新日付」が選択できるようになりました。
  • その他Sansan APIのアップデートに伴い軽微な修正を行いました。

2017/07/21 v3.0.1 を公開しました:
以下の機能追加及び修正を行いました。

  • cssの名前を「51-current-default.css」⇒「51-modern-default.css」に修正。
  • プラグインにhomepageを追加。
  • その他軽微な修正。

2017/10/04 v3.0.2 を公開しました:

  • プログラムで使用しているフォーム設計情報取得APIを、フィールドの一覧を取得するAPIに置き換えました。

制限事項

  • Internet Explorer 8では本プラグインはご利用いただけません。
  • スマートフォンでは、使用することができません。
  • Sansan からのデータ取得は5000件が上限となります。
  • 検索結果が重複した場合、Emailが重複したデータのみ重複が削除されます。重複削除対象は名刺交換日が古いものとなります。
  • Sansan APIの仕様により、リクエスト数が100回/5分を超えるとエラーとなります。エラーが表示された場合、5分以上時間を置いてから再度取得を行ってください。
  • Sansan APIの仕様により、Sansan への検索仕様は以下となります。
    • 会社名:部分一致
    • 氏名:前方一致
    • メールアドレス:完全一致
    • 電話番号:部分一致
    • 携帯番号:部分一致
  • Sansanから取得可能な名刺設定は下記の名刺となります。
    名刺のステータス:データ入力が完了した名刺(completed)
    名刺の公開設定:[公開]状態の名刺
  • 会社名、氏名、メールアドレス全てが空文字の名刺は取得できません。
  • 取得した名刺のメールアドレスが重複した場合及びUpsert機能利用時に人物IDが重複した場合は、名刺交換日が最新の名刺のみ検索結果に表示されます。
  • レコード一括登録及び一括登録時のUpsert機能により一度に登録、更新できる件数は1000件までとなります。
  • タグ検索で使用できるタグは「共有タグ」のみとなります。
  • 選択したタグの名刺情報がない場合はエラーが表示されます。

記事に関するフィードバック

直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。

Avatar
Shotaro Matsuda

便利に使っています!

レコード一括登録時の検索で、名刺交換日の期間指定があったら、すごく便利です。

複数の会社との打合せや、イベント参加等、最近もらった名刺一覧から取り込みたい名刺を選択できるようになると、非常に効率アップとなります。

あと、名刺選択時に「部署名」が表示されるとありがたいです。

Shotaro Matsudaにより編集されました
Avatar
cybozu Development team

Shotaro Matsuda 様
コメントいただきありがとうございました。developer network事務局です。

①>レコード一括登録時の検索で、名刺交換日の期間指定があったら、すごく便利です。
②>名刺選択時に「部署名」が表示される

本プラグインはサンプルプラグインとなっており、ご自由にカスタマイズにより拡張することができます。
①、②のご要望につきましてはSansanプラグイン内の下記ファイルを修正することで対応いただけるかと思います。
https://github.com/kintone/plugin-sdk/blob/master/examples/sansan/js/desktop.js

①に関しましては317行目~401行目の期間指定処理を参考いただければと思います。
②に関しましてはcreateLookupListView()関数に部署名項目を追加いただくことで対応いただけます。

以上、ご確認をお願いいたします。

Avatar
kyoden

こちらのプラグインを現在試しているのですが、レコードの編集画面で登録しようとすると

現状一人分の名刺情報しか入力できないですが

ひとつのレコードに複数名の名刺情報を登録することはできないでしょうか?

Avatar
cybozu Development team

kyoden様

コメントいただきありがとうございます。developer network事務局です。

こちらのプラグインは、1レコードで1顧客を登録するというシナリオでの利用となります。
そのため、1レコードに複数名の登録は行うことができません。

ご希望に添えず申し訳ございません。
今後共よろしくお願い致します。

Avatar
kyoden

developer network事務局様

 

現状の機能ではできないということは分かりました。

1レコードで複数名を登録するためには

自分でjavascriptでコーディングするしか手はないでしょうか?

Avatar
cybozu Development team

kyoden様

ご確認いただきありがとうございます。

こちらのプラグインにつきましては、アップデートの予定が現時点はございませんので、お客様のほうで実装していただくか、
サイボウズのHPにパートナー企業様の一覧がございますので、開発を行っているパートナー様へ依頼をしていただくという
選択肢となります。

お役に立てず申し訳ございません。
よろしくお願い致します。

Avatar
taguchiyukako

素人質問で申訳ないのですが・・・

氏名を「氏」と「名」に分けたい 

住所を「県まで」、「区まで」、「番地」、「建物名」

と分けてkintoneに取り込みたいのですが可能でしょうか?

sansan側の契約では分解できるようになってるとのことでプラグインの設定の問題とのことでした。

カスタマイズする方法などあればご教授おねがいします

 

 

Avatar
cybozu Development team

taguchiyukako 様

コメントいただきありがとうございます。
developer network事務局です。

kintone側も、項目を分けていただき、その項目にデータを入れるという処理をしていただければ、可能、不可能でいうと、「可能」です。
ただし、このプラグインは、そのような仕様になっていないため、現状はできません。

ソースコードがGithubにあがっているので、こちらをご自由にカスタマイズいただくことにより拡張することができます。
https://github.com/kintone/plugin-sdk/blob/master/examples/sansan/js/desktop_lookup.js

そのため、お客様のほうで実装していただくか、開発依頼していただくことで対応可能になります。

お役に立てず申し訳ございません。
よろしくお願い致します。

Avatar
kyoden

こちらのプラグインを色々なアプリで利用しているのですが、

検索ボタンを配置するスペース:

においてスペースを配置できないアプリが時折あります。

ほかのプラグインやJavascriptが邪魔しているのかと考え、全て解除しており、

スペースについてもフィールドコードはちゃんと記載しております。

 

スペースを配置できない原因として何が考えられるでしょうか?

Avatar
cybozu Development team

kyoden 様

 

お世話になっております。developer network事務局です。

スペースフィールドが配置できないというのは、

プラグインの設定画面の「検索ボタンを配置するスペース」の項目にて、

フォームの設定で配置したスペースフィールドが選択できない、ということでしょうか。

それとも、プラグインの設定はできるが、

レコード追加画面にて配置したスペースフィールドにボタンが表示されないということでしょうか。

 

お手数をおかけして申し訳ありません。

上記のご確認、よろしくお願いいたします。

Avatar
kyoden

developer network事務局御中

平素よりお世話になっております。

 

>スペースフィールドが配置できないというのは、

>プラグインの設定画面の「検索ボタンを配置するスペース」の項目にて、

>フォームの設定で配置したスペースフィールドが選択できない、ということでしょうか。

 

はい、こちらの問題です。

今までに2つのアプリでこの問題に直面したので、

どのようなケースの場合上記の問題が発生するかを教えていいただけますと幸いです。

 

よろしくお願いいたします。

Avatar
cybozu Development team

kyoden 様

ご確認いただきありがとうございます。

こちらの手元で確認したところ、きちんとスペースフィールドがプラグインの設定で確認できました。

今一度、それぞれのスペースフィールドに要素IDが付与されているかご確認いただけますでしょうか。

なお、スペースフィールドに要素IDが付与されていない場合、プラグインの設定では選択できないことは確認できました。

 

よろしくお願いいたします。

Avatar
kyoden

developer network事務局御中

平素よりお世話になっております。

 

問題なく動作しているアプリと同じように、

要素IDに「sansan」と設定をしておりましたが、

プラグインの設定で選択できないアプリがございました。

 

そのアプリを再利用してもその場合はsansanはプラグインの設定で選択できませんでした。

Avatar
cybozu Development team

kyoden様

何度もご確認いただき、ありがとうございました。

2つのアプリで現象が発生しているということですので、なんらかの再現条件がありそうですが、弊社環境でご報告いただいた現象を再現できておらず、どういう場合に発生するかどうか確認する手立てがない状況です。

類似の現象であっても、要素IDの有無以外で発生するという報告がなく、現時点において原因は不明となります。

この度はお手数をおかけしたにもかかわらず、回答することができず申し訳ございません。

もし他に再現できるヒントになりそうなことにお心当たりがありましたら、再度ご連絡いただけますと幸いです。

今後ともどうぞよろしくお願い申し上げます。

Avatar
吉田

developer network事務局様

お世話になります。吉田と申します。

本プラグインの設定を手順通りに行ってみたのですが、レコード追加画面にて配置したスペースフィールドにボタンが表示されません。

ブラウザの設定等の問題なのでしょうか。

対処法を教えていただけないでしょうか。

 

Avatar
cybozu Development team

吉田 様

お世話になっております。cybozu developer network事務局でございます。

IE11,最新版のchromeで確認したところ、正常にボタンが表示されることを確認しました。

https://developer.cybozu.io/hc/ja/articles/207420183#step4
上記のステップの「使用機能」「ルックアップ機能[レコード追加/編集画面]」にチェックはついていますでしょうか。
また、「検索ボタン配置するスペース」は設定していますでしょうか。

宜しくお願い致します。

Avatar
吉田

developer network事務局様

お世話になっております。吉田です。

チェック、およびスペースも設定済みです。

他に何かありますでしょうか。

Avatar
吉田

たびたびすみません。吉田です。

上の件、アプリ内に記載したJavaScriptでこけていることが原因でした。

お手数おかけし、申し訳ありませんでした。

Avatar
稲葉 康弘

いつも便利に使わせていただいており、ありがとうございます。

sansanより、下記連絡がありましたが、

4/30以降も、こちらのサンプルプラグイン(v3.02)は利用可能でしょうか?

また、バージョンアップのご予定、ありますでしょうか?

よろしくお願いいたします。

_______

Sansanサポートセンターでございます。

※ 本メールは、Sansan システム管理者の方にご案内しています。

 2019年4月30日をもちまして、Open API v1.3 を終了させていただきます。

v1.3 をご利用の場合は、より機能を拡張した v2.0 への切り替えをお願いいたします。

v2.0 の変更内容や、仕様につきましては、以下のサイトをご確認ください。

 

------------------------------

≫ Open API ドキュメント

   https://docs.ap.sansan.com/ja/api/openapi/index.html

 

≫ 変更履歴とバージョン情報

   https://docs.ap.sansan.com/ja/api/openapi/changelog/index.html

------------------------------

 

対象のお客様にはお手数をおかけいたしますが、

何卒ご理解いただきますようお願いいたします。

Avatar
cybozu Development team

稲葉 康弘 様

 

いつもお世話になっております。developer network事務局です。

ご連絡いただきありがとうございます。

APIの方法が変化するため、こちらのプラグインは動作不良を起こす可能性があります。

 

今後の改修/バージョンアップについては、追ってご連絡させていただきたく思います。

よろしくお願いいたします。

Avatar
稲葉 康弘

ご返信ありがとうございます。よろしくお願いいたします。

Avatar
稲葉 康弘

developer network事務局御中

 

お世話になっております。

こちら、Open API v2.0版のリリース目処はいかがでしょうか?

よろしくお願いいたします。

Avatar
cybozu Development team

稲葉 康弘 様

お世話になっております。cybozu developer network 事務局です。

developer network内に掲載しているサンプルプラグインに関しましては、その動作を保証するものではありません。
そのため、申し訳ございませんが、Open API v2.0版へのバージョンアップ対応はしない見込みです。

バージョンアップによるプラグインの影響は、社内で調査し追記する予定です。

お役に立てず申し訳ございませんが、よろしくお願いいたします。

Avatar
稲葉 康弘

そうなんですか・・、

もう少し早く知りたかったです。。

Avatar
cybozu Development team

稲葉様

対応が遅くなり、申し訳ありませんでした。現状を確認し、記事の冒頭に、利用しているAPIのバージョンを追記いたしました。

なお、正確には、ver1.xの終了は2019年9月30日であり、それまでは既存のプラグインも動作する見込みです。

日付についてSansanからの連絡に更新があった可能性があるため、メール等を再度ご確認いただければと存じます。

(当方でSansanサポートに確認したところ、Webサイト上の表記は誤記とのことです。)

どうぞよろしくお願いいたします。

Avatar
稲葉 康弘

ご確認、ありがとうございました。

Avatar
miho_s

developer network事務局御中

いつもお世話になっております。

 

名刺の一括登録時にタグから選択できる機能が大変便利なのですが、

このタグ情報も一緒に登録することは不可能でしょうか。

 

(コピー先フィールド一覧に記載がなかったので出来ないという認識でおりますが、ダメ元で質問させていただきました)

 

 

 

Avatar
cybozu Development team

miho_s 様

いつもお世話になっております。cybozu developer network事務局です。

こちらのプラグインでは、Sansanから取得しkintoneへ登録する情報にタグ情報を含めておりません。

プラグインのソースは公開しておりますので、改修いただくことで機能拡張が可能です。
https://github.com/kintone/plugin-examples/tree/master/examples/sansan

ご期待に添えず申し訳ございません。
今後ともよろしくお願いいたします。

Avatar
徳岡 秀紀

developer network事務局御中

いつもお世話になります。

制限事項 について教えていただければと思います。

データ取得が5000件まで とありますが、延べ累計5000件の名刺情報をルックアップすると、機能が止まるということでしょうか?

 

制限事項

  • Internet Explorer 8では本プラグインはご利用いただけません。
  • スマートフォンでは、使用することができません。
  • Sansan からのデータ取得は5000件が上限となります。
Avatar
cybozu Development team

徳岡様

お世話になっております。
cybozu developer network 運営局です。

データ取得上限5000件という制限事項ですが、
Sansan の顧客情報が5000件を超える場合に検索条件を指定せずに取得すると、件数が多いので絞り込みを行ってほしい旨のアラートが表示されます。

そのため、Sansan の顧客情報が 5000件を超える場合は、検索条件での絞り込みが必要となります。

  • ルックアップ機能[レコード追加/編集画面]の場合:「期間」または設定画面で設定する検索キーフィールドで絞り込む
  • レコード一括登録画面[レコード一覧画面]:ヘッダー部分の検索機能で絞り込む

以上、よろしくお願いいたします。

ログインしてコメントを残してください。