注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

VS Code の操作

VS Code ワークスペースと Palantir extension for Visual Studio Codeを使用すると、エディターを離れることなく、リソースのインポート、関数のプレビュー、ブランチの管理、変更のコミットと公開、リポジトリのアップグレード、ローカル開発ツールの使用ができます。

リソースを関数リポジトリにインポートする

関数で Foundry リソースを使用する前に、リポジトリにインポートします。

オントロジーとプラットフォームのリソースをインポートする

  1. VS Code のアクティビティバーで、下向き矢印で表されるリソースのインポートアイコンを選択します。
  2. リソースパネルで、インポートするリソースに応じて、オントロジー SDK またはプラットフォームタブを選択します。
  3. 追加を選択し、オブジェクトタイプ、インターフェース、アクション、クエリ関数などのリソースの種類を選択します。ソースをインポートするには、ソースをインポートするの手順に従います。
  4. 使用するリソースを検索して選択し、選択内容を確認します。
  5. コード内でリソースを参照する前に、コード生成と依存関係のインストールが完了するまで待ちます。
VS Code でリソースのインポートアイコンが選択され、リソースパネルに利用可能なオントロジー SDK のリソースの種類が表示されています。

利用可能な最新のリソースの種類を取得するには、リポジトリのアップグレードでリポジトリを最新の状態にしてください。オントロジーのタイプのインポートについて、詳しくはこちら。

ソースをインポートする

ソースをインポートするには、事前に追加の設定が必要です。Data Connection でソースの接続設定セクションを開き、エクスポートを有効にして、コードリポジトリへのソースのインポートを許可します。

ソースを設定すると、リポジトリで使用できます。VS Code のリソースのインポートパネルで、追加 > ソースを選択して選択ダイアログを開きます。このダイアログでは、現在のリポジトリで使用が有効になっているソースのみを検索して選択できます。目的のソースがこのダイアログに見つからない場合は、フッターの外部システムリンクをクリックします。このリンクを開くとリポジトリ設定が表示され、リポジトリで使用を有効にするソースを設定できます。

外部システムの設定ページで追加メニューが展開され、既存の接続と新規作成の選択肢が表示されています。
  1. リポジトリにソースを追加したら、VS Code ワークスペースに戻り、リソースのインポートを変更ダイアログで結果を再読み込みを選択します。
  2. 使用するソースを追加します。ソースはリソースのインポートサイドパネルに表示され、そこでエイリアスを設定できます。
  3. 関数内でエイリアスを使ってソースを参照します。ソースのエイリアスについて、詳しくはこちら。

関数からの API 呼び出しについてはこちら、Webhook の使用についてはこちらで詳しく説明しています。

Palantir 拡張機能で開発して公開する

アクティビティバーで Palantir アイコンを選択して、Palantir パネルを開きます。このパネルでは、ブランチ、プレビュー、コミット、公開、リポジトリ管理の操作を行えます。

Palantir 拡張機能のパネルに、ブランチのコントロールと、関数のプレビュー、変更のコミットと提案、バージョンのタグ付け、リポジトリのアップグレードの操作が表示されています。

ブランチを作成または切り替える

編集を始める前に、ブランチセクションでブランチを作成または切り替えます。

  1. コードまたはグローバルタブを選択します。
    • コードブランチは、コードリポジトリ内の変更を管理する基盤となる Git ブランチです。
    • グローバルブランチには、サポートされている複数の Foundry アプリケーションとリソースにまたがる関連した変更を含めることができます。
  2. プラス記号付きのブランチで表されるブランチ作成アイコンを選択します。
  3. 新しいブランチの名前を入力し、確認して作成します。

グローバルブランチのサポートは、関数の言語とリポジトリの設定によって異なります。VS Code でのブランチ操作、Code Repositories のブランチオプション、グローバルブランチでの関数の開発と公開について、各リンク先で詳しく説明しています。

