はじめに

このチュートリアルでは、オントロジー編集関数を利用したアクションタイプの作成方法を説明します。

前提条件

このチュートリアルでは、アクション入門チュートリアルと同じ Demo Ticket オブジェクトタイプとサンプルオブジェクトを使用します。

まず、アクションで必要な編集を実行するオントロジー編集関数を作成します。そのためには、次の作業が必要です。

• オブジェクトに対する関数用の TypeScript テンプレートを使用してリポジトリを設定する。
• 関連するオブジェクトタイプをリポジトリにインポートする。
• アクションが読み取れるようにオントロジー編集関数を公開する。

これらの手順については、関数のドキュメントを参照してください。

• はじめに： このチュートリアルに従って、基本的な関数リポジトリを作成し、関数を公開します。
• オブジェクトに対する関数： このチュートリアルに従って、オブジェクトデータを使用する関数を作成します。
• オントロジー編集： このリファレンスを使用して、オントロジー編集関数を作成します。

オントロジー編集関数を作成して公開したら、以下の手順で関数をアクションに接続し、関数を使用してオブジェクトを編集できるようにします。このチュートリアルでは、リポジトリで次のオントロジー編集関数を作成し、公開しています。

利便性のため、コードを以下に掲載します。

Copied!
1
2
3
4
5
@OntologyEditFunction()
public addPriorityToTitle(ticket: DemoTicket): void {
    let newTitle: string = "[" + ticket.ticketPriority + "]" + ticket.ticketTitle;
    ticket.ticketTitle = newTitle;
}

関数を利用したアクションの作成

ルールセクションで、関数タイプのルールを 1 個追加します。前提条件で公開した関数を検索し、最新バージョンを選択します。以下のように、アクションのパラメーターに対応するよう入力を設定します。関数ルールを他のオントロジールールと組み合わせることはできません。

関数を選択すると、関数のすべての入力が自動的にパラメーターとして作成され、パラメータータブに追加されます。以下のスクリーンショットの例では、オブジェクト参照タイプの Demo Ticket パラメーターが作成されています。必要に応じて、このパラメーターをさらにカスタマイズできます。

アクションを保存し、他のアプリケーションとの統合に関するガイダンスに従って、プラットフォーム全体で使用できるように設定します。

関数のバージョンの変更

デフォルトでは、関数のロジックが変更されても、アクションはその変更に合わせて自動的に更新されません。アクションのルールセクションに戻り、アクションが参照する関数のバージョンをアップグレードする必要があります。たとえば、関数のバージョン 0.1.2 を公開した場合は、ここで更新する必要があります。

自動アップグレード

必要に応じて、アクションが参照する関数の自動アップグレードを有効にできます。有効にすると、アクションは関数のバージョン範囲に依存し、実行時にバージョンを解決します。

アクションの自動アップグレードを有効にするには、アクションのルールセクションに移動し、関数パラメーターを選択します。関数ドロップダウンで、実行する関数の最小バージョンを選択し、自動アップグレードオプションを有効にします。これにより、選択した最小バージョンに対して後方互換性のあるすべてのバージョン（マイナーアップグレードやパッチアップグレードなど）を含む、バージョン範囲の依存関係が設定されます。

セキュリティ

関数を利用したアクションで自動アップグレードを有効にすると、アクションの編集権限を持たないユーザーでも、そのアクションが利用する関数を変更することで、アクションの動作を変更できます。これは、関数の編集権限がアクションの権限と連動していないためです。

破壊的変更

自動アップグレードによって、不適切な関数リリースに含まれる破壊的変更が原因で、アクションの実行に失敗する可能性があります。

来歴

アクションの来歴は、選択した関数の最小バージョンの来歴に基づいて設定されます。関数の新しいリリースが、この来歴の範囲外の編集（たとえば、追加のオブジェクトタイプへの編集）を返す場合、アクションの実行に失敗します。現在、来歴に含まれるのは、アクションが実行時に編集する可能性のあるオブジェクトタイプのみです。