Sansanの人物詳細画面のURLをkintoneで自動生成する方法

Pocket

かなへいです(‘ω’)

以前、Sansanを弊社に導入したお話をブログに書きましたが、
今日は、Sansanの人物詳細画面のURLをkintoneで自動生成する方法を
どどーーーんと公開してしまいますー!!(/・ω・)/どどーん

kintone×Sansanの連携のところで悩んでおられる方必見です!!

 

 

Sansanの人物詳細画面へのURL生成方法

下準備

下準備として、案件管理アプリ(kintoneにSansanからデータをコピーしてくるアプリ)を作成します。
今回は、kintoneのアプリストアにある案件管理アプリを流用します!↓

既にある案件管理アプリに下記3つのフィールドを追加します。

  • SansanURL(フィールド種類:リンク フィールドコード:SansanURL)
  • スペース(フィールド種類:スペース フィールドコード:Syutoku)
  • 人物ID(フィールド種類:文字列一行 フィールドコード:SansanPersonId)

そして、Sansanforkintoneプラグインを適応し、下記のようにセットします。

■APIキー
自身のSansanで発行したAPIキーを入力
■使用する機能
今回はルックアップ機能のみチェック
■検索ボタン配置スペース
syutoku
■検索キーフィールド
先方担当者
■コピー元のSansanフィールド
氏名
■コピー先フィールド
会社名:会社名
氏名:先方担当者
部署名:部署名
E-mail:メールアドレス
Tel:TEL
Fax:FAX

これで下準備は完成です!!

URL生成のポイント

人物詳細画面のURLということで、実際にどの画面に遷移できるかというと
こちらです。

この画面、実は「この画面のURLをコピー」というボタンがあり、
そのボタンを押すとコピーされるURLを、
kintone側で自動生成してリンクにしちゃえば、
kintoneからSansanの詳細画面へいつでも遷移できるという仕組みになります。

サンプルコード

とっても簡単なサンプルコードです!
エンジニアではないかなへいでも作れましたよーー(‘ω’)

とりあえず、新規登録の際に、URLが自動生成され、
あらかじめ用意して置いたリンク項目に値がセットされるようにしました。

必要な人は、ここに”編集時”や”IDが変わったとき”など、
条件を加えて活用してみてください!

名寄せ時のIDに注意!

Sansan名寄せの仕様

こんなふうにkintoneと連携すれば、活用の幅も広がるSansanですが、
1つ落とし穴があります。

人物IDをプラグインを活用してkintoneに持ってきて、
その人物IDをもとにURLを生成するのですが、
その人物IDが変更されることがあります!!!(IDなのに(;ω;)ウゥゥ)

それが、名寄せ されるときに発生するのです。

Sansanの名寄せには2パターンあります。

  • 自動名寄せ
    Sansan内部で、会社名や氏名、メールアドレスなどを比較して、
    同一人物の場合は自動で名寄せされます。

  • 手動名寄せ
    例えば、転職などで所属している会社が変わった場合、前の職場の名刺と新しい名刺で、
    その2名が同一人物か同姓同名の別人なのかをユーザーが手動で判別できる機能です。

上記2パターンで名寄せが実行されるわけですが、
例えば、名寄せされる場合、どんなふうにIDが変わるのか、紙芝居にまとめました!!!

もともと神戸デジタル・ラボの武富さんと名刺交換をして、Sansanにデータとして登録していました。

そのあと、神戸デジタル・ラボを退社した武富さんは株式会社かなへいを立ち上げたので、
新しい名刺をもらいました。

Sansanにスキャンすると、株式会社かなへいの武富さん(人物ID:hijklmn)はいったんは別人として登録されます。

 

その後、神戸デジタル・ラボの武富さんと株式会社かなへいの武富さんは
同一人物として、手動名寄せを実行した場合

 

人物IDはなんと 最初に採番されていた人物ID:abcdefgとなります。

つまり、名寄せが完了する前に、kintoneでURLを自動生成してしまうと
再度取得をしてURLを更新しないと、そのURLは無効となり、
人物の詳細画面に飛べなくなるんですねー
ポィ(ノ∀` )ノ ⌒ 畄

なので、Sansan×kintoneをガチ連携しようと思えば、
やっぱりバッチを組む必要がありそうですが、
まあ、そこは運用してみてユーザーの声の多さによって要検討という感じですね。

なんか、オチが弱くてすみません^^;

Sansan×kintoneで気になることがあれば、出来る範囲で記事にしますので

コメントいただければ幸いですー

ぐっばい(`・ω・´)ゞ

Pocket

The following two tabs change content below.
武富佳菜
2014年に神戸デジタル・ラボに入社した若手メンバー。ニックネーム:かなへい。文系出身。社内1番のkintoneマスター!kintoneのイベントにちょこちょこ出没する、肉食系女子。非エンジニアで売り出し中の中まさかの印とねを持ったまま情シスへ移動。kintoneの推進を社内・外問わず担当中。好きな食べ物、オムライスとマカロンとチョコレート。趣味はハムスターの動画収集。