注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
ソースエイリアスは、Data Connection ソースへの、名前付きの移植可能な参照です。特定のソース識別子ではなくエイリアスキーでソースを参照することで、関数のロジックを特定のソースから切り離せます。これにより、関数を環境間で移植できるようになります。
Code Workspaces を使用して VS Code で開発している場合は、代わりに VS Code でソースをインポートする手順に沿って進めてください。
ソースをインポートするには、次の手順を実行します。
TypeScript v2 または Python のコードリポジトリを開き、リソースのインポートパネルに移動します。
オントロジー SDK タブを選択します。
追加 > ソースを選択します。

インポートするソースを検索して選択し、選択を確定を選択します。
ソースをインポートした後、そのソースにエイリアスを追加できます。
リソースのインポートパネルのソースで、対象のソースを見つけます。
ソース名の下にあるエイリアスを追加を選択します。

エイリアスキーはリポジトリ内で一意である必要があります。
既存のソースエイリアスを編集するには、リソースのインポートパネルのソースセクションに移動します。エイリアスの横にあるペンアイコンを選択して、インラインで編集します。

関数でソースエイリアスを使用するには、ソースを宣言および取得するすべての箇所で、キーを使用してエイリアスを参照します。エイリアスキーを sources 設定と、getSource (TypeScript v2) または get_source (Python) に渡します。
Copied!1 2 3 4 5 6 7 8 9 10 11 12 13 14 15import { getSource, getHttpsConnection, getFetch } from "@palantir/functions-sources"; export const config = { sources: ["demoSource"] } async function myExternalFunction(): Promise<string> { const source = await getSource("demoSource"); const { url } = getHttpsConnection(source); const fetch = await getFetch(source); const response = await fetch(url); return response.text(); }
Copied!1 2 3 4 5 6 7 8 9 10 11from functions.api import function from functions.sources import get_source @function(sources=["demoSource"]) def my_external_function() -> str: source = get_source("demoSource") url = source.get_https_connection().url client = source.get_https_connection().get_client() response = client.get(url) return response.text
エイリアスが解決されるソースのリソース識別子 (RID) が必要な場合は、TypeScript v2 の Aliases.source ユーティリティ、または Python の source ユーティリティを使用します。解決された RID を .rid プロパティから読み取ります。
Copied!1 2 3import { Aliases } from "@osdk/functions"; const sourceRid = Aliases.source("demoSource").rid;
Copied!1 2 3from functions.aliases import source source_rid = source("demoSource").rid
資格情報へのアクセスや事前設定済みクライアントの使用など、関数でのソースの使用について詳しくは、関数から API を呼び出すをご覧ください。
ソースエイリアスを使用する関数を Marketplace 製品に追加すると、エイリアスが設定された各ソースが、Data Connection ソースの下に設定可能な入力として表示されます。インストール担当者は、関数のソースコードを変更することなく、インストール時に各入力ソースを環境内で利用可能なソースにマッピングできます。

インストール担当者が指定すべきソースを理解できるように、ソース入力に説明を追加できます。入力の下にあるソースを選択して詳細パネルを開き、全般タブで説明を入力します。

インストール時には、インストール担当者にソースの説明が表示され、環境に適したソースを選択できます。Marketplace は選択されたソースを定義済みのエイリアスに自動的に再マッピングするため、関数のコードは変更されません。
