@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(예: |
| TargetModule |
관리 패널의 양식에 대한 개발자 포털 "편집기"에 포함된 주 애플리케이션에 대한 가능한 대상 모듈 "앱" |
| ValuesCommon |
obj 값의 기준 |
함수
| ask |
비밀 요청 - 개발자 포털 부모 창에서 토큰 & userId입니다. |
| build |
Blob Storage에서 위젯 구성에 대한 상대 경로 생성 |
| build |
Blob Storage에서 위젯 데이터에 대한 상대 경로 생성 |
| build |
편집기에서 변경된 데이터를 보내는 데 사용할 수 있는 onChange 함수를 빌드합니다. |
| deploy |
/dist 폴더에서 API Management DevPortals의 Blob Storage에 모든 항목을 배포합니다. |
| 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_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"