تم إصدار Power BI APIs. NET SDK v3
في الأسبوع الماضي كشفت Microsoft عن تحديث فبراير
لشاشة Power BI Desktop.
هذا الإصدار كما هو معتاد في تحديث سطح المكتب الشهري لخدمة التحليلات
جلب مجموعة من القدرات الجديدة.
تضمنت هذه معاينة للتقطيع الهرمي الجديد
التحديث التدريجي ، وأكثر من ذلك.
اليوم تم إصدار الإصدار 3 من واجهات برمجة تطبيقات
Power BI .NET SDK كحزمة
تتعلق التغييرات المقدمة في المقام الأول بجعل SDK أسهل في الاستخدام
من خلال فئات بيانات الاعتماد الجديدة وتقنيات تشفير بيانات الاعتماد.
تشمل الميزات الرئيسية التي تم تسليط الضوء عليها كجزء من هذا الإصدار:
إعادة تسمية مساحات الأسماء
تم تغيير Microsoft.PowerBI.Api.V2 إلى
Microsoft.PowerBI.Api
تم تغيير Microsoft.PowerBI.Api.Extensions.V2
إلى Microsoft.PowerBI.Api.Extensions
تمت إزالة مساحة الاسم Microsoft.PowerBI.Api.V1.
يتم إهمال عمليات SetAllConnections
و SetAllConnectionsInGroup
وتمييزها على أنها قديمة.
يجب عليك استخدام واجهات برمجة التطبيقات UpdateDatasources
أو UpdateParameters بدلاً من ذلك.
تم تغيير كتابة معرفات التحف الفنية لـ PowerBI * من السلسلة إلى Guid
نوصي بالعمل مع Guid عندما يكون ذلك ممكنًا.
* معرف Dataset هو استثناء وسيظل كتابة السلسلة.
تم تغيير أنواع "ODataResponse [List [Object]]"
إلى "Objects" ،
وبالتالي إرجاع مجموعة كائنات على الردود.
على سبيل المثال ستؤدي استجابة ODataResponse
[List
[Report]]
إلى إرجاع مجموعة التقارير كنوع الإرجاع.
تسمح فئات بيانات الاعتماد الجديدة ببناء تفاصيل بيانات الاعتماد بطريقة أسهل.
تتضمن الفئات الجديدة ما يلي:
`BasicCredentials` و` WindowsCredentials`
و `OAuth2Credentials` والمزيد.
فئات مساعد تشفير جديدة لتشفير أسهل عند إنشاء بيانات اعتماد.
على سبيل المثال باستخدام فئة AsymmetricKeyEncryptor
مع مفتاح بوابة عام:
Gat
ayPublicKey publicKey = new GatewayPublicKey
ewayPublicKey publicKey = new GatewayPublicKey
{
Exponent = "...",
Modulus = "..."
};
CredentialsBase credentials = new BasicCredentials("", "");
var credentialsEncryptor = new AsymmetricKeyEncryptor(publicKey);
var credentialDetails = new CredentialDetails(credentials, PrivacyLevel.None, EncryptedConnection.Encrypted, credentialsEncryptor);
الاتساق في أسماء الحقول.
على سبيل المثال تم تغيير
reportKey
و datasetKey
و dashboardKey
و tileKey
إلى reportId
و datasetId
و dashboardId
و tileId.
الاتساق في أسماء العمليات.
على سبيل المثال استخدم GetDataset بدلاً من GetDatasetById.
وأسماء opertation تنفذ هي الاستيراد ومجموعات البيانات
والعبارات ومصادر البيانات.
استخدم فئة التعداد بدلاً من السلسلة لأنواع التعداد.
على سبيل المثال في createTokenRequest نوصي باستخدام
`TokenAccessLevel.View
وعدم استخدام" عرض "بشكل صريح كقيمة.
تم وضع علامة الحقول المطلوبة تم تغيير بعض الحقول إلى الحقول المطلوبة
لم تعد صالحة.
يمكن قراءة أمثلة الطرق التي تم بها تنفيذ هذه التغييرات بالتفصيل
بصرف النظر عن تلك المذكورة أعلاه
على وجه التحديد تشمل الأخرى تغيير الأجيال الرمزية
ومعالجة الاستجابة إذا كانت السلاسل متوقعة وأكثر من ذلك.
أحدث إصدار هو الوحيد الذي سيدعم واجهات برمجة التطبيقات المقدمة حديثًا.
نظرًا لأن الإصدار 3 غير متوافق مع الإصدارات السابقة فقد يتطلب
التحديث عليه تغييرات في التعليمات البرمجية.
علاوة على ذلك وفقًا لسياسة دورة حياة Microsoft
يعني إصدار هذا الإصدار الجديد أنه قد تم إهمال .NET SDK v2.
ستتم إزالة الإصدار السابق رسميًا بعد عامين في فبراير 2022.
ومع ذلك فقد لوحظ أن مخاوف "أمان الخدمة أو الموثوقية الصحية"
قد تؤدي إلى تغيير هذا الموعد النهائي.
ليست هناك تعليقات:
إرسال تعليق