azure-devops-extension-sdk package

الواجهات

ContextIdentifier
GlobalizationContext
IExtensionContext

معرف الملحق الحالي

IExtensionInitOptions

خيارات تهيئة الملحق - تم تمريرها إلى DevOps.init()

IHostContext

معلومات حول مضيف DevOps الحالي (المؤسسة)

IPageContext

السياق العمومي الموضوع على كل صفحة ويب

ITeamContext

معلومات حول فريق DevOps الحالي

IUserContext

معلومات حول المستخدم الحالي

التعدادات

HostType

مستوى مضيف DevOps

الوظائف

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

تطبيق متغيرات النسق على المستند الحالي

disableNestedAppAuth()

يعطل جسر مصادقة التطبيقات المتداخلة. بعد هذا الاتصال، ستتلقى أي طلبات رمز MSAL خطأ BridgeDisabled . يبقى كائن الجسر على الوضع window.nestedAppAuthBridge حتى لا يفقد مستمعو MSAL الحاليون أيامتهم. اتصل enableNestedAppAuth() لإعادة التفعيل.

enableNestedAppAuth()

فعل مصادقة التطبيقات المتداخلة (NAA) لهذه الإضافة.

إعداد window.nestedAppAuthBridge بحيث يمكن لأجهزة createNestablePublicClientApplication MSAL تفويض اكتساب الرموز إلى إطار استضافة Azure DevOps. هذا يتجنب مشاكل قناة البث عبر المصادر التي تمنع المصادقة القائمة على النوافذ المنبثقة في إطارات iframes.

اتصل بهذا بعد init() وقبل إنشاء نسخة MSAL. يتطلب دعم NAA من المضيف.

مثال

await SDK.init();
await SDK.enableNestedAppAuth();
const pca = await createNestablePublicClientApplication({
    auth: { clientId: "your-entra-client-id" }
});
getAccessToken()

إحضار رمز مميز للوصول الذي سيسمح بإجراء مكالمات إلى خدمات DevOps الأخرى

getAppToken()

إحضار رمز مميز يمكن استخدامه لتعريف المستخدم الحالي

getConfiguration()

الحصول على بيانات التكوين التي تم تمريرها في تأكيد الاتصال الأولي من الإطار الأصل

getContributionId()

الحصول على معلومات حول المساهمة التي تسببت أولا في تحميل هذا الملحق.

getExtensionContext()

الحصول على سياق حول الملحق الذي يمتلك المحتوى الذي تتم استضافته

getHost()

الحصول على معلومات حول المضيف (أي مؤسسة Azure DevOps) التي تستهدفها الصفحة

getPageContext()

الحصول على السياق حول صفحة المضيف

getService<T>(string)

احصل على المساهمة بمعرف المساهمة المحدد. تحتوي المساهمة التي تم إرجاعها على طريقة للحصول على عنصر مسجل ضمن تلك المساهمة.

getTeamContext()

الحصول على معلومات حول الفريق الذي تستهدفه الصفحة

getUser()

الحصول على معلومات حول المستخدم الحالي

getWebContext()

الحصول على السياق حول الويب

init(IExtensionInitOptions)

بدء تأكيد الاتصال مع نافذة المضيف.

notifyLoadFailed(string | Error)

إعلام المضيف بفشل تحميل الملحق

notifyLoadSucceeded()

إعلام المضيف بأن الملحق تم تحميله بنجاح (توقف عن إظهار مؤشر التحميل)

ready()

تسجيل رد اتصال يتم استدعاؤه بمجرد اكتمال الإعداد/تأكيد الاتصال الأولي. إذا اكتمل الإعداد الأولي بالفعل، يتم استدعاء رد الاتصال في نهاية مكدس الاستدعاءات الحالي.

register<T>(string, T)

تسجيل كائن (مثيل أو أسلوب مصنع) يعرضه هذا الملحق لإطار المضيف.

resize(number, number)

يطلب من النافذة الأصل تغيير حجم الحاوية لهذا الملحق استنادا إلى حجم الملحق الحالي.

unregister(string)

إزالة كائن يعرضه هذا الملحق لإطار المضيف.

المتغيرات

sdkVersion

رقم إصدار 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) لهذه الإضافة.

إعداد window.nestedAppAuthBridge بحيث يمكن لأجهزة createNestablePublicClientApplication MSAL تفويض اكتساب الرموز إلى إطار استضافة Azure DevOps. هذا يتجنب مشاكل قناة البث عبر المصادر التي تمنع المصادقة القائمة على النوافذ المنبثقة في إطارات iframes.

اتصل بهذا بعد init() وقبل إنشاء نسخة MSAL. يتطلب دعم 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()

الحصول على معلومات حول المضيف (أي مؤسسة Azure DevOps) التي تستهدفها الصفحة

function getHost(): IHostContext

المرتجعات

getPageContext()

الحصول على السياق حول صفحة المضيف

function getPageContext(): IPageContext

المرتجعات

getService<T>(string)

احصل على المساهمة بمعرف المساهمة المحدد. تحتوي المساهمة التي تم إرجاعها على طريقة للحصول على عنصر مسجل ضمن تلك المساهمة.

function getService<T>(contributionId: string): Promise<T>

المعلمات

contributionId

string

معرف المساهمة للحصول على

المرتجعات

Promise<T>

getTeamContext()

الحصول على معلومات حول الفريق الذي تستهدفه الصفحة

function getTeamContext(): ITeamContext

المرتجعات

getUser()

الحصول على معلومات حول المستخدم الحالي

function getUser(): IUserContext

المرتجعات

getWebContext()

الحصول على السياق حول الويب

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

المعرف الفريد للكائن المسجل

instance

T

إما: (1) مثيل كائن، أو (2) دالة تأخذ بيانات سياق اختيارية وترجع مثيل كائن.

resize(number, number)

يطلب من النافذة الأصل تغيير حجم الحاوية لهذا الملحق استنادا إلى حجم الملحق الحالي.

function resize(width?: number, height?: number)

المعلمات

width

number

عرض اختياري، الإعدادات الافتراضية ل scrollWidth

height

number

الارتفاع الاختياري، الإعدادات الافتراضية للتمريرHeight

unregister(string)

إزالة كائن يعرضه هذا الملحق لإطار المضيف.

function unregister(instanceId: string)

المعلمات

instanceId

string

المعرف الفريد للكائن المسجل

تفاصيل المُتغيّر

sdkVersion

رقم إصدار Web SDK. يمكن تحديده في مجموعة متطلبات الامتداد مثل: vss-sdk-version/4.2

sdkVersion: 5

النوع

5