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

인터페이스

EditorData

개발자 포털에서 받을 모든 데이터가 포함된 JSON 개체

PortalData

개발자 포털에서 받은 위젯 인스턴스에 대한 정보

형식 별칭

DeployConfig

배포 함수를 구성하기 위한 선택적 옵션 개체입니다.

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

관리 패널의 양식에 대한 개발자 포털 "편집기"에 포함된 주 애플리케이션에 대한 가능한 대상 모듈 "앱"

ValuesCommon

obj 값의 기준

함수

askForSecrets(TargetModule)

비밀 요청 - 개발자 포털 부모 창에서 토큰 & userId입니다.

buildBlobConfigPath(string)

Blob Storage에서 위젯 구성에 대한 상대 경로 생성

buildBlobDataPath(string)

Blob Storage에서 위젯 데이터에 대한 상대 경로 생성

buildOnChange<Values>()

편집기에서 변경된 데이터를 보내는 데 사용할 수 있는 onChange 함수를 빌드합니다.

deployNodeJS(ServiceInformation, string, string, DeployConfig)

/dist 폴더에서 API Management DevPortals의 Blob Storage에 모든 항목을 배포합니다.

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_DATA_FOLDER

위젯 구현이 포함된 블롭 스토리지 폴더 이름

BLOB_ROOT

블롭 스토리지 폴더의 루트

함수 세부 정보

askForSecrets(TargetModule)

비밀 요청 - 개발자 포털 부모 창에서 토큰 & userId입니다.

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

매개 변수

targetModule
TargetModule

함수가 기본 "앱" 창 또는 관리자 "편집기"에서 호출되는가요?

반환

Promise<Secrets>

buildBlobConfigPath(string)

Blob Storage에서 위젯 구성에 대한 상대 경로 생성

function buildBlobConfigPath(name: string): string

매개 변수

name

string

위젯의 이름

반환

string

buildBlobDataPath(string)

Blob Storage에서 위젯 데이터에 대한 상대 경로 생성

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 Storage에 모든 항목을 배포합니다.

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

매개 변수

serviceInformation
ServiceInformation

배포에 대한 서비스 정보

name

string

배포할 위젯의 이름

fallbackConfigPath

string

구성 파일의 로컬 경로(기본적으로 "./static/config.msapim.json")

config
DeployConfig

선택적 구성 개체

반환

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

변경 내용을 보낼 개발자 포털의 웹 콘텐츠 원본(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_CONFIGS_FOLDER: "configs"

형식

"configs"

BLOB_DATA_FOLDER

위젯 구현이 포함된 블롭 스토리지 폴더 이름

BLOB_DATA_FOLDER: "data"

형식

"data"

BLOB_ROOT

블롭 스토리지 폴더의 루트

BLOB_ROOT: "custom-widgets"

형식

"custom-widgets"