@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 (例: |
| TargetModule |
管理パネルのフォーム用の Dev Portal の "エディター" に埋め込まれているメイン アプリケーションに対して可能なターゲット モジュール "app" |
| ValuesCommon |
値の基数 obj |
関数
| ask |
Dev portal の親ウィンドウからシークレットを要求する - userId & トークン。 |
| build |
BLOB ストレージ上のウィジェットの構成の相対パスを生成する |
| build |
BLOB ストレージ上のウィジェットのデータの相対パスを生成する |
| build |
エディターから変更されたデータを送信するために使用できる onChange 関数をビルドします。 |
| deploy |
/dist フォルダーから API Management DevPortals の BLOB ストレージにすべてをデプロイします。 |
| get |
管理エディター ウィンドウで設定した値を取得する関数。 |
| get |
管理エディター ウィンドウで設定した値を取得する関数。 未定義/空の値は既定値に置き換えられます。 |
| get |
ほとんどの場合、必要とされない技術的な値を含む、ウィジェットに関連するすべてのデータを取得する関数。 主に内部使用を目的としているため、API が変更される可能性があります。 代わりに getValues または getEditorValues を使用することを検討してください。 |
| on |
パラメーターとして指定された '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"