状態の保存

状態の保存は、モジュールの利用者がモジュール内で作業の現在の状態を保存し、後からその保存済みの状態に戻ったり、ほかのユーザーと共有したりできる、Workshop の強力な機能です。

状態の保存により、Workshop で複雑かつ長時間にわたるワークフローを構築しやすくなり、ユーザー間のコラボレーションも容易になります。状態の保存のユースケースには、次のような例があります。

• Status プロパティが「Unresolved」、Location プロパティが「Zurich」の Alert オブジェクトに絞り込み、その状態を後で参照できるように保存します。
• 関心のある特定のオブジェクトを選択し、その表示を保存して同僚と共有します。
• Workshop のネイティブウィジェット（たとえば、テキスト入力ウィジェットや日付入力ウィジェット）で作成した入力フォームに一部を入力し、後で戻ってデータ入力を完了できるように状態を保存します。

状態を保存すると、Workshop は次の2つを保持します。（1）状態の保存で使用するように有効化された変数の現在の値（「状態」）と、（2）任意で、ユーザーが現在閲覧しているページです。Workshop の編集モードでは、モジュールの作成者が状態の保存に使用する変数を決めることや、状態の保存に関するほかのオプションを設定することができます。その後、Workshop の閲覧モードで、モジュールの利用者がワークフローに応じて状態を保存、開く、共有することができます。

次のスクリーンショットは、状態の保存の例を示しています。この例では、モジュールの作成者が、フィルターリストから出力されるオブジェクトセットフィルター変数を保持するように状態の保存を設定しています。これにより、NYC の空港からの、優先度が高または中の未対応アラートについて、ユーザーが選択した絞り込み条件が保存されます。また、モジュールの作成者は、オブジェクトテーブルウィジェットから出力されるアクティブなオブジェクトセット変数も設定しています。これにより、テーブル内で現在強調表示され、このモジュールの右側にある Object View ウィジェットに表示されているアラートが保存されます。この状態を保存すると、モジュールの利用者は、後から NYC のフライトアラートのこの特定の表示に簡単に戻ったり、リンクとしてほかのユーザーと共有したりできます。

状態の保存を有効にする方法

Workshop の編集モードでは、作成者は次の3つのステップで状態の保存を有効にできます。各ステップの詳細は以下で説明します。

1. モジュールの設定パネルを開き、状態の保存を有効化するをオンにします。
2. 状態を保存する変数に対して状態の保存を有効にします。
3. 任意で、このモジュールの保存済みの状態に対して、許可する保存場所とショートカットを設定します。

状態の保存をオンにする

設定アイコン（）を選択して、設定パネルを開きます。このパネル内で、以下のように状態の保存を有効化するトグルを有効にします。

変数に対する状態の保存を設定する

変数パネルを開き、状態を保存する変数に対して状態の保存を有効にします。これを行うには、変数を選択し、設定タブに移動して変数に外部IDを追加します。以下のスクリーンショットは、フィルターリストウィジェットから出力されるオブジェクトセットフィルター変数に対して状態の保存を有効にする例を示しています。これにより、ユーザーが選択した絞り込み条件が保存されます。

デフォルトフィルターやフィルター値の抽出など、オブジェクトセットフィルター変数の設定の詳細については、オブジェクトセットフィルター変数を参照してください。

任意の設定を構成する

設定パネルの状態の保存セクションで、ユーザーの現在のページを保存済みの状態内に保持するための設定を構成できます。また、このモジュールの保存済みの状態に対して、許可する保存場所とフォルダーショートカットも設定できます。フォルダーショートカットを使用すると、このモジュールの共有可能な状態をすべて同じ場所に保存しやすくなります。

デフォルトの保存済みの状態を設定する

任意の保存済みの状態をモジュールのデフォルトとして指定できます。デフォルトの状態を設定すると、URL に特定の保存済みの状態が含まれていない状態でユーザーがモジュールに再アクセスしたときに、Workshop がその状態を自動的に適用します。

デフォルトの状態を設定するには、次の手順を実行します。

1. モジュールのヘッダーから状態の保存メニューを開きます。
2. デフォルトとして設定する保存済みの状態を選択します。
3. モジュールのデフォルトの状態として設定する選択肢を選択します。

新しい状態を初めて保存するときに、その状態をデフォルトとして設定することもできます。デフォルトの状態の指定を解除するには、状態の保存メニューを使用してデフォルト設定をクリアします。

