Workshop の自動更新

Workshop の自動更新を使用すると、ビルダーは Foundry のデータが変わるたびに自動的に更新されるアプリケーションを簡単に作成できます。ユーザーに信頼性が高く最新の情報を提供することは、運用ワークフローをサポートする上で非常に重要であり、Workshop はこれを数回のクリックで実現します。

自動更新を使用すると、Foundry 内のどこからでも更新を監視するためにモジュール内のオブジェクト セットを登録できます。更新が発生すると、ユーザーの操作なしに現在のモジュール内のすべてのデータが自動的に更新されます。更新ソースの例として、他のユーザーによるアクションによるオントロジーデータの更新、上流のデータ統合からの編集、またはストリーミングデータソースからの新しいレコードがあります。これらの場合、自動更新は現在のモジュール内のデータを更新します。

自動更新は、ライブダッシュボードや共同作業ワークフローなど、データの新鮮さが優先される場合に価値があります。

特定の Workshop モジュール内で自動更新を有効にできます。Workshop エディタの Settings パネルの下部にある自動更新の設定オプションに移動します。

設定

自動更新の設定を更新するには、Settings パネルで Auto-refresh を選択します。次に、パネルの下部にある Settings セクションを展開します。

更新間隔の最小秒数

この設定では、モジュールビルダーがデータの更新間隔の最小時間を設定できます。この設定は初回の更新遅延には影響しませんが、モジュールが常にリロードされないようにします。現在の最小更新間隔は 10 秒であり、自動更新による負荷の増加によりサービスの安定性を確保します。

編集モードで無効にする

この設定では、モジュールビルダーが編集モード中に自動更新動作をオフにすることができます。編集モードでの自動更新がビルド体験を妨げる場合や不要な場合、ビルダーはこれを使用することができます。この設定を有効にしても、自動更新は表示モードで構成およびアクティブなままです。

制限事項

Object Storage V2 (OSv2)

自動更新は OSv2 を利用したオブジェクトタイプに限定されています。この制限は、オブジェクト セット定義で使用される OSv1 を利用したオブジェクトタイプのリンクオブジェクトを含むオブジェクトセットに適用されます。

OSv1 から OSv2 への移行の詳細をご覧ください。

ユーザー入力を含むワークフロー

ユーザー入力を含むワークフローは自動更新を使用するモジュールで禁止されていません。しかし、更新後に変数またはウィジェットの状態がリセットされる問題に直面することがあります。この問題を回避するには、この問題が発生する変数で自動再計算動作を使用しないようにする必要があります。これだけでは不十分な場合、iFrame ウィジェット を使用して、サンドボックス環境として機能し自動的に更新されない別のモジュールを埋め込むことができます。別の方法として、ユーザー入力を含むワークフローの一部を完了するために、新しいブラウザーや Carbon タブで開く別の Workshop モジュールを使用することもできます。

リンクオブジェクトタイプの自動更新

自動更新はリンクオブジェクトタイプの更新を自動的に監視しません。これは、監視対象のオブジェクトセットのリンクオブジェクトプロパティおよびリンクオブジェクト集計は、リンクオブジェクトタイプも明示的に監視されない限り、自動更新されないことを意味します。

フィルター

現在、自動更新では terms、phrase、multiMatch、prefixOnLastToken、および objectSetLink のようなオブジェクトセットフィルタータイプはサポートされていません。これらのフィルタータイプのサポートは将来的に追加される可能性があります。回避策として、同じタイプのフィルター処理されていないオブジェクトセットを監視できます。これにより必要以上に頻繁に更新が行われる可能性がありますが、モジュール内でオブジェクトタイプが最新の状態に保たれることが保証されます。

モジュール内の可視性

現在、自動更新が有効なオブジェクトセットは、モジュール内の可視ウィジェット内で使用されている必要があります。これにより、モジュール内に表示されるデータに影響を与えない自動更新を防ぎます。たとえば、登録済みのオブジェクトセットが非表示のドロワー内でのみ使用されている場合、自動更新はそのドロワーが開いている間にのみ発生します。

埋め込みモジュールからの自動更新設定の継承なし

Workshop モジュールの埋め込み は、埋め込みモジュールの自動更新設定を引き継ぎません。自動更新を使用するすべてのモジュールに対して、明示的に自動更新を設定する必要があります。

トラブルシューティング

自動更新の問題に関連するエラーが発生した場合、以下の点を確認してください。

• すべてのオブジェクトタイプおよびリンクタイプが Object Storage V2 を利用していることを確認します。特に、OSv2 を利用した 2 個のオブジェクトタイプが OSv1 を利用したリンクタイプを持っている場合、これが自動更新のエラーを引き起こす可能性があります。
• 無効なフィルタータイプをオブジェクトセットに追加するなど、ランタイムで無効なオブジェクトセットが設定されないようにします。オブジェクトセットが最初は自動更新に適していても、アプリケーションとのユーザーのやり取りによって更新を監視できない状態になる可能性があります。
• ネットワーク接続の安定性を向上させることで、自動更新機能の安定性が直接向上します。ネットワークが切断および再接続される場合、自動更新が無効になると通知するエラーが表示されることがあります。
• 期待される更新が表示されない場合、監視対象のオブジェクトセットが特定すぎる可能性があります。より広いオブジェクトセット、たとえば特定のタイプのベースオブジェクトセットや、より広いフィルターを監視してみてください。次に、この広範な監視対象のオブジェクトセットの下流に、より具体的なフィルターを持つ変数を定義できます。
• より詳細なエラーメッセージについては、ブラウザーコンソールを確認してください。以下に、自動更新を使用しているときに発生する可能性がある一般的なエラーの詳細を示します。
  • InvalidObjectSetForPlanning: 監視対象のオブジェクトセットに Object Storage V1 にインデックスされたエンティティ（オブジェクトタイプまたはリンクタイプのいずれか）へのリファレンスが含まれています。