azure-devops-extension-sdk package
الواجهات
| ContextIdentifier | |
| GlobalizationContext | |
| IExtensionContext |
معرف الملحق الحالي |
| IExtensionInitOptions |
خيارات تهيئة الملحق - تم تمريرها إلى DevOps.init() |
| IHostContext |
معلومات حول مضيف DevOps الحالي (المؤسسة) |
| IPageContext |
السياق العمومي الموضوع على كل صفحة ويب |
| ITeamContext |
معلومات حول فريق DevOps الحالي |
| IUserContext |
معلومات حول المستخدم الحالي |
التعدادات
| HostType |
مستوى مضيف DevOps |
الوظائف
| apply |
تطبيق متغيرات النسق على المستند الحالي |
| disable |
يعطل جسر مصادقة التطبيقات المتداخلة. بعد هذا الاتصال، ستتلقى أي طلبات رمز MSAL خطأ |
| enable |
فعل مصادقة التطبيقات المتداخلة (NAA) لهذه الإضافة. إعداد اتصل بهذا بعد مثال
|
| get |
إحضار رمز مميز للوصول الذي سيسمح بإجراء مكالمات إلى خدمات DevOps الأخرى |
| get |
إحضار رمز مميز يمكن استخدامه لتعريف المستخدم الحالي |
| get |
الحصول على بيانات التكوين التي تم تمريرها في تأكيد الاتصال الأولي من الإطار الأصل |
| get |
الحصول على معلومات حول المساهمة التي تسببت أولا في تحميل هذا الملحق. |
| get |
الحصول على سياق حول الملحق الذي يمتلك المحتوى الذي تتم استضافته |
| get |
الحصول على معلومات حول المضيف (أي مؤسسة Azure DevOps) التي تستهدفها الصفحة |
| get |
الحصول على السياق حول صفحة المضيف |
| get |
احصل على المساهمة بمعرف المساهمة المحدد. تحتوي المساهمة التي تم إرجاعها على طريقة للحصول على عنصر مسجل ضمن تلك المساهمة. |
| get |
الحصول على معلومات حول الفريق الذي تستهدفه الصفحة |
| get |
الحصول على معلومات حول المستخدم الحالي |
| get |
الحصول على السياق حول الويب |
| 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) لهذه الإضافة.
إعداد 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()
getService<T>(string)
احصل على المساهمة بمعرف المساهمة المحدد. تحتوي المساهمة التي تم إرجاعها على طريقة للحصول على عنصر مسجل ضمن تلك المساهمة.
function getService<T>(contributionId: string): Promise<T>
المعلمات
- contributionId
-
string
معرف المساهمة للحصول على
المرتجعات
Promise<T>
getTeamContext()
الحصول على معلومات حول الفريق الذي تستهدفه الصفحة
function getTeamContext(): ITeamContext
المرتجعات
getUser()
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