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

applyTheme({[varName: string]: string})

Témaváltozók alkalmazása az aktuális dokumentumra

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.

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" }
});
getAccessToken()

Hozzáférési jogkivonat lekérése, amely lehetővé teszi a hívásokat más DevOps-szolgáltatásokba

getAppToken()

Jogkivonat lekérése, amely az aktuális felhasználó azonosítására használható

getConfiguration()

A kezdeti kézfogásban átadott konfigurációs adatok lekérése a szülőkeretből

getContributionId()

Lekéri a bővítmény betöltését először okozó hozzájárulással kapcsolatos információkat.

getExtensionContext()

Az üzemeltetett tartalom tulajdonosaként működő bővítmény kontextusának lekérése

getHost()

Információt kap arról a gazdagépről (például egy Azure DevOps-szervezetről), amelyet az oldal megcéloz

getPageContext()

A gazdagépoldal környezetének lekérése

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.

getTeamContext()

A lap által megcélzott csapat adatainak lekérdezése

getUser()

Az aktuális felhasználóval kapcsolatos információk lekérdezése

getWebContext()

A webes környezet lekérése

init(IExtensionInitOptions)

Elindítja a kézfogást a gazdagép ablakával.

notifyLoadFailed(string | Error)

Értesíti a gazdagépet, hogy a bővítmény betöltése nem sikerült

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)

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

sdkVersion

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