Microsoft Office 365アダプターの紹介

ASTERIA WARP 1712のリリースに伴い、Microsoft Office 365アダプターが新たにリリースされました。
Microsoft Office 365アダプターで使えるコンポーネントは下記の通りです。
 
CDataOffice365Get.png Office365へSELECT文を発行して結果セットをストリームとして出力します。
CDataOffice365Put.png Office365のテーブルに対して更新を行います。
CDataOffice365SQLCall.png 意のSQLの実行を行います。

今回は、Microsoft Office 365を使うための事前準備とコネクション作成方法についてご紹介させていただきます。

■事前準備

 
Microsoft Office 365への接続は、Azure ADのOAuth認証で行います。
Azure ADのOAuth認証にはアプリケーションを登録する必要があり、Microsoft Office 365 for businessアカウントと、それに関連したAzure AD subscriptionの両方が必要になります。
 
【Azure AD】
  • アプリケーションの作成
下記の手順でアプリケーションを登録することができます。
 
  1. Azure ポータルで[Azure Active Directory]をクリックします。
  2. [概要]ブレードで[アプリの登録]をクリックし、次に[新しいアプリケーションの登録]をクリックします。
  3. ダイアログが表示されたら、ユーザーがアプリケーションへの許可を求められる際に表示されるアプリケーション名を入力します。
  4. [アプリケーションの種類]メニューで[Web アプリ/API]オプションを選択します。
    (Microsoft Office 365アダプターはMicrosoft Graph APIを呼び出します。)
  5. サインオン URLを選択します。この値は本製品 や認証ステップで使用されることはないので、ホームページやhttp://localhost などの任意のURL に設定できます。
  6. [作成]をクリックします。

Azure_1-03.png

 
  • アプリの設定
OAuth クライアントクレデンシャルを取得してアプリが要求する権限を設定する方法は次のとおりです。
  1. 新しいアプリを選択します。ブレードにアプリケション IDが表示されます。
    OAuthクライアントIDプロパティをこれに設定する必要があります。
    Azure_2-01.png

  2. [設定]ブレードで[キー]を選択します。キーの説明を入力しメニューで期限を選択したら[保存]をクリックします。
    これで、キーの値が表示されます。キーの値(OAuthクライアントシークレットの値)をコピーおよび保存します。
    Azure_2-02.png
  3. [設定]ブレードで[応答 URL]を選択します。応答 URLをユーザーがアプリケーションを認証した後にユーザーを返すアプリのページに設定してください。
    Azure_2-03.png
  4. [設定]ブレードの[必要なアクセス許可]を選択し、次に表示されるブレードで[追加]をクリックします。
    [Microsoft Graph API]を選択してアプリが求めるアクセス許可を選択します。
    次の委任されたアクセス許可により、Microsoft Office 365アダプターの全機能にアクセスできます。
  • ユーザーがアクセス可能なすべてのファイルへの完全アクセス。
  • ユーザーの連絡先への完全アクセス。
  • ユーザーのカレンダーへの完全アクセス。
  • ユーザーとしてメールを送信。
  • ユーザーメールに読み書きアクセス。
  • サインインユーザーとして直接アクセス。
  • すべてのグループを読み書き。
    Azure_3-01.png
 
【ASTERIA WARPサーバー】
 
Microsoft Office 365アダプターを利用するためには事前にインストールしておく必要があります。
アダプターは[FSMC]→[システム]→[アップデート]画面にてダウンロードするか、ユーザーサイトからダウンロードしたアダプターをサーバーにアップロードすることで適用することができます。
FSMC_01.png
アダプターのインストールについて詳しくは下記弊社のオンラインヘルプをご参考ください。

 

 ※アダプターのインストール後設定を有効にするためにはフローサービス全体の再起動が必要となります。
 
【フローデザイナー】
 
ASTERIA WARPサーバー側でMicrosoft Office 365アダプターが正常にインストールされたら、フローデザイナー側でコンポーネントを取得する必要があります。
手順は下記になります。
  1. フローデザイナーフローサービスに接続
  2. メニューの「ツール > コンポーネント/マッパー関数の取得」でjarファイルを取得
  3. フローデザイナーを再起動
    Designer_01.png
    ※今回ダウンロードするファイルはfccdataoffice365-1712.0431.jarとなります。
 
 
■コネクションの作成
 
事前準備が終わりましたら、コネクションを作成します。
 
FSMCでコネクションを作成する手順は下記になります。
 
FSMC画面の[設定]→[コネクション]→[Office365]メニューから「新規」ボタンをクリックします。
コネクション作成画面が表示されますので、下記の通り項目を設定します。
 
  • 基本設定
    FSMC_CON_01.png
    • 接続名:コネクション名を設定します。
    • イニシエートOAuth:GETANDREFRESHを選択します。
      現在トークンが存在しない場合にはブラウザを通じてユーザーをプロンプトすることで取得されます。トークンが存在する場合には必要に応じてリフレッシュされます。
    • OAuthクライアントID:Azure ADの事前準備で作成したアプリケーションのIDを設定します。
    • OAuthクライアントシークレット:Azure ADの事前準備で作成したアプリケーションキーの値を設定します。
    • OAuth Callback URL:Azure ADの事前準備で作成したアプリケーションの応答URLの値を設定します。
※デザイナーからもコネクションの設定が可能です。
 
 
■コネクションの接続テスト
 
Microsoft Office 365アダプターのコネクションが作成されたので、コネクションの接続テストを実行してみます。
今回はOAuthトークン情報を自動で取得更新するために、「イニシエートOAuth」に「GETANDREFRESH」を設定しました。この時、最初にOAuthトークンを取得するにはWARPサーバー側でブラウザが起動され、ログイン画面が表示されます。
ログインに成功するとアプリで必要なアクセス許可をリクエストする画面が表示されますので、承諾をクリックします。
FSMC_CON_02.png
承諾をクリックすると認証に成功し、OAuthトークンが取得されます。
 
FSMC_CON_03.png
 
また、以下のようにコネクション接続テスト成功画面も確認できます。
FSMC_CON_04.png
 
 
■最後に
 
Microsoft Office 365アダプターの利用するために必要な事前準備、およびコネクションの作成方法についてご紹介いたしました。
コネクションの作成後接続テストが正常に行われるとOffice365Getコンポーネント、Office365Putコンポーネント、Office365SQLCallコンポーネントが使えます。
 
各コンポーネントの使い方については既存のRDB系のコンポーネントと同様です。
つまり、RDBGetコンポーネントの付属ツールである「SQLビルダー」、RDBPutコンポーネントの付属ツールである「テーブルの選択」ツールについても同様に使えます。
 
  • Office365GetコンポーネントのSQLビルダー
    SQL____.png
 
  • Office365Putコンポーネントのテーブルの選択
    ______.png
 
なお、Microsoft Office 365アダプターで使えるSQL文、またはデータ・モデルについては下記のCData社のオンラインヘルプもあわせてご確認頂ければと思います。

 

今回の紹介はここまでです。

 

 
 
 
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています
    キーワード:
  • "Office 365"
  • CData
  • CDataオプション紹介
他にご質問がございましたら、リクエストを送信してください

このセクションの記事

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