@azure/api-management-custom-widgets-tools package

インターフェイス

EditorData

開発ポータルから受け取るすべてのデータを含む JSON オブジェクト

PortalData

Dev Portal から受信したウィジェット インスタンスに関する情報

型エイリアス

DeployConfig

デプロイ関数を構成するためのオプション の options オブジェクト。

Environment

使用可能なすべてのランタイム環境

OnChange

onChange 関数の型。

Secrets

Dev Portal バックエンドやその他のランタイム データとの通信に必要なシークレット

ServiceInformation

resourceId - API Management サービス "subscriptions/[subscription-id]/resourceGroups/[resource-group-name]/providers/Microsoft.ApiManagement/service/[service-name]" managementApiEndpoint のリソース ID - プロトコルを使用した URL (例: https://management.azure.com) apiVersion - 既定値をオーバーライドする省略可能 (例: "2019-01-01") tokenOverride - 省略可能。'az login' アプローチではなく、認証に使用するトークンを提供します

TargetModule

管理パネルのフォーム用の Dev Portal の "エディター" に埋め込まれているメイン アプリケーションに対して可能なターゲット モジュール "app"

ValuesCommon

値の基数 obj

関数

askForSecrets(TargetModule)

Dev portal の親ウィンドウからシークレットを要求する - userId & トークン。

buildBlobConfigPath(string)

BLOB ストレージ上のウィジェットの構成の相対パスを生成する

buildBlobDataPath(string)

BLOB ストレージ上のウィジェットのデータの相対パスを生成する

buildOnChange<Values>()

エディターから変更されたデータを送信するために使用できる onChange 関数をビルドします。

deployNodeJS(ServiceInformation, string, string, DeployConfig)

/dist フォルダーから API Management DevPortals の BLOB ストレージにすべてをデプロイします。

getEditorValues<Values>()

管理エディター ウィンドウで設定した値を取得する関数。

getValues<Values>(Values)

管理エディター ウィンドウで設定した値を取得する関数。 未定義/空の値は既定値に置き換えられます。

getWidgetData<Values>()

ほとんどの場合、必要とされない技術的な値を含む、ウィジェットに関連するすべてのデータを取得する関数。 主に内部使用を目的としているため、API が変更される可能性があります。 代わりに getValues または getEditorValues を使用することを検討してください。

onChangeWithOrigin<Values>(string, string, Values)

パラメーターとして指定された 'origin' を持つ onChange 関数自体。

変数

APIM_ASK_FOR_SECRETS_MESSAGE_KEY

投稿メッセージオブジェクトのキーで、DevPortalからトークンやユーザーIDなどの秘密を要求・送信します。 他のアプリケーションとの干渉を防ぐために使用されます。

APIM_CONFIG_FILE_NAME

設定ファイル名

APIM_EDITOR_DATA_KEY

検索パラメータのキーで、そこからエディターデータが読み込まれます。

APIM_ON_CHANGE_MESSAGE_KEY

投稿メッセージオブジェクトの鍵として、編集者からDevPortalへの変更伝播に使われます。 他のアプリケーションとの干渉を防ぐために使用されます。

BLOB_CONFIGS_FOLDER

ウィジェット設定を含むBLOBストレージフォルダの名前

BLOB_DATA_FOLDER

ウィジェット実装を含むBLOBストレージフォルダの名前

BLOB_ROOT

BLOBストレージフォルダのルート

関数の詳細

askForSecrets(TargetModule)

Dev portal の親ウィンドウからシークレットを要求する - userId & トークン。

function askForSecrets(targetModule: TargetModule): Promise<Secrets>

パラメーター

targetModule
TargetModule

関数はメインの "アプリ" ウィンドウまたは管理者の "エディター" から呼び出されますか?

戻り値

Promise<Secrets>

buildBlobConfigPath(string)

BLOB ストレージ上のウィジェットの構成の相対パスを生成する

function buildBlobConfigPath(name: string): string

パラメーター

name

string

ウィジェットの名前

戻り値

string

buildBlobDataPath(string)

BLOB ストレージ上のウィジェットのデータの相対パスを生成する

function buildBlobDataPath(name: string): string

パラメーター

name

string

ウィジェットの名前

戻り値

string

buildOnChange<Values>()

エディターから変更されたデータを送信するために使用できる onChange 関数をビルドします。

function buildOnChange<Values>(): OnChange<Values>

戻り値

OnChange<Values>

deployNodeJS(ServiceInformation, string, string, DeployConfig)

/dist フォルダーから API Management DevPortals の BLOB ストレージにすべてをデプロイします。

function deployNodeJS(serviceInformation: ServiceInformation, name: string, fallbackConfigPath?: string, config?: DeployConfig): Promise<void>

パラメーター

serviceInformation
ServiceInformation

デプロイのサービス情報

name

string

デプロイするウィジェットの名前

fallbackConfigPath

string

構成ファイルへのローカル パス (既定では "./static/config.msapim.json")

config
DeployConfig

省略可能な config オブジェクト

戻り値

Promise<void>

getEditorValues<Values>()

管理エディター ウィンドウで設定した値を取得する関数。

function getEditorValues<Values>(): Partial<Values>

戻り値

Partial<Values>

getValues<Values>(Values)

管理エディター ウィンドウで設定した値を取得する関数。 未定義/空の値は既定値に置き換えられます。

function getValues<Values>(valuesDefault: Values): Values

パラメーター

valuesDefault

Values

使用する既定値を持つオブジェクトvalues.tsフォルダーから valuesDefault オブジェクトをインポートするだけです

戻り値

Values

getWidgetData<Values>()

ほとんどの場合、必要とされない技術的な値を含む、ウィジェットに関連するすべてのデータを取得する関数。 主に内部使用を目的としているため、API が変更される可能性があります。 代わりに getValues または getEditorValues を使用することを検討してください。

function getWidgetData<Values>(): EditorData<Values>

戻り値

EditorData<Values>

onChangeWithOrigin<Values>(string, string, Values)

パラメーターとして指定された 'origin' を持つ onChange 関数自体。

function onChangeWithOrigin<Values>(origin: string, instanceId: string, values: Values)

パラメーター

origin

string

変更を送信する Dev Portal の Web コンテンツの配信元 (URL)

instanceId

string

ウィジェットのこの特定のインスタンスの ID

values

Values

変更された値

Variable Details

APIM_ASK_FOR_SECRETS_MESSAGE_KEY

投稿メッセージオブジェクトのキーで、DevPortalからトークンやユーザーIDなどの秘密を要求・送信します。 他のアプリケーションとの干渉を防ぐために使用されます。

APIM_ASK_FOR_SECRETS_MESSAGE_KEY: "askForSecretsMSAPIM"

"askForSecretsMSAPIM"

APIM_CONFIG_FILE_NAME

設定ファイル名

APIM_CONFIG_FILE_NAME: "config.msapim.json"

"config.msapim.json"

APIM_EDITOR_DATA_KEY

検索パラメータのキーで、そこからエディターデータが読み込まれます。

APIM_EDITOR_DATA_KEY: "editorData"

"editorData"

APIM_ON_CHANGE_MESSAGE_KEY

投稿メッセージオブジェクトの鍵として、編集者からDevPortalへの変更伝播に使われます。 他のアプリケーションとの干渉を防ぐために使用されます。

APIM_ON_CHANGE_MESSAGE_KEY: "customInputValueChangedMSAPIM"

"customInputValueChangedMSAPIM"

BLOB_CONFIGS_FOLDER

ウィジェット設定を含むBLOBストレージフォルダの名前

BLOB_CONFIGS_FOLDER: "configs"

"configs"

BLOB_DATA_FOLDER

ウィジェット実装を含むBLOBストレージフォルダの名前

BLOB_DATA_FOLDER: "data"

"data"

BLOB_ROOT

BLOBストレージフォルダのルート

BLOB_ROOT: "custom-widgets"

"custom-widgets"