Google コンタクトアダプターの紹介

Google コンタクトアダプターについてご紹介させていただきます。
Google コンタクトアダプターで使えるコンポーネントは下記の通りです。
 
CDataGoogleContactsGet.png GoogleContactsへSELECT文を発行して結果セットをストリームとして出力します。
CDataGoogleContactsPut.png GoogleContactsのテーブルに対して更新を行います。
CDataGoogleContactsSQLCall.png 任意のSQLの実行を行います。
 
今回は、Google コンタクトアダプターを使うための事前準備とコネクション作成方法について紹介したいと思います。
 
■事前準備
 
【Google Developer Console】
Google コンタクトへ接続するためにはOAuth認証情報が必要となります。
下記の手順でOAuth認証情報を取得することができます。
 
  1. Google Developer Consoleにログインします。
  2. [プロジェクトの作成]をクリック、または既存のプロジェクトを選択します。
  3. API Managerで、[認証情報]→[認証情報を作成]→[OAuth クライアントID]をクリックします。
  4. アプリケーションの種類は、[その他]を選択します。
  5. [作成]をクリックします。クライアントIDとクライアントシークレットが表示されます。
  6. [ライブラリ]→[Google Contacts API]→[有効にする]をクリックします。
    GoogleDeveloperConsole.png
 
【ASTERIA WARPサーバー】
 
Google コンタクトアダプターを利用するためには事前にインストールしておく必要があります。
アダプターは[FSMC]→[システム]→[アップデート]画面にてダウンロードするか、ユーザーサイトからダウンロードしたアダプターをサーバーにアップロードすることで適用することができます。
GoogleContacts_01.png
 
アダプターのインストールについて詳しくは下記弊社のオンラインヘルプをご参考ください。
※アダプターのインストール後設定を有効にするためにはフローサービス全体の再起動が必要となります。
 
 
【フローデザイナー】
 
ASTERIA WARPサーバー側でGoogle コンタクトアダプターが正常にインストールされたら、フローデザイナー側でコンポーネントを取得する必要があります。
手順は下記になります。
  1. フローデザイナーからフローサービスへ接続
  2. メニューの「ツール > コンポーネント/マッパー関数の取得」でjarファイルを取得
  3. フローデザイナーを再起動
    GoogleContacts_02.png
    ※今回ダウンロードするファイルはfccdatagooglecontacts-1712.0431.jarとなります。

 

■コネクションの作成
 
事前準備が終わりましたら、コネクションを作成します。
 
FSMCでコネクションを作成する手順は下記になります。
 
FSMC画面の[設定]→[コネクション]→[GoogleContacts]メニューから「新規」ボタンをクリックします。
コネクション作成画面が表示されますので、下記の通り項目を設定します。
 
  • 基本設定
    GoogleContacts_03.png
    • 接続名:コネクション名を設定します。
    • イニシエートOAuth:GETANDREFRESHを選択します。
      現在トークンが存在しない場合にはブラウザを通じてユーザーをプロンプトすることで取得されます。トークンが存在する場合には必要に応じてリフレッシュされます。
    • OAuthクライアントID:Google Developer Consoleの事前準備で作成したクライアントIDを設定します。
    • OAuthクライアントシークレット:Google Developer Consoleの事前準備で作成したクライアントシークレットの値を設定します。
※デザイナーからもコネクションの設定が可能です。
 
■コネクションの接続テスト
 
Google コンタクトアダプターのコネクションが作成されたので、コネクションの接続テストを実行してみます。
今回はOAuthトークン情報を自動で取得更新するために、「イニシエートOAuth」に「GETANDREFRESH」を設定しました。この時、最初にOAuthトークンを取得するにはWARPサーバー側でブラウザが起動され、ログイン画面が表示されます。
ログインに成功するとアプリで必要なアクセス許可をリクエストする画面が表示されますので、許可をクリックします。
GoogleContacts_04.png
許可をクリックすると認証に成功し、OAuthトークンが取得されます。
GoogleContacts_05.png
また、以下のようにコネクション接続テスト成功画面も確認できます。
GoogleContacts_06.png
 
■最後に
 
Google コンタクトアダプターの利用するために必要な事前準備、およびコネクションの作成方法についてご紹介いたしました。
コネクションの作成後接続テストが正常に行われるとGoogleContactsGetコンポーネント、GoogleContactsPutコンポーネント、GoogleContactsSQLCallコンポーネントが使えます。
 
各コンポーネントの使い方については既存のRDB系のコンポーネントと同様です。
つまり、RDBGetコンポーネントの付属ツールである「SQLビルダー」、RDBPutコンポーネントの付属ツールである「テーブルの選択」ツールについても同様に使えます。
 
  • GoogleContactsGetコンポーネントのSQLビルダー
    GoogleContacts_07.png

 

  • GoogleContactsPutコンポーネントのテーブルの選択
    GoogleContacts_08.png

 

なお、Google コンタクトアダプターで使えるSQL文、またはデータ・モデルについては下記のCData社のオンラインヘルプもあわせてご確認頂ければと思います。
 
 
今回の紹介はここまでです。
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています

他のキーワードで検索する