PoCガイド:概念実証ガイド-App Builderを使用して、Citrix Podioが支援するブロードキャストおよびFAQマイクロアプリテンプレートをCitrix Workspace にロールアウトする

概要

Citrix App Builder(Podioを搭載)は、Citrixが管理する記録システムを使用してマイクロアプリの構築を開始する簡単な方法を提供します。App Builderにより、Citrix Podioはマイクロアプリ用のバックエンドの記録システムを提供します。つまり、独自の記録システムを持ち込んだり構築したりする必要はありません。App Builderを使用すると、管理者と開発者は、独自のバックエンド記録システムをデプロイおよび管理することなく、マイクロアプリをより迅速かつ簡単にデプロイおよび構築できます。

スコープ

この概念実証ガイドでは、App Builderを使用して、Citrix Workspace を使用するユーザーにブロードキャストおよびFAQ(よくある質問)マイクロアプリを展開する方法について説明します。ただし、ここで説明する概念は、Citrix Podioを記録システムとして使用する他のCitrix提供のPodioアプリパッケージにも適用されます。

ゴール

この概念実証ガイドを修了すると、次の内容が完成します。

  1. App Builderを使用してPodioインスタンスを作成またはCitrix Cloud にリンクした
  2. ブロードキャストマイクロアプリとFAQマイクロアプリの記録システムとして機能するCitrix提供のPodioアプリを追加しました
  3. PODIOが支援する記録システムを使用するようにマイクロアプリ統合を追加および構成しました
  4. サブスクライバーをマイクロアプリに追加して、適切なユーザーがブロードキャストを投稿できるようにし、Workspaceを使用するすべての人にブロードキャストとFAQが表示されるようにしました
  5. Citrix Workspace でブロードキャストマイクロアプリとFAQマイクロアプリの基本機能をテストしました

前提条件

  • Citrix Workspace
  • Citrixマイクロアプリ

注:Podio インスタンスは必要ありません 。最初に App Builder を使用するときに作成できます。

概念と用語

このガイドで使用されている用語の中には、馴染みのないものもあります。

  • System of Record-データの読み取りと書き込みを行う場所です。データベースに似ています。マイクロアプリ統合では、これらを使用してマイクロアプリに関連付けられたデータを保存します。それらは「真実の源」と考えることができます
  • マイクロアプリ-Citrix Workspace エクスペリエンスに組み込まれたユーザーインターフェイス要素
  • Podio Workspace-Podio管理者がチームやプロジェクトを論理的に分離するのに役立つpodioの概念。Citrix Workspace と同じではない
  • Podioアプリ-Citrix Podioワークスペース内に存在するアプリ。このユースケースでは、これらのアプリは、Citrix Workspace マイクロアプリ統合のための既製のバックエンド記録システムを提供します。
  • インテグレーション-インテグレーションは記録システムに接続します。統合では、Citrix Workspaceを使用するユーザーに表示できるマイクロアプリも提供され、Citrix Workspaceのマイクロアプリに表示できるように記録システムからデータを読み取ります。

展開手順

アプリケーションビルダーを使用してPodioインスタンスを作成するか、Citrix Cloud にリンクする

このステップは、 App Builder の製品ドキュメントで最もよく説明されていますが、以下に要約されています。

  1. シトリックスの資格情報を使用してCitrix Cloud にサインインします
  2. Citrix Cloud コンソールの[利用可能なサービス]で、[アプリケーションビルダー]タイルで[セットアップ]を選択します。
  3. 組織が既にPodioアカウントを持っている場合は、Citrix Cloud アカウントに接続できます。あなたの組織がPodioアカウントを持っていない場合は、ここで無料で作成できます。

新しいpodioアカウントが作成またはリンクされたら、次のステップはCitrix提供のPodioアプリのサンプルをPodioインスタンスに追加することです。

Citrix提供のPodioアプリを追加して、ブロードキャストおよびFAQマイクロアプリの記録システムとして機能させる

このセクションでは、Citrix マイクロアプリ統合専用の新しいPodioワークスペースが作成されます。新しいワークスペース内に、Citrix が提供するPodioアプリが追加されます。

ブロードキャスト Podio アプリを追加する

[PodioアプリマーケットからCitrix Workspace ブロードキャストアプリを追加します](https://podio.com/market)

  1. PodioマーケットのCitrix Workspace ブロードキャストアプリに移動
  2. 「アプリを取得」をクリックします
  3. Citrix Workspace Broadcastアプリ用に「Citrixマイクロアプリ統合」と呼ばれる新しいスペースを作成します。これにより、Podioアプリとデータを、あなたが持っている、または将来必要になる他の非マイクロアプリPodioワークスペースから分離することができます。他のCitrix提供のPodioアプリが追加されると、それらもこのワークスペースに配置できます。
  4. アクセス設定を [非公開] に設定します。このワークスペースはデータベースのように使用されるため、プライベートにしておくことをお勧めします
  5. [今すぐアプリを試す] をクリックします

よくある質問 Podio アプリを追加する

次に、 [PodioアプリマーケットからCitrix Workspace FAQアプリを追加します](https://podio.com/market)

  1. PodioマーケットのCitrix Workspace FAQアプリに移動
  2. 「アプリを取得」をクリックします
  3. 前の手順「Citrix マイクロアプリ統合」で作成した「既存のPodio」ワークスペースを使用します。これは、ブロードキャストとFAQ Podioアプリの両方が同じPodioワークスペース内にあることを意味します。
  4. アクセス設定を [非公開] に設定します。このワークスペースはデータベースのように使用されるため、プライベートにすることをお勧めします。
  5. [今すぐアプリを試す] をクリックします

[注] これを後日本番用に設計する場合、Podio Workspacesは複数のPodioアプリをホストできることを繰り返す価値があります。つまり、Citrix マイクロアプリ専用の総称Podio Workspaceは、管理とメンテナンスを容易にするために、マイクロアプリ統合ごとに新しいPodio Workspaceを作成するよりも意味があります。この概念実証ガイドでは、本番環境ではないため、物事を区分化しています。

この時点で、Podioが支援するSystem of Recordと、各Podioアプリに関連するデータベーススキーマが整っています。

次に、後のステップでマイクロアプリ統合を構成するために必要なデータをPodioから収集します。

Podioからマイクロアプリ統合構成値を収集する

このセクションでは、次のデータが収集されます。

  • Citrix Workspace ブロードキャストのアプリID
  • Citrix Workspace ブロードキャストのトークン
  • Citrix Workspace ブロードキャストのIDを表示
  • Citrix Workspace のアプリIDに関するよくある質問
  • Citrix Workspace のトークン
  • Citrix Workspace の ID を表示よくある質問
  • クライアントID
  • クライアントシークレット

このデータは、Citrix Cloud に追加されたマイクロアプリのPodio統合を構成するために必要です。

各アプリのPodioアプリIDとトークンを収集する (ブロードキャストとFAQ)

アプリIDとトークンはPodioから取得されます。 完全なドキュメントはここにありますが、要約は以下に提供されています

  1. podio.comにログイン
  2. ナビゲーションバーから、前に追加したPodioアプリに関連付けられているワークスペースを選択します。この例では、Citrix マイクロアプリ統合
  3. これにより、ワークスペースに入ります。次に、アクティビティの横にあるラウドヘイラーアイコンをクリックして、Podioアプリ自体に移動します。
  4. ここから、スパナアイコンをクリックし、[アプリ] カテゴリの [開発者] を選択します。
  5. アプリIDとトークンが表示されます。これらを書き留めておきなさい。
  6. 次のPodioアプリに移動

ビューIDの収集

各アプリのビュー ID を収集します (ブロードキャストと FAQ の両方)。

この手順の主な参照ドキュメントはCitrix Docsにあります: ビューIDの収集

  1. Broadcastアプリの場合、フィールドはModified Todayです
  2. FAQアプリの場合、フィールドは Published FAQsです

クライアントIDとクライアントシークレットの収集

マイクロアプリのpodio統合がPodioバックエンドと通信するには、クライアントIDとクライアントシークレットを作成し、Podio統合構成に入力する必要があります。これはCitrix Cloud クライアントIDおよびシークレットと同じではなく、Podioから生成する必要があります。

完全なドキュメントはここにありますが、概要を以下に示します。

1.Log を API キーに追加します。API キージェネレータの下のフィールドに入力します。

  1. アプリケーション名に名前を入力します。この概念実証では、 Citrix Microapp Integrationsという名前を付けます。
  2. [Full domain (without protocol) of your return URL] にマイクロアプリのインスタンスURLを入力します。URL {yourmicroappserverurl} のこのセクションは、テナント部分、リージョン部分、および環境部分で構成されています: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com。例としては、mycloudworkspace.us.iws.cloud.com などがあります。
  3. [Generate API Key] を選択します。
  4. [Your API keys] で、追加したアプリケーションの [Client ID] および [Client Secret] の値をコピーして保管します。これらの値は、統合を設定するときに入力します。

すべてのデータが収集されたことを確認する

次の値が収集されていることを確認してください。これらは次のステップで必要になります。

  • Citrix Workspace ブロードキャストのアプリID
  • Citrix Workspace ブロードキャストのトークン
  • Citrix Workspace ブロードキャストのIDを表示
  • Citrix Workspace のアプリIDに関するよくある質問
  • Citrix Workspace のトークン
  • Citrix Workspace の ID を表示よくある質問
  • クライアントID
  • クライアントシークレット

次に、この新しい記録システムを使用するようにマイクロアプリサービスを構成します

Podioインテグレーションをマイクロアプリサービスに追加する

Citrix マイクロアプリのPodio統合テンプレートは、ブロードキャストとFAQの2つのユースケースを提供する事前構築済みの統合です。バックエンドのレコードシステムがPodioで作成され、マイクロアプリ統合とそのマイクロアプリテンプレートが追加されます。

  1. citrix.cloud.comから、Citrix Cloud のお客様にログインします
  2. [マイクロアプリ]タイルをクリックします
  3. 「インテグレーションを追加」をクリックして新しいインテグレーションを追加する
  4. これはCitrixが提供するソリューションであるため、「Citrix提供のテンプレートから新しい統合を追加する」を選択します
  5. Citrix Podio を選ぶ
  6. [追加] を選択します

この時点で、いくつかのテンプレートマイクロアプリを含むCitrix Podio統合がマイクロアプリサービスに追加されました。次に、以前に追加されたCitrix Podioアプリと通信するように統合を構成します。

Citrix Podioアプリと通信するようにインテグレーションを構成する

Citrix Podio統合を追加したら、構成する必要があります。統合を追加した後、[構成]ページが表示されますが、表示されない場合は:[マイクロアプリ]タイルに移動し、Citrix Podio統合を見つけて、[構成の更新]リンクをクリックします。

このステップの主なリファレンスドキュメントはCitrix Docsにあります: Podioの統合

注:インテグレーションを追加する場合、どのアプリ ID とトークンを指定してもかまいません。ブロードキャストアプリ ID とトークン、または FAQ ID とトークンのいずれかを指定できます。これはPodioのワークスペースの仕組みによるものです。ただし、後で、データの読み込みとサービスアクションを設定する場合、それらのアプリIDとビューIDは、対応するPodioアプリと一致する必要があります。

設定するときは、[設定] フォームの次のフィールドを変更する必要があります。

  1. PodioアプリID:各PodioワークスペースにはアプリIDがあります。統合を設定するときに、podio_app_id 変数を置き換えるときに、この値をアクセストークンパラメーターとして入力します。アプリIDは、Podioワークスペースの任意のPodioアプリから使用できます。
  2. アプリトークン:このトークンを使用して、ユーザーではなくアプリとして認証します。統合を設定するときに、podio_token_id 変数を置き換えるときに、この値をアクセストークンパラメーターとして入力します。
  3. クライアントID:クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。
  4. クライアントシークレット:クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

データロードとサービスアクションの設定

このセクションでは、BroadcastとFAQの各podioアプリのアプリIDとビューIDを取得し、このステップの完全なドキュメントに記載されている変数とフィールドを置き換えます。

ブロードキャストとFAQマイクロアプリの機能について学ぶ

ブロードキャストとFAQマイクロアプリの機能の概要は次のとおりです。 Podioマイクロアプリを使用する

Workspaceのマイクロアプリへのアクセス権を付与する

最後に、適切なユーザーがCitrix Workspace からアクセスできるように、 マイクロアプリサブスクライバーを構成します

概念的に:

  1. ブロードキャストを投稿する必要があるユーザーには、 Create Broadcastマイクロアプリへのアクセス権を(サブスクライブ済み)付与できます。
  2. BroadcaseアプリからWorkspaceでブロードキャストを表示して通知を受信できるユーザーは、Broadcastマイクロアプリにサブスクライブする必要があります
  3. ブロードキャストを削除するなど、ブロードキャストを管理できる必要があるユーザーは、 ブロードキャストを管理マイクロアプリに登録する必要があります
  4. WorkspaceでFAQを見る必要がある人は、FAQマイクロアプリに登録する必要があります

ユーザーをマイクロアプリにサブスクライブするための主なリファレンスはこちら

注:これは概念実証であるため、(サブスクライバーを変更して)マイクロアプリを表示できるユーザーを制限することが望ましい場合があります。

マイクロアプリをテストする

このセクションでは、マイクロアプリの基本機能が概念実証のためにテストされます。

ブロードキャストマイクロアプリ

この例では、ブロードキャストを作成する権限を持つユーザーが新しいライブ放送を作成します。次に、そのブロードキャストは、アクティビティフィードとブロードキャストマイクロアプリの両方で Workspace に表示されます。

  1. Citrix Workspace にログインします
  2. 「アクション」に移動して、「ライブ放送を作成」をクリックします
  3. テスト放送を作曲する
  4. 「作成」をクリック
  5. Podioがパーミッションの付与を求めるポップアップが表示されたら、[アクセスを許可] を選択します

この時点で、新しいブロードキャストがCitrix Workspace に投稿されました

ブロードキャストが記録システム (この場合はPodio) に投稿されたことを確認します。

  1. Citrix Workspace で[アクション]に移動し、[ブロードキャスト]をクリックします
  2. ブロードキャストの投稿が表示され、クリックして詳細を表示できます

ブロードキャストがアクティビティフィードに投稿されていることを確認する

デフォルトでは、Citrix Workspace アクティビティフィードへの通知は、データがPODIOベースの記録システムからマイクロアプリ統合サービスに増分同期される場合にのみ投稿されます。デフォルトでは、この同期は 1 時間ごとに行われます。

これを変更したり、同期を強制したりするには、「 データの同期」を参照してください。

データ同期が行われると、通知がワークスペースアクティビティフィードに表示されます。

アクティビティフィード

Workspaceにログインしたユーザーは、ブロードキャストの作成マイクロアプリとブロードキャストマイクロアプリの両方にアクセスできるため、通知:作成の確認とブロードキャスト自体の両方が表示されます。

通知がアクティビティフィードにない場合は、フィードの並べ替えを [推奨] から [最新] に変更してみてください。

よくある質問マイクロアプリ

FAQマイクロアプリのテストは少し異なります。現在、FAQを作成または編集するマイクロアプリがないため、これはPodioを介して行われます。幸いなことに、これはPodioバックエンドがマイクロアプリとどのように相互作用するかを示すのに役立ちます。

  1. PodioにログインしてFAQアプリに移動する
  2. 選択:質問を追加
  3. [タイトル] と [回答] (これらは必須)、およびその他の適切なフィールドに入力します。
  4. 質問を公開するには、[ステータス] を [公開済み] に設定します
  5. 質問を保存をクリックします

これにより、質問がPodioアプリのバックエンドに保存されます。次に、Workspace で新しい FAQ エントリを確認します。

  1. Citrix Workspace にログインします
  2. [アクション] に移動し、[FAQ] をクリックします
  3. データ同期が行われた場合は、FAQ が表示されます。増分同期を強制するには、「 データの同期」を参照してください。
  4. 新しいFAQエントリをクリックして、その全内容を読んでください

注:デフォルトでは、新しい FAQ エントリの通知は、アクティビティフィードに定期的に自動的に投稿されません。これは、アクティビティフィードの過密を防ぐのに役立ちます。これを変更するには、 マイクロアプリ通知の詳細をご覧ください

これで、基本的なマイクロアプリ機能のテストは完了です。

最終要約

概念実証ガイドはこれで終わりです。このガイドに従っている間、次のことを行います。

  1. App Builderを使用してPodioインスタンスを作成またはCitrix Cloud にリンクした
  2. ブロードキャストマイクロアプリとFAQマイクロアプリの記録システムとして機能するCitrix提供のPodioアプリを追加しました
  3. PODIOが支援する記録システムを使用するようにマイクロアプリ統合を追加および構成しました
  4. サブスクライバーをマイクロアプリに追加して、適切なユーザーがブロードキャストを投稿できるようにし、Workspaceを使用するすべての人にブロードキャストとFAQが表示されるようにしました
  5. Citrix Workspace でブロードキャストマイクロアプリとFAQマイクロアプリの基本機能をテストしました

さらに読む

  • Citrix PodioアプリとCitrix Workspace マイクロアプリの統合に関する詳細: Podioの統合