AIP Logic のステージング書き込み

ステージング書き込みは、オントロジーのオブジェクトを編集する AIP Logic 関数向けに、改善された実行モデルを提供します。新しく作成されるロジック関数では、まもなくステージング書き込みがデフォルトで有効になります。

レガシーのオントロジー編集動作と比較して、ステージング書き込みを使用するロジック関数には次の特徴があります。

• ネストされた関数呼び出しとアクション呼び出しでのオントロジー編集に対応します。 ステージング書き込みを使用するロジック関数は、ステージング書き込みを使用するほかの関数や、オントロジーを直接編集するほかの関数を呼び出すことができます。また、オントロジーを編集するほかの関数に基づいているアクションを適用することもできます。以前は、これらの操作に対応していませんでした。
• すべてのオブジェクトセットフィルターに対応します。 レガシーモードでは利用できないキーワードを含むフィルターと相対的な期間フィルターを含め、すべてのオブジェクトセットフィルターが利用できるようになりました。

ステージング書き込みのセマンティクスの詳細については、ステージング書き込みのドキュメントを参照してください。

レガシー動作との主な違い

ステージング書き込みを使用するロジック関数とレガシーのオントロジー編集動作には、いくつかの重要な違いがあります。

ネストされた関数呼び出しとアクション呼び出しでのオントロジー編集

ステージング書き込みを有効にすると、ロジック関数は、ステージング書き込みを使用するほかの関数（ほかのロジック関数や TypeScript v2 関数など）や、オントロジーを直接編集するほかの関数を呼び出すことができます。また、オントロジーを編集するほかの関数に基づいているアクションを適用することもできます。以前は、オントロジーを編集する別のロジック関数に基づいているアクションを、ロジック関数内から呼び出すことには対応していませんでした。

ネストされた呼び出しによる編集は、同じロジック実行内の後続の読み取りで参照できます。すべての編集は一時ストレージにステージングされ、実行の完了時にオントロジーに適用されます。

たとえば、サポートメールを処理するロジック関数は、Support Ticket オブジェクトを作成した後、別のロジック関数に基づいているトリアージアクションを適用できます。そのトリアージ関数は、チケットを割り当て、関連するオブジェクトを編集できます。すべての編集はまとめてステージングされ、ロジック関数の後続のブロックで両方の結果をクエリできます。

すべてのオブジェクトセットフィルターボードへの対応

レガシーモードでは、ロジック関数が一度編集を行うと、その実行の残りの処理では次のオブジェクトセットフィルターボードを利用できなくなります。

• キーワードを含む
• キーワードを含む（順序どおり）
• 相対的な期間

ステージング書き込みを有効にすると、AIP Logic の実行全体を通して、すべてのオブジェクトセットフィルターを利用できます。

関数の出力がオントロジー編集のリストではなくなる

オントロジーを編集するレガシーのロジック関数は、オントロジー編集のリストを出力として返します。一方、ステージング書き込みを使用するロジック関数は、編集を一時ストレージにステージングし、実行の完了時にオントロジーに適用します。その結果、関数はオントロジー編集を返さなくなり、ほかのデータ型の値を返すことができます。

ステージング書き込みを有効または無効にする

新しいロジック関数では、まもなくステージング書き込みがデフォルトで有効になります。AIP Logic の実行モードの設定にあるステージング書き込みモードを有効にするトグルを使用して、ロジック関数のステージング書き込みをオンまたはオフにできます。

ステージング書き込みを無効にすると、関数はレガシー動作に戻り、オントロジー編集のリストを出力として返すようになります。ワークフローが Automate のロジック効果からロジック関数を直接呼び出すことに依存している場合は、ステージング書き込みを無効にすることを検討してください。

モード切り替え時のバージョニング

ステージング書き込みの切り替えがバージョニングに与える影響は、関数の出力タイプによって異なります。

• 出力タイプがオントロジー編集のリストの場合： ステージング書き込みを有効または無効にすると、関数の新しいメジャーバージョンが公開されます。これは、ロジックの設定に応じて出力タイプが別のデータ型に変わるためです。アクションや Automate で設定されたバージョン範囲はメジャーバージョンの境界を越えないため、既存の利用側は以前に公開されたバージョンで引き続き実行され、自動的にはアップグレードされません。以下の既存の自動化を移行するを参照してください。
• 出力タイプがオントロジー編集のリストではない場合： ステージング書き込みを切り替えても出力タイプは変わらないため、メジャーバージョンは上がりません。既存の利用側で自動アップグレードが設定されている場合は、新しいバージョンが自動的に使用されます。

Automate でステージング書き込みを使用するロジック関数を使用する

ステージング書き込みを使用するロジック関数を Automate で使用するには、アクションタイプを通じて呼び出す必要があります。アクションは、編集がステージングされ、適用される実行コンテキストを提供します。

ロジック関数からアクションタイプを作成する

AIP Logic には、ステージング書き込みを使用するロジック関数向けにアクションを作成ボタンが用意されており、その関数を呼び出すアクションタイプを生成します。

1. AIP Logic ファイルで、使用状況タブに移動し、アクションを作成を選択します。
2. 生成されたアクションタイプを確認します。アクションのパラメーターは、ロジック関数の入力からマッピングされます。
3. アクションタイプを保存します。

その後、このアクションを Automate のアクション効果で使用したり、Workshop など、アクションに対応しているほかの場所で適用したりできます。

または、Ontology Manager で、既存のアクションタイプがロジック関数に基づくように設定することもできます。通常は、アクションを作成で新しいアクションタイプを作成する方が簡単です。

自動化を作成する

ステージング書き込みを使用するロジック関数の場合、アクションタイプを作成したら、Automate に移動してアクション効果を作成します。

Automate では、ほかのアクション効果と同様に、自動化をトリガーするオブジェクトや値からアクションのパラメーターを設定します。アクションを人によるレビューのための提案としてステージングする機能、再試行戦略、フォールバック効果など、アクション効果で利用可能なすべての Automate 機能は、ステージング書き込みを使用するロジック関数を呼び出すアクションでも機能します。

既存の自動化を移行する

自動化でロジック効果を通じてすでに直接使用されているロジック関数で、書き込みのステージングを有効にした場合：

• 自動化は、以前に公開された関数のレガシーメジャーバージョンに対して引き続き実行されます。書き込みのステージングを有効にしても、既存の自動化が動作しなくなることはありません。
• 自動化を、書き込みのステージングを使用する関数のメジャーバージョンに更新しようとすると、保存がブロックされます。これは、ロジック効果がレガシーロジック関数のみをサポートしているためです。
• Automate の互換性のあるバージョンへの自動アップグレード設定では、自動化が書き込みのステージングを使用するバージョンに移行することはありません。自動アップグレードでは、メジャーバージョンの境界を越えることがないためです。

既存の自動化を書き込みのステージングに移行するには、次の手順を実行します。

1. ロジック関数で書き込みのステージングを有効にし、公開します。関数の出力タイプがオントロジーの編集のリストである場合、新しいメジャーバージョンが作成されます。
2. AIP Logic で、使用状況タブのアクションを作成を選択して、関数からアクションタイプを生成します。
3. 自動化で、ロジック効果を、生成されたアクションを実行するアクション効果に置き換えます。
4. 自動化を保存します。