関数をプレビューする

  1. Palantir パネルで、関数プレビューを選択します。
  2. 関数を選択して入力値を指定し、実行をクリックして、指定した入力値でコードを実行します。
  3. コードの実行中に、出力、ログ、編集内容などを確認します。これにより、関数のデバッグとテストを行えます。

グローバルブランチで開発している場合、プレビューは Palantir パネルで現在選択されているブランチに対して実行されます。ライブプレビューでの関数のテストについて、詳しくはこちら。

変更をコミット、提案し、タグ付けする

プレビューとテストが成功したら、次の手順を実行します。

  1. 変更セクションでコミットを選択し、変更されたファイルを確認して、内容がわかるコミットメッセージを入力します。
  2. マージ前にコードレビューが必要な場合は、変更を提案を選択します。
  3. タグ付けするを選択してバージョンを選び、選択したブランチの関数を公開します。

タグ付けをすると、最後に編集した関数だけでなく、リポジトリ内のすべての関数が公開されます。

関数の公開と関数のバージョン管理について、各リンク先で詳しく説明しています。

リポジトリをアップグレードする

変更セクションでアップグレードを選択して、リポジトリのアップグレードを開始します。生成された変更を確認し、テストと関数のプレビューを再度実行してから、アップグレードをコミットします。リポジトリの自動および手動アップグレードについて、詳しくはこちら。

VS Code のヒントとコツ

以下のセクションでは、関数開発を効率化できる VS Code の任意の機能とショートカットについて説明します。

関数プロジェクトから npm コマンドを実行する

統合ターミナルを開き、関数プロジェクトの package.json ファイルが含まれる functions-typescript ディレクトリに移動します。TypeScript v1 と TypeScript v2 の関数リポジトリでは、同じパスを使用します。

Copied!
1 2 cd functions-typescript npm test

npm run を実行すると、現在のプロジェクトで利用可能なスクリプトが一覧表示されます。付属のテストフレームワークの詳細については、関数のユニットテストを参照してください。

保存時に書式を設定する

設定を開き、format on save を検索して、エディター:保存時に書式設定を有効にします。Cmd+S(macOS)または Ctrl+S(Windows/Linux)を押すと、現在のファイルが保存され、設定済みのフォーマッターが実行されます。コマンドパレットからドキュメントのフォーマットを実行することもできます。

VS Code の書式設定について詳しくはこちら ↗。

AI 開発ツールを使用する

Palantir MCP はデフォルトで VS Code ワークスペースに統合されており、TypeScript 関数リポジトリ向けのコンテキストツールを提供します。これにより、Continue 拡張機能は関数コード、インポートされたオントロジーリソース、および Foundry のコンテキストを参照できます。

VS Code ワークスペースの AI 開発ツールおよび Palantir MCP について詳しくはこちら。

組み込みのナビゲーションと編集のショートカットを使用する

VS Code には、コンテキストの切り替えを減らせるショートカットが用意されています。

操作macOSWindows/Linux
コマンドパレットを開くCmd+Shift+PCtrl+Shift+P
ファイルをすばやく開くCmd+PCtrl+P
リポジトリ全体を検索するCmd+Shift+FCtrl+Shift+F
現在のファイル内のシンボルに移動するCmd+Shift+OCtrl+Shift+O
シンボルの定義に移動するF12F12
シンボルへの参照を検索するShift+F12Shift+F12
シンボルの名前を変更し、その参照を更新するF2F2
利用可能なクイックフィックスを表示するCmd+.Ctrl+.

クイックオープンで、myFunction.ts:42 のようにファイル名の後にコロンと行番号を追加すると、その行に直接移動できます。また、Option(macOS)または Alt(Windows/Linux)を押しながら位置を選択すると、複数のカーソルを追加し、繰り返し現れるコードを同時に編集できます。完全な一覧については、VS Code のデフォルトのキーボードショートカット ↗ を参照してください。