Sansanの名刺情報を取り出してみよう！

最終公開日 : Dec 05, 2022 |

Yoshiki Nakajima

皆さんの会社では、お客様や取引先の名刺情報をどのように管理されていますか？
弊社では頂いた名刺情報をSansanで共有・一元管理をしています。このSansanの名刺情報を、CRMやSFA、マーケティングオートメーション(MA)で活用されている方も多いのではないでしょうか。

本ブログでは、Intelligent Data Management CloudのマッピングでSansan API(*)をコールし、期間指定で名刺情報を取り出してみたいと思います。

(*) 以下のサイトを参考に、Sansan APIの認証KEYを発行してください。

Swaggerファイルの作成

メニューの [設定] – [Swagger Files] を選択します。
次の項目を入力し、Swaggerファイルを作成します。記載のない項目は、ご利用の環境に応じて設定してください。なお、名刺登録日時”YYYY-MM-DDThh:mm:ssTZD”形式で指定します。

URL:	https://api.sansan.com/
動詞:	GET
APIの基本パス:	/v1.2/
APIのパス:	bizCards
承認:	application/json
ヘッダ:	{ “X-Sansan-Api-Key” : “<<API認証KEY>>“}
操作ID:	registered
コンテンツタイプ:	application/json
生データ本文:	{ “registeredFrom”: “<<名刺登録日時(開始)>>“, “registeredTo”: “<<名刺登録日時(終了)>>“}

Swaggerファイルを元にREST接続を作成します。

メニューの [設定] – [接続] を選択します。
次の項目を入力し、接続を作成します。記載のない項目はご利用の環境に応じて設定してください。

タイプ: REST V2 (Informatica Cloud)
認証: RESTv2
Swagger File Path: 配置したSwaggerファイルのパス

Sansan APIを、トランスフォーメーションとしてコールするためのビジネスサービスを作成します。
(ソースやターゲットとしてAPIをコールする場合は作成の必要はありません)

メニューの [設定] – [ビジネスサービス] を選択します。
次の項目を入力し、ビジネスサービスを作成します。記載のない項目はご利用の環境に応じて設定してください。

Swagger File Path: 作成したREST接続
[操作の選択] ボタンをクリックします。
[選択…] ボタンをクリックし、ソース操作を選択します。

ソース操作: registered

本ブログでは、API認証KEYを記述したCSVファイルをソースとしています。

CSVサンプル:
API-key
“<<API認証KEY>>“

ソースにCSVファイルを指定します。
ソースから式トランスフォーメーションに接続し、期間指定を行うための新しいフィールドを2つ作成します。$LastRunTimeは前回実行日時、Systemtimestamp()は現在日時を表す定数・関数です。

フィールド名および式:	registeredFrom TO_CHAR( $LastRunTime, ‘YYYY-MM-DD”T”HH:MI:SS”+09:00″‘ )
フィールド名および式:	registeredTo TO_CHAR( Systimestamp(), ‘YYYY-MM-DD”T”HH:MI:SS”+09:00″‘ )