マイクロアプリ

Power BIの統合

Power BIと統合して、Citrix Workspaceで重要なレポートの変更に関する自動通知を受信します。

以下のプロセスを使用して、Power BI統合を有効にします。前提条件を満たしていることを確認し、接続の詳細を提示します。このプロセスを完了すると、Citrixマイクロアプリの使用によって実行されたすべてのアクションを含む、既存のレベルの監査ログが保持されます。

追加設定不要のPower BIマイクロアプリの一覧については、「Power BIマイクロアプリの使用」を参照してください。

必須条件の確認

Power BIサービスアカウントが必要です。詳しくは、https://powerbi.microsoft.com/en-us/landing/signin/を参照してください。Citrix Microappsでレポートを共有するには、レポートをPower BIサービスアカウントと共有する必要があります。

環境によっては、2つのアカウントが必要になる可能性があります:

  • Azure ADでアプリ登録を作成する権限を持つアカウント。このアカウントは、最初にどのサブスクリプション/テナントに関連付けられるかによっては問題になる可能性があります。
  • 統合の認証に使用されるサービスアカウント。

これらの前提条件は、組織のPower BIインスタンスを管理して統合をセットアップすることを想定しています。サービスアカウントには、次のAPI権限がType: Delegatedで割り当てられている必要があります:

グループ API/権限名 種類 説明
Azure Active Directory Graph (1) User.Read Delegated サインインとユーザープロファイルの読み取り。
Power BI Service (18) App.Read.All Delegated すべてのPower BIアプリを表示します。
  Capacity.Read.All Delegated すべての容量を表示します。
  Dashboard.Read.All Delegated すべてのダッシュボードを表示します。
  Dataflow.Read.All Delegated すべてのデータフローを表示します。
  Dataset.Read.All Delegated すべてのデータセットを表示します。
  Gateway.Read.All Delegated すべてのゲートウェイを表示します。
  Report.Read.All Delegated すべてのレポートを表示します。
  StorageAccount.Read.All Delegated すべてのストレージアカウントを表示します。
  Workspace.Read.All Delegated すべてのワークスペースを表示します。

Power BIでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • クライアントID
  • クライアントシークレット
  • OAuth認証

アプリケーションの登録

https://dev.powerbi.com/appsに移動してアプリケーションをAzure ADに登録し、アプリケーションがPower BI REST APIにアクセスできるようにして、アプリケーションのリソース権限を設定します。この登録プロセスで、クライアントIDとクライアントシークレットを作成します。

一覧の最初のコールバックは変更されません。2番目のコールバックはターゲットアプリケーションによって異なり、統合の作成時にURLアドレスバーに表示されます。セクション{yourmicroappserverurl}は、テナント部分、リージョン部分、環境部分で構成されています:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com

最初のフィールドに登録できるURLは1つだけです。サーバー側のWebアプリケーション登録ページにURLを1つ入力します。次に、Azure AD App Registrationに移動して、2番目のURLを追加します。

  1. アプリケーションの名前を入力します。
  2. サーバー側のWebアプリケーションを選択します。
  3. アプリケーションのホームページURLを入力します。
  4. 次のいずれかのリダイレクトURLを入力します: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.powerbi.PowerBiService/auth/serverContext

    注:

    このフィールドでは2つのURLを使用できません。Azure AD App Registrationに移動して、2番目のURLを追加します。

  5. すべての読み取り専用APIチェックボックスをオンにします。
  6. [Register] を選択します。
  7. [Azure App Registrations]>[Authentication] に移動して2番目のコールバックURLを入力します。

    Azureでのコールバック

Citrix Workspaceマイクロアプリへの統合の追加

Power BI統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. 概要ページから、[はじめに]を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. Power BIタイルを選択します。
  4. 統合の名前を入力します。

    Power BIのコネクタのパラメーター、クライアントID、クライアントシークレット、テナント、OAuth認証

  5. 前の手順で収集したコネクタのパラメーターを入力します。
    • [クライアントID][クライアントシークレット] を入力します。
    • Office 365の [テナントID] を入力します。
  6. [Power BIアカウントでログインする] を選択して、OAuth認証を有効にします。Power BIのサインインページが新しいタブで開きます。アカウント名の入力、パスワードの入力、要求された許可の承認を求められます。

  7. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用のマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。

詳しくは、「統合の構成」で「必要なエンティティの確認」および「データ同期の設定」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Power BIコネクタの仕様」を参照してください。

Power BIマイクロアプリの使用

既存のWeb/SaaS統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

Power BI統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

ダッシュボード: Power BIダッシュボードの詳細を表示します。

通知またはページ ユースケースワークフロー
ダッシュボードページ 利用可能なダッシュボードと詳細ページへのリンクの一覧を提供します。
ダッシュボードの詳細ページ ダッシュボードで読み取り専用の詳細ビューと、より詳細なビューが表示できるレコードのターゲットソースへのリンクを提供します。

レポート: Power BIレポートの詳細を表示します。

通知またはページ ユースケースワークフロー
レポート新規追加通知 アカウントに新しいレポートが追加されると、利用者は通知を受け取ります。
レポートの詳細ページ レポートの読み取り専用の詳細ビューを提供します。
レポートページ 利用可能なリンク付きのレポート一覧を提供します。リンク先は詳細ページで、より詳細なビューが表示できるレコードのターゲットソースへのリンクが記載されています。

Power BIの統合