azure-devops-extension-sdk package
インターフェイス
| ContextIdentifier | |
| GlobalizationContext | |
| IExtensionContext |
現在の拡張機能の識別子 |
| IExtensionInitOptions |
拡張機能の初期化のオプション -- DevOps.init() に渡される |
| IHostContext |
現在の DevOps ホスト (組織) に関する情報 |
| IPageContext |
各 Web ページに配置されたグローバル コンテキスト |
| ITeamContext |
現在の DevOps チームに関する情報 |
| IUserContext |
現在のユーザーに関する情報 |
列挙型
| HostType |
DevOps ホスト レベル |
関数
| apply |
現在のドキュメントにテーマ変数を適用します |
| disable |
ネストされたアプリ認証ブリッジを無効にします。 この呼び出しの後、MSALトークン要求はすべての |
| enable |
この拡張機能でネストアプリ認証(NAA)を有効にしてください。 MSALの これをMSALインスタンスを作成する前に 例
|
| get |
他の DevOps サービスへの呼び出しを許可するアクセス トークンをフェッチする |
| get |
現在のユーザーを識別するために使用できるトークンをフェッチする |
| get |
親フレームから初期ハンドシェイクで渡された構成データを取得する |
| get |
この拡張機能が読み込まれる原因となったコントリビューションに関する情報を取得します。 |
| get |
ホストされているコンテンツを所有する拡張機能に関するコンテキストを取得する |
| get |
ページが対象としているホスト (つまり Azure DevOps 組織) に関する情報を取得します。 |
| get |
ホスト ページに関するコンテキストを取得する |
| get |
指定されたコントリビューション ID を使用してコントリビューションを取得します。返されるコントリビューションには、そのコントリビューション内の登録済みオブジェクトを取得するメソッドがあります。 |
| get |
ページが対象としているチームに関する情報を取得します |
| get |
現在のユーザーに関する情報を取得します |
| get |
Web に関するコンテキストを取得する |
| init(IExtension |
ホスト ウィンドウでハンドシェイクを開始します。 |
| notify |
拡張機能の読み込みに失敗したことをホストに通知します |
| notify |
拡張機能が正常に読み込まれたことをホストに通知します (読み込みインジケーターの表示を停止します) |
| ready() | 初期セットアップ/ハンドシェイクが完了したら呼び出されるコールバックを登録します。 初期セットアップが既に完了している場合は、現在の呼び出し履歴の最後にコールバックが呼び出されます。 |
| register<T>(string, T) | この拡張機能がホスト フレームに公開するオブジェクト (インスタンスまたはファクトリ メソッド) を登録します。 |
| resize(number, number) | 現在の拡張機能のサイズに基づいて、この拡張機能のコンテナーのサイズを変更するように親ウィンドウに要求します。 |
| unregister(string) | この拡張機能がホスト フレームに公開されているオブジェクトを削除します。 |
変数
| sdk |
Web SDKのバージョン番号。 拡張の要求セットで指定できます。例えば:vss-sdk-version/4.2 |
関数の詳細
applyTheme({[varName: string]: string})
現在のドキュメントにテーマ変数を適用します
function applyTheme(themeData: {[varName: string]: string})
パラメーター
- themeData
-
{[varName: string]: string}
disableNestedAppAuth()
ネストされたアプリ認証ブリッジを無効にします。 この呼び出しの後、MSALトークン要求はすべての BridgeDisabled エラーを受け取ります。 ブリッジオブジェクトは window.nestedAppAuthBridge に残るため、既存のMSALリスナーが孤児化しないようにします。
enableNestedAppAuth()に連絡して再有効化を依頼してください。
function disableNestedAppAuth()
enableNestedAppAuth()
この拡張機能でネストアプリ認証(NAA)を有効にしてください。
MSALのcreateNestablePublicClientApplicationがAzure DevOpsホストフレームにトークン取得を委任できるようにwindow.nestedAppAuthBridgeを設定します。 これにより、iframesでポップアップ認証をブロックするクロスオリジンのBroadcastChannel問題を回避できます。
これをMSALインスタンスを作成する前に init() した後と呼びます。
ホストがNAAサポートを有効にしている必要があります。
例
await SDK.init();
await SDK.enableNestedAppAuth();
const pca = await createNestablePublicClientApplication({
auth: { clientId: "your-entra-client-id" }
});
function enableNestedAppAuth(): Promise<void>
返品
Promise<void>
ブリッジが準備できたときに解決するか、ホストがNAAをサポートしない場合は拒否する約束です。
getAccessToken()
他の DevOps サービスへの呼び出しを許可するアクセス トークンをフェッチする
function getAccessToken(): Promise<string>
返品
Promise<string>
getAppToken()
現在のユーザーを識別するために使用できるトークンをフェッチする
function getAppToken(): Promise<string>
返品
Promise<string>
getConfiguration()
親フレームから初期ハンドシェイクで渡された構成データを取得する
function getConfiguration(): {[key: string]: any}
返品
{[key: string]: any}
getContributionId()
この拡張機能が読み込まれる原因となったコントリビューションに関する情報を取得します。
function getContributionId(): string
返品
string
getExtensionContext()
ホストされているコンテンツを所有する拡張機能に関するコンテキストを取得する
function getExtensionContext(): IExtensionContext
返品
getHost()
getPageContext()
getService<T>(string)
指定されたコントリビューション ID を使用してコントリビューションを取得します。返されるコントリビューションには、そのコントリビューション内の登録済みオブジェクトを取得するメソッドがあります。
function getService<T>(contributionId: string): Promise<T>
パラメーター
- contributionId
-
string
取得する投稿の ID
返品
Promise<T>
getTeamContext()
getUser()
getWebContext()
Web に関するコンテキストを取得する
function getWebContext(): IWebContext
返品
IWebContext
init(IExtensionInitOptions)
ホスト ウィンドウでハンドシェイクを開始します。
function init(options?: IExtensionInitOptions): Promise<void>
パラメーター
- options
- IExtensionInitOptions
拡張機能の初期化オプション。
返品
Promise<void>
notifyLoadFailed(string | Error)
拡張機能の読み込みに失敗したことをホストに通知します
function notifyLoadFailed(e: string | Error): Promise<void>
パラメーター
- e
-
string | Error
返品
Promise<void>
notifyLoadSucceeded()
拡張機能が正常に読み込まれたことをホストに通知します (読み込みインジケーターの表示を停止します)
function notifyLoadSucceeded(): Promise<void>
返品
Promise<void>
ready()
初期セットアップ/ハンドシェイクが完了したら呼び出されるコールバックを登録します。 初期セットアップが既に完了している場合は、現在の呼び出し履歴の最後にコールバックが呼び出されます。
function ready(): Promise<void>
返品
Promise<void>
register<T>(string, T)
この拡張機能がホスト フレームに公開するオブジェクト (インスタンスまたはファクトリ メソッド) を登録します。
function register<T>(instanceId: string, instance: T)
パラメーター
- instanceId
-
string
登録済みオブジェクトの一意の ID
- instance
-
T
(1) オブジェクト インスタンス、または (2) 省略可能なコンテキスト データを受け取ってオブジェクト インスタンスを返す関数のいずれか。
resize(number, number)
現在の拡張機能のサイズに基づいて、この拡張機能のコンテナーのサイズを変更するように親ウィンドウに要求します。
function resize(width?: number, height?: number)
パラメーター
- width
-
number
省略可能な幅(既定値は scrollWidth)
- height
-
number
省略可能な高さ(既定値は scrollHeight)
unregister(string)
この拡張機能がホスト フレームに公開されているオブジェクトを削除します。
function unregister(instanceId: string)
パラメーター
- instanceId
-
string
登録済みオブジェクトの一意の ID
変数の詳細
sdkVersion
Web SDKのバージョン番号。 拡張の要求セットで指定できます。例えば:vss-sdk-version/4.2
sdkVersion: 5
型
5