TypeScript v2 関数のはじめに

TypeScript v2 では、Node.js ランタイムやオントロジー SDK のファーストクラスサポートなど、TypeScript v1 からの主な改善点を活用できます。はじめるには、以下のセクションを確認してください。

TypeScript v2 関数のリポジトリを作成する

任意のプロジェクトに移動し、+ 新規 > リポジトリを選択して、新しいコードリポジトリを作成します。TypeScript v2 関数のテンプレートを選択して、リポジトリを初期化します。

リポジトリが作成されたら、typescript-functions/src/functions/helloWorld.ts ファイルに移動します。

オントロジーのタイプを関数にインポートするには、まずリソースのインポートサイドバーからオブジェクトタイプとリンクタイプを追加し、その後オントロジー SDK を生成してインストールします。これらの手順については、オントロジー SDK を生成するを参照してください。

関数を記述する

新しい関数を記述するには、リポジトリの typescript-functions/src/functions ディレクトリに新しいファイルを作成し、helloWorld.ts などの内容がわかる名前を付けます。Foundry が関数を検出できるように、export default を使用して関数を記述します。

Copied!
1
2
3
export default function helloWorld(): string {
    return "Hello World!";
}

関数を Foundry に公開するには、次の条件を満たす必要があります。

1. typescript-functions/src/functions ディレクトリ内の .ts ファイルに関数を定義します。このディレクトリでは、関連する関数をサブディレクトリにまとめることもできます。
2. ファイル名は関数名と一致する必要があります。myFunction という関数を公開するには、typescript-functions/src/functions ディレクトリ内の myFunction.ts というファイルに定義する必要があります。
3. TypeScript 関数は、そのファイルのデフォルトエクスポートである必要があります。
4. 関数の入力と出力のデータ型は、データ型リファレンスに詳述されている、サポート対象の関数のデータ型に従う必要があります。

関数のファイルパスは、そのファイルから公開される関数を一意に識別するために使用されるため、ファイルパスを変更すると新しい関数が公開されます。

ライブプレビューでテストする

ライブプレビューで関数をテストするには、関数ヘルパーを開き、ライブプレビューを選択します。関数を選択し、実行を選択して実行します。

関数をコミットして公開する

ウィンドウの右上にあるコミットを選択して、変更をリポジトリの master ブランチにコミットします。関数のチェックを表示するには、ページ上部のチェックタブを開きます。コミット後、ここに実行中のチェックが表示されるはずです。

作業内容をコミットすると、タグ付けするオプションが表示されます。この操作により、リポジトリ内のすべての関数が公開されます。

タグ付けするを選択して、master ブランチからのリリースにタグを付けます。変更の規模に基づいてタグ名を設定し、タグとリリースを選択します。

関数のタグ付けとリリースの進行状況を表示するには、表示ポップアップを選択するか、タグタブに移動します。ステップ2：リリースが完了したら、公開済みの関数を選択して関数レジストリで表示します。

新しい関数を使用する

タグのチェックが成功したら、Code Repositories のコードタブに戻り、関数ヘルパーを選択します。これで、公開済みセクションに関数が表示されるはずです。関数を選択し、新しい関数を実行します。

次のステップ

基本的な関数を作成して公開したら、次の機能を探索してください。

• オントロジー SDK： オントロジーのオブジェクトをクエリまたは編集するには、まず必要なオブジェクトタイプとリンクタイプをインポートし、その後オントロジー SDK を生成してインストールします。
• オントロジー編集： 関数内でオブジェクトを作成、更新、削除する方法を学びます。
• ステージングされた書き込み [ベータ版]： 書き込み後の読み取りの保証やネストされた関数呼び出しが必要な編集関数については、ステージングされた書き込みを参照してください。