シナリオを保存する

デフォルトでは、Workshop で作成されたシナリオは一時的なものです。現在のセッション内でのみ存在し、セッションが終了すると削除されます。シナリオを保存すると、オントロジーに保存できるため、セッションをまたいで再利用したり、ほかのユーザーと共同作業したりできます。

保存されたシナリオを整理し、関連するシナリオを見つけやすくするために、ワークフロー固有のメタデータをシナリオとともに保存しておくと便利です。

これを実現するために、オントロジーを活用して、保存されたシナリオを表すオブジェクトを作成します。

ユーザーは、名前や追加のプロパティに加えて、シナリオオブジェクトとほかのオブジェクトとの関係もカスタマイズできます。

オブジェクトのシナリオ機能

シナリオの保存を開始する前に、シナリオトレイトを実装するオブジェクトを作成する必要があります。

最低限、シナリオ ID を保持するプロパティと、シナリオ名を保持する別のプロパティが必要です。

シナリオ ID にはオブジェクトの主キープロパティを、シナリオ名にはタイトルプロパティを使用することを強く推奨します。

作成者や説明など、シナリオに関する追加情報を保持するほかのプロパティも追加できます。

シナリオオブジェクトのプロパティタブで ID プロパティを選択し、以下に示すようにタイプクラス scenarios:versioned-scenario-rid を追加します。

次に、名前またはタイトルのプロパティを選択し、タイプクラス scenarios:scenario-name を追加します。

これで、シナリオオブジェクトに保存済みシナリオを格納する準備ができました。ただし、Workshop でこのオブジェクトにシナリオを保存するには、このタイプのオブジェクトを作成するアクションを設定する必要があります。

シナリオアクション

シナリオオブジェクトに加えて、Workshop でシナリオを保存するときに使用する、シナリオオブジェクトを作成および更新するアクションが必要です。

シナリオ作成アクション

まず、シナリオトレイトを実装するオブジェクトを作成するアクションを作成します。

ルールタブで、シナリオの作成時に指定する必要があるプロパティを追加します。

最低限、シナリオのシナリオ ID プロパティと名前プロパティを追加する必要があります。

次に、シナリオ ID プロパティと名前プロパティに正しいタイプクラスが設定されていることを確認する必要があります。

作成しているアクションは新しいシナリオを作成するものなので、フォームタブでは、プロパティのリストからシナリオオブジェクトを外すことができます。

シナリオ ID という名前の新しい文字列プロパティを作成します。

詳細タブで、タイプクラス scenarios:versioned-scenario-rid を追加します。

シナリオ名を設定するアクションプロパティに、タイプクラス scenarios:scenario-name がまだ設定されていない場合は追加します。

ルールタブで、シナリオ ID を先ほど作成した文字列値に設定できるようになりました。

シナリオ更新アクション

次に、シナリオトレイトを実装するオブジェクトを更新するアクションを作成します。

ルールタブで、名前プロパティを追加します。

フォームタブで、変更対象のシナリオオブジェクトを決めるアクションプロパティに、タイプクラス scenarios:scenario-object-locator を追加します。

シナリオ名を更新するアクションプロパティに、タイプクラス scenarios:scenario-name がまだ設定されていない場合は追加します。

これで、Workshop でシナリオを保存し、保存済みシナリオを更新するために、シナリオオブジェクトとアクションを使用する準備ができました。

シナリオを保存ボタンを設定する

コアのボタングループウィジェットのボタンから、シナリオを保存できるようにします。

まず、ボタングループに新しいボタンを追加し、クリック時のイベントとして「シナリオを保存」を選択しました。

オブジェクトに保存するには、シナリオトレイトを実装するオブジェクトタイプを選択する必要があります。

オブジェクトタイプを選択したら、そのタイプのシナリオオブジェクトを作成するアクションを選択する必要があります。

アクションパラメーターのタイプクラスが正しく設定されていれば、シナリオ ID と名前のパラメーターが自動的に入力されるはずです（以下を参照）。

ほかのアクションパラメーターは、Workshop のほかのアクションと同じ方法で設定できるため、デフォルト値を設定することも、ユーザーが入力できるように空欄のままにすることもできます。

たとえば、現在のユーザーという特殊変数を使用して、作成者パラメーターに値を入力できます。

作成アクションと更新アクションを設定すると、モジュールのユーザーがウィジェットからシナリオを保存できるようになります。

ユーザーとしてシナリオを保存する

ユーザーは、設定された保存ボタンを使用して、新しく作成したシナリオを保存したり、既存のシナリオを更新したりできます。

また、シナリオマネージャーでは、作成後にまだ保存されていないシナリオには、保存されるまで「新規」タグが表示されます。以前に保存され、その後変更されたシナリオには「更新済み」タグが表示されます。

新しいシナリオを保存するときは、シナリオ作成アクションのダイアログが開きます。

名前とシナリオ ID は自動的に入力され、ユーザーは追加のアクションパラメーターの値を入力または変更できます。

この例には説明項目が含まれており、ユーザーはここに入力した内容をシナリオとともに保存できます。

確定をクリックすると、シナリオが保存され、「新規」インジケーターが表示されなくなります。

この時点でシナリオは保存されていますが、そのように設定しない限り、このアプリケーションにアクセスしたときにデフォルトで読み込まれることはありません。

この動作の設定方法については、シナリオを読み込むチュートリアルを参照してください。

編集者ロールなしでシナリオを保存する

Workshop モジュール内でシナリオを保存する際に問題が発生する場合は、Foundry の権限に編集者ロールが含まれていないことが原因かもしれません。これは特に、モジュールの編集権限を付与せずに、Workshop モジュールでシナリオを保存できるようにしたい場合に問題となります。シナリオを保存する予定がない場合は、問題にはならないはずです。

この問題については、Palantir の担当者に連絡して、(1)「シナリオを作成できる閲覧者」ロールの作成と、(2)以下の2枚目の画像でチェックされている閲覧者の項目の更新を依頼してください。