設定オプション

状態の保存に関する主な設定オプションは次のとおりです。

• 状態の保存を有効化する： このトグルは、現在のモジュールで状態の保存を有効にするかどうかを制御します。true の場合、モジュールの利用者は、状態の保存が有効になっている変数の値とモジュール内の現在のページを保存できます。false の場合、モジュールの利用者には状態の保存に関するオプションが表示されません。
• 表示
  • 状態の表示名： この項目は、このモジュール内で保存済みの状態1つを利用者にどのような名前で表示するかを決定します。画面上の表現を特定のアプリケーションのニーズに合わせるためのものです。デフォルトでは、モジュールの状態に設定されています。受信トレイに設定すると、モジュールの利用者には、画面上で保存済みのモジュールの状態ではなく保存済みの受信トレイと表示されます。
  • 状態の表示名（複数形）： この項目は、このモジュール内で複数の保存済みの状態を利用者にどのような名前で表示するかを決定します。画面上の表現を特定のアプリケーションのニーズに合わせるためのものです。デフォルトでは、モジュールの状態に設定されています。受信トレイに設定すると、モジュールの利用者には、画面上で保存済みのモジュールの状態ではなく保存済みの受信トレイと表示されます。
• データ
  • 状態を保存する変数： 状態を保存すると、モジュール内で状態の保存が有効になっている変数の現在の値が保持されます。
  • ページ： 有効にすると、状態を保存したときに、モジュール内の現在アクティブなページが保持されます。
• 場所
  • ショートカットの追加： このオプションでは、ビルダーが、このモジュールの状態を保存できる特定のプロジェクトフォルダーへのショートカットを設定できます。フォルダーのショートカットごとに、カスタム表示名を任意で設定できます。
  • 個人フォルダ： 有効にすると、ユーザーの非公開の個人フォルダに状態を保存できます。
  • Compass の任意の場所： 有効にすると、モジュールの利用者が選択した任意のプロジェクトフォルダーに状態を保存できます。

サポートされている変数タイプとウィジェット

状態の保存では、次の Workshop 変数タイプの値を保持できます。

• ブール値、日付、数値、文字列、またはタイムスタンプの配列
• ブール値
• 日付
• オブジェクトセット
• オブジェクトセットフィルター
• 数値
• 文字列
• タイムスタンプ

上記の変数タイプのいずれかを出力するウィジェットも、状態の保存をサポートしています。サポートされているウィジェットには、次のものがあります。

• チェックボックス
• 日付入力
• 日時ピッカー
• フィルターリスト
• 数値入力
• オブジェクトドロップダウン
• オブジェクトリスト
• オブジェクトテーブル
• 文字列ドロップダウン

制限

埋め込みモジュールからの状態保存設定の継承なし

Workshop モジュールを埋め込んでも、埋め込みモジュールの状態保存設定は引き継がれません。埋め込みモジュールの変数の値を保存済みの状態に保存するには、必要な変数を子モジュールのモジュールインターフェースに追加し、埋め込みモジュールの設定で親モジュールの保存済み状態の変数を渡します。

状態の保存はプラットフォームアクセスを持つユーザーのみ利用可能

エンドユーザーが状態の保存を利用できるのは、そのユーザーのプラットフォームアクセスが有効になっている場合のみです。プラットフォームアクセスを持たないユーザーは、状態の保存に関するコンポーネントにアクセスできません。プラットフォームアクセスの制限については、詳しくはこちら。

モジュールヘッダーの表示が必須

モジュールの利用者が閲覧モードで状態の保存に関するオプションにアクセスするには、モジュールヘッダーが表示されている必要があります。モジュールヘッダーが非表示の場合、モジュールの状態の保存が適切に設定されていても、状態の保存のドロップダウンはインターフェースに表示されません。

状態の保存ではユーザーごとの設定は自動保存されない

状態の保存では、ユーザーごとに自ら状態を保存する必要があります。ユーザーごとの環境設定や設定が自動的に保存されるわけではありません。購読トグルや「今後表示しない」ダイアログ設定など、手動操作なしで各ユーザーの選択を記憶する、ユーザーごとの環境設定の自動保存がワークフローで必要な場合は、代わりにオントロジーのオブジェクトを使用してこれらの環境設定を保存および管理することを検討してください。