マイクロアプリ

Smartsheetの統合

Smartsheet統合を展開して、シート、ディスカッション、更新リクエスト、および添付ファイルを管理します。

すぐに利用可能なSmartsheet用のマイクロアプリの包括的な詳細については、「Smartsheetマイクロアプリの使用 」 を参照してください。

注:

このSmartsheet統合テンプレートは、Citrix Labsカテゴリでリリースされています。これにより、最初の顧客フィードバックの結果として機能を成熟させることができます。Citrix Labsテンプレートの場合、サポートの義務はなく、サポートは開発者によってベストエフォートで提供されます。Citrix Labs統合テンプレートは、テストと検証の目的で共有されます。それらを実稼働環境に展開することはお勧めしません。Citrix Labsテンプレートは別のセクションに一覧で記載されています。ご意見、ご要望をお聞かせください。この統合テンプレートに関するフィードバックをお送りください。また、問題についてはサポートチームが専用フォーラムを毎日確認いたします。

必須条件の確認

これらの前提条件は、管理者が組織のSmartsheet統合セットアップの一部であることを前提としています。このSmartsheet管理者アカウントには、すべてのユーザーとシート情報に対する完全な読み取り権限が必要です。

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

  • ベースURLhttps://api.smartsheet.com/
  • 認証URLhttps://app.smartsheet.com/b/authorize
  • トークンURLhttps://api.smartsheet.com/2.0/token
  • クライアントID:クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthサーバーを構成したときに、アプリケーションキーとしてこれを収集します。
  • シークレット:クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。OAuthサーバーを構成したときに、アプリケーションキーとしてこれを収集します。

注:

利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

Citrix GatewayでBlackboardへのシングルサインオンがサポートされるよう構成して、ユーザーが一度ログインすれば、再度資格情報を入力しなくても自動的に再ログインできるようにします。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

サービスアカウントの作成

統合ではSmartsheetインスタンスへの定期的なアクセスが必要なので、Smartsheetで専用のユーザーアカウントを作成することをお勧めします。このアカウントには、サービスアカウントの次の権限が必要です:完全な管理者特権。https://admin.smartsheet.comを使用して権限/特権を表示できます。

サービスアカウントを作成するには、次のサイトでサインアップします:https://app.smartsheet.com/b/signup。新しいサービスアカウントを作成するために、有料アカウントが利用可能であることを確認してください。

新しいサービスアカウントの設定で問題が発生した場合は、それぞれのセールスサポートチームまたはカスタマーサポートチームに連絡してください:https://www.smartsheet.com/contact/sales?fts=contact

APIアクセス

特定のリソースに対して実行できるAPI要求の数は限られているため、以下をお勧めします:

Smartsheet APIは、デフォルトでオープンソースで利用できます。

OAuthサーバーの構成

Smartsheet統合を介してデータを読み取るようにOAuthサーバーを構成します。

  1. https://developers.smartsheet.com/register/に移動し、サービスアカウントの管理者のメールアドレスを入力します。
  2. [Register Developer Account] を選択します。
  3. サービスアカウントの管理者の受信トレイで、Smartsheetからのメールを確認します。
  4. リンクを選択します。https://app.smartsheet.comに移動します。
  5. ダイアログボックスが表示され、新しいアプリを作成するように求められます。開発者プロファイルセクションで [Create New App] を選択します。
  6. [App name]、[Description]、[URL]、[Contact/Support email]などの必須フィールドに入力します。
  7. [Redirect URL]フィールドに、このアプリ用に以下の承認済みリダイレクトURLを入力します:https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  8. [Publish app]チェックボックスをオンにして、[Save]を選択します。
  9. 画面に表示されているClientIdSecretをコピーして保存します。統合を構成するときに、これをサービス認証に使用します。

OAuthクライアントの構成

Smartsheet統合を介してデータをライトバックするようにOAuthクライアントを構成します。

  1. 上記の手順5と同様に、開発者プロファイルセクション下にある [Create New App] を選択します。
  2. [App name]、[Description]、[URL]、[Contact/Support email]などの必須フィールドに入力します。
  3. [Redirect URL]フィールドに、このアプリ用に以下の承認済みリダイレクトURLを入力します:https://{yourmicroappserverurl}/admin/api/gwsc/auth/serviceAction/callback
  4. [Publish app]チェックボックスをオンにして、[Save]を選択します。
  5. 画面に表示されているClientIdSecretをコピーして保存します。統合を構成するときに、これをサービスアクション認証に使用します。
  6. [Close] を選択します。

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

Smartsheet統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. [マイクロアプリ統合] ページで [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  2. SmartSheetタイルを選択します。
  3. 統合の [統合名] を入力します。
  4. コネクタのパラメーターを入力します。
    • インスタンスの [ベースURL] を入力します:
    • アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。
  5. [サービス認証][認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。
    1. [認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。
    2. [トークン認証] メニューから [認証ヘッダー] を選択します。
    3. [認証URL] は事前に入力されています: https://app.smartsheet.com/b/authorize
    4. [トークンURL] は事前に入力されています: https://api.smartsheet.com/2.0/token
    5. スコープに次のように入力されていることを確認します:ADMIN_SHEETS ADMIN_USERS READ_SHEETS READ_USERS
    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthサーバーを構成するときに、ClientIdとしてこれを収集します。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。OAuthサーバーを構成するときに、シークレットとしてこれを収集します。
  6. [サービスアクション認証][[アクション]で個別のユーザー認証を使用する] トグルを有効にします。サービスアクション認証は、サービスアクションレベルで認証します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。
    1. [認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。
    2. [トークン認証] メニューから [認証ヘッダー] を選択します。
    3. [認証URL] は事前に入力されています: https://app.smartsheet.com/b/authorize
    4. [トークンURL] は事前に入力されています: https://api.smartsheet.com/2.0/token
    5. スコープに次のように入力されていることを確認します:ADMIN_SHEETS ADMIN_USERS SHARE_SHEETS WRITE_SHEETS CREATE_SHEETS ADMIN_WORKSPACES
    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthクライアントを構成するときに、ClientIDとしてこれを収集します。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。OAuthクライアントを構成するときに、シークレットとしてこれを収集します。
  7. [要求レート制限を有効にする] トグルボタンを有効にします。[要求数] に「300」と入力し、[時間間隔]には [1分] を選択します。
  8. [要求タイムアウト] は、デフォルトで「120」に設定されています。
  9. (オプション)サポートのために24時間のログを保持するには、[ログ] を有効にします。
  10. [保存] を選択して続行します。

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

同期

API呼び出しの制限により、増分同期は、組織シートの一覧表示要求、組織ディスカッションの一覧表示要求、およびすべての組織セットアップ日の取得要求のみを保持するよう設定されています。残りのエンドポイントは、完全同期の一部としてトリガーされます。

Smartsheetからマイクロアプリプラットフォームへのデータを定期的に更新し、タイムリーな通知を受信するには、[完全同期]間隔を [毎日] に、[増分同期]間隔を [5分ごと] に設定することをお勧めします。同期ルール、スケジュールを満たさない同期、および拒否ルールの詳細については、「データの同期」を参照してください。

注:

ページネーション制限は100に設定されています。管理者は、APIに基づいてこの制限を拡張できます。

[変数を読み込む最大ページ数] のデフォルト値は、次のように設定されています:

エンドポイント名
組織シートの一覧表示 50
グループの一覧表示 10
組織ディスカッションの一覧表示 10
すべての組織セットアップ日の取得 10
シートの一覧表示 50
シートの取得 10
シート共有の一覧表示 10
グループの一覧表示 50

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

Smartsheetマイクロアプリの使用

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

シートへのアクセス: シートを表示したり、ライセンスがある/ないユーザーまたはグループとシートを共有したり、お気に入りとしてシートを追加したり、ユーザーが個々のシートを表示できるようにしたりするために使用します。

通知またはページ ユースケースワークフロー
すべてのシートを表示ページ ユーザーは共有可能および共有不可能なシートを検索できます。
共有可能なシートの詳細ページ シートをお気に入りとして追加したり、シートを表示したり、ライセンスがある/ないユーザーまたはグループとライセンスシートを共有したりするためのアクション可能なビューが表示されます。
共有不可シート詳細ページ シートをお気に入りとして追加し、シートを表示するアクション可能なビューを提供します。
共有可能なグループシートの詳細ページ シートをお気に入りとして追加したり、シートを表示したり、ライセンスがある/ないユーザーまたはグループとライセンスシートを共有したりするためのアクション可能なビューが表示されます。
共有不可グループシートの詳細ページ グループシートをお気に入りとして追加したり、グループシートを表示したりするためのアクション可能なビューが表示されます。

シートの作成: シート名などのフィールドおよびオプションが付いた新しいシートの作成、列タイトルの入力、列タイプの選択、プライマリ列の選択を行ないます。

通知またはページ ユースケースワークフロー
シートの作成ページ 新しいシートを作成するためのフォームを提供します。

ディスカッション: ディスカッションスレッドへの返信があるたびに、ディスカッション作成者への通知を生成します。

通知またはページ ユースケースワークフロー
ディスカッション通知に新しいコメントが追加されました 返信またはコメントが既存のディスカッションに追加されると、ディスカッションの作成者は通知を受け取ります。
ディスカッション詳細ページ ディスカッションスレッドに返信し、以前のコメントを表示するためのフォームが表示されます。

自分の更新リクエスト: 送信先、送信元、件名、ステータスなどの詳細を含む、送受信された更新リクエストを表示します。また、ユーザーが更新リクエストを受信者に送信すると、受信者は通知を受け取ります。更新リクエストが完了すると、送信者は完了通知を受け取ります。

通知またはページ ユースケースワークフロー
Smartsheet更新リクエスト受信通知 要求者が更新リクエストを提出すると、受信者は通知を受け取ります。
Smartsheet更新リクエスト完了通知 受信者が更新リクエストを完了すると、要求者は通知を受け取ります。
すべての更新リクエストページ ユーザーは送受信された更新リクエストを検索できます。
送信された更新リクエスト詳細ページ 更新リクエストの削除およびシートの表示機能を使用して、送信された更新リクエストのアクション可能なビューを提供します。
受信した更新リクエスト詳細ページ ビューシート機能を使用して、受信した更新リクエストの読み取り専用ビューを提供します。
完了した更新リクエスト詳細ページ ビューシート機能を備えた、完了した更新リクエストの読み取り専用ビューを提供します。

Smartsheetを添付ファイルとして送信: 送信先、件名、メッセージなどの詳細が含まれるSmartsheetを添付ファイル(PDFまたはExcel)として送信します。

通知またはページ ユースケースワークフロー
すべてのシートを表示ページ ユーザーは自分が所有するシートを検索できます。
メールとして送信の詳細ページ Smartsheetを件名やメッセージが付いた添付ファイル(PDFまたはExcel)として送信するためのアクション可能なビューを表示します。

管理者と共有: 管理者以外のユーザーが自分のシートを表示専用アクセスで管理者と共有したり、アクセスシート、自分の更新リクエスト、ディスカッションなどの他の機能のロックを解除したり、それぞれの通知を受け取ったりするために使用されます。シートを管理者と共有して、更新リクエストのアクション/通知、ディスカッションの通知、およびシートの表示など、追加のSmartsheetのアクションおよび通知をWorkspaceでロック解除します。

注:

このマイクロアプリには、[管理者にシートを共有]という名前のページがあり、[管理者のメール]と呼ばれる選択コンポーネントが含まれています(これはエンドユーザーには表示されません)。このコンポーネントは、組織の管理者アカウントとユーザーシートを共有するために使用されます。この管理者アカウントは、前の手順で設定したものと同じサービスアカウントです。組織に複数のサービス/管理者アカウントがある場合、この [管理者メール] 選択コンポーネントを、このマイクロアプリが正しく機能するよう適切なアカウントにポイントするようにしてください。

通知またはページ ユースケースワークフロー
すべてのシートを表示ページ ユーザーは自分のシートを検索し、必要に応じて管理者と共有することができます。
管理者にシートを共有の詳細ページ 表示のみのアクセスで管理者とシートを共有したり、既に共有されているシートにメモを追加したりすることができる、アクション可能なビューを表示します。
管理者とシートを共有ページ シートが管理者と共有されるときにユーザー確認メッセージを提供します。

ディスカッションの開始: シートレベルでディスカッションを開始します。

通知またはページ ユースケースワークフロー
ディスカッションを開始ページ シートレベルでディスカッションを開始するためのアクション可能なビューを表示します。
Smartsheetの統合