azure-devops-extension-sdk package
Interfészek
| ContextIdentifier | |
| GlobalizationContext | |
| IExtensionContext |
Az aktuális bővítmény azonosítója |
| IExtensionInitOptions |
Bővítmény inicializálásának lehetőségei – átadva a DevOps.init() számára |
| IHostContext |
Információk az aktuális DevOps-gazdagépről (szervezet) |
| IPageContext |
Az egyes weblapokon elhelyezett globális környezet |
| ITeamContext |
Információk az aktuális DevOps-csapatról |
| IUserContext |
Információk az aktuális felhasználóról |
Enumerációk
| HostType |
DevOps-gazdagép szintje |
Függvények
| apply |
Témaváltozók alkalmazása az aktuális dokumentumra |
| disable |
Letiltja a Nested App Authentication hidat. E hívás után minden MSAL token kérés hibát kap |
| enable |
Engedélyezze a Nested App Authentication (NAA) használatát ehhez a kiegészítéshez. Úgy állít be Ezt nevezd el MSAL instance létrehozása Példa
|
| get |
Hozzáférési jogkivonat lekérése, amely lehetővé teszi a hívásokat más DevOps-szolgáltatásokba |
| get |
Jogkivonat lekérése, amely az aktuális felhasználó azonosítására használható |
| get |
A kezdeti kézfogásban átadott konfigurációs adatok lekérése a szülőkeretből |
| get |
Lekéri a bővítmény betöltését először okozó hozzájárulással kapcsolatos információkat. |
| get |
Az üzemeltetett tartalom tulajdonosaként működő bővítmény kontextusának lekérése |
| get |
Információt kap arról a gazdagépről (például egy Azure DevOps-szervezetről), amelyet az oldal megcéloz |
| get |
A gazdagépoldal környezetének lekérése |
| get |
Kérje le a hozzájárulást a megadott hozzájárulási azonosítóval. A visszaadott hozzájárulásnak van egy metódusa, amellyel be lehet szerezni egy regisztrált objektumot a hozzájáruláson belül. |
| get |
A lap által megcélzott csapat adatainak lekérdezése |
| get |
Az aktuális felhasználóval kapcsolatos információk lekérdezése |
| get |
A webes környezet lekérése |
| init(IExtension |
Elindítja a kézfogást a gazdagép ablakával. |
| notify |
Értesíti a gazdagépet, hogy a bővítmény betöltése nem sikerült |
| notify |
Értesíti a gazdagépet, hogy a bővítmény sikeresen be lett töltve (a betöltésjelző megjelenítésének leállítása) |
| ready() | Regisztráljon egy visszahívást, amely a kezdeti beállítás/kézfogás befejeződése után lesz meghívva. Ha a kezdeti beállítás már befejeződött, a rendszer meghívja a visszahívást az aktuális hívásverem végén. |
| register<T>(string, T) | Regisztráljon egy objektumot (példányt vagy gyári metódust), amelyet ez a bővítmény elérhetővé tesz a gazdagépkeret számára. |
| resize(number, number) | Kéri a szülőablakot, hogy méretezze át a tárolót ehhez a bővítményhez az aktuális bővítményméret alapján. |
| unregister(string) | Eltávolít egy objektumot, amelyet ez a bővítmény elérhetővé téve van a gazdagépkeretnek. |
Változók
| sdk |
Web SDK verziószám. Megadhatók egy kiterjesztés követelménykészletében, például: vss-sdk-version/4.2 |
Függvény adatai
applyTheme({[varName: string]: string})
Témaváltozók alkalmazása az aktuális dokumentumra
function applyTheme(themeData: {[varName: string]: string})
Paraméterek
- themeData
-
{[varName: string]: string}
disableNestedAppAuth()
Letiltja a Nested App Authentication hidat. E hívás után minden MSAL token kérés hibát kap BridgeDisabled . A híd objektum továbbra is bekapcsolt window.nestedAppAuthBridge , így a meglévő MSAL hallgatók nem maradnak árvákba. Hívás enableNestedAppAuth() , hogy újra aktiváld.
function disableNestedAppAuth()
enableNestedAppAuth()
Engedélyezze a Nested App Authentication (NAA) használatát ehhez a kiegészítéshez.
Úgy állít bewindow.nestedAppAuthBridge, hogy a MSAL-ok createNestablePublicClientApplication a token beszerzést delegálhassák az Azure DevOps host keretre. Ez elkerüli a cross-origin BroadcastChannel problémákat, amelyek blokkolják a felugró ablakos hitelesítést az iframe-ekben.
Ezt nevezd el MSAL instance létrehozása init() után és előtt.
Ehhez a hoszt számára engedélyezve kell a NAA támogatás.
Példa
await SDK.init();
await SDK.enableNestedAppAuth();
const pca = await createNestablePublicClientApplication({
auth: { clientId: "your-entra-client-id" }
});
function enableNestedAppAuth(): Promise<void>
Válaszok
Promise<void>
Egy ígéret, amely akkor oldódik, amikor a híd készen áll, vagy elutasítják, ha a gazdagép nem támogatja a NAA-t.
getAccessToken()
Hozzáférési jogkivonat lekérése, amely lehetővé teszi a hívásokat más DevOps-szolgáltatásokba
function getAccessToken(): Promise<string>
Válaszok
Promise<string>
getAppToken()
Jogkivonat lekérése, amely az aktuális felhasználó azonosítására használható
function getAppToken(): Promise<string>
Válaszok
Promise<string>
getConfiguration()
A kezdeti kézfogásban átadott konfigurációs adatok lekérése a szülőkeretből
function getConfiguration(): {[key: string]: any}
Válaszok
{[key: string]: any}
getContributionId()
Lekéri a bővítmény betöltését először okozó hozzájárulással kapcsolatos információkat.
function getContributionId(): string
Válaszok
string
getExtensionContext()
Az üzemeltetett tartalom tulajdonosaként működő bővítmény kontextusának lekérése
function getExtensionContext(): IExtensionContext
Válaszok
getHost()
Információt kap arról a gazdagépről (például egy Azure DevOps-szervezetről), amelyet az oldal megcéloz
function getHost(): IHostContext
Válaszok
getPageContext()
A gazdagépoldal környezetének lekérése
function getPageContext(): IPageContext
Válaszok
getService<T>(string)
Kérje le a hozzájárulást a megadott hozzájárulási azonosítóval. A visszaadott hozzájárulásnak van egy metódusa, amellyel be lehet szerezni egy regisztrált objektumot a hozzájáruláson belül.
function getService<T>(contributionId: string): Promise<T>
Paraméterek
- contributionId
-
string
A beolvasáshoz megadott hozzájárulás azonosítója
Válaszok
Promise<T>
getTeamContext()
A lap által megcélzott csapat adatainak lekérdezése
function getTeamContext(): ITeamContext
Válaszok
getUser()
Az aktuális felhasználóval kapcsolatos információk lekérdezése
function getUser(): IUserContext
Válaszok
getWebContext()
A webes környezet lekérése
function getWebContext(): IWebContext
Válaszok
IWebContext
init(IExtensionInitOptions)
Elindítja a kézfogást a gazdagép ablakával.
function init(options?: IExtensionInitOptions): Promise<void>
Paraméterek
- options
- IExtensionInitOptions
A bővítmény inicializálási beállításai.
Válaszok
Promise<void>
notifyLoadFailed(string | Error)
Értesíti a gazdagépet, hogy a bővítmény betöltése nem sikerült
function notifyLoadFailed(e: string | Error): Promise<void>
Paraméterek
- e
-
string | Error
Válaszok
Promise<void>
notifyLoadSucceeded()
Értesíti a gazdagépet, hogy a bővítmény sikeresen be lett töltve (a betöltésjelző megjelenítésének leállítása)
function notifyLoadSucceeded(): Promise<void>
Válaszok
Promise<void>
ready()
Regisztráljon egy visszahívást, amely a kezdeti beállítás/kézfogás befejeződése után lesz meghívva. Ha a kezdeti beállítás már befejeződött, a rendszer meghívja a visszahívást az aktuális hívásverem végén.
function ready(): Promise<void>
Válaszok
Promise<void>
register<T>(string, T)
Regisztráljon egy objektumot (példányt vagy gyári metódust), amelyet ez a bővítmény elérhetővé tesz a gazdagépkeret számára.
function register<T>(instanceId: string, instance: T)
Paraméterek
- instanceId
-
string
a regisztrált objektum egyedi azonosítója
- instance
-
T
Vagy: (1) objektumpéldány, vagy (2) olyan függvény, amely opcionális környezeti adatokat vesz fel, és egy objektumpéldányt ad vissza.
resize(number, number)
Kéri a szülőablakot, hogy méretezze át a tárolót ehhez a bővítményhez az aktuális bővítményméret alapján.
function resize(width?: number, height?: number)
Paraméterek
- width
-
number
Nem kötelező szélesség, alapértelmezés szerint scrollWidth
- height
-
number
Nem kötelező magasság, alapértelmezett érték a scrollHeighthoz
unregister(string)
Eltávolít egy objektumot, amelyet ez a bővítmény elérhetővé téve van a gazdagépkeretnek.
function unregister(instanceId: string)
Paraméterek
- instanceId
-
string
a regisztrált objektum egyedi azonosítója
Változó részletei
sdkVersion
Web SDK verziószám. Megadhatók egy kiterjesztés követelménykészletében, például: vss-sdk-version/4.2
sdkVersion: 5
Típus
5