التكامل مع موفر بيانات أنشطة المزرعة
يدعم Azure Data Manager for Agriculture الموصلات لمزامنة بيانات المستخدمين النهائيين بشكل ملائم من مجموعة من مصادر بيانات آلات المزرعة. يتضمن الإعداد تكوين تدفق oAuth باعتباره شرطا مسبقا للتكامل مع أي موفر بيانات أنشطة المزرعة، جنبا إلى جنب مع خطوة موافقة شفافة لكل حساب تتعامل مع مزامنة البيانات الأولية والتزايدية للحفاظ على ملكية بيانات ADMA محدثة.
إشعار
تعد الخطوات من 1 إلى 3 جزءا من التكوين الأولي لمرة واحدة لكل موفر. بمجرد التكامل، ستتمكن من تمكين جميع المستخدمين النهائيين من استخدام سير عمل oAuth الحالي واستدعاء واجهة برمجة تطبيقات التكوين (الخطوة 4) لكل مستخدم (PartyID) لاسترداد رمز الوصول المميز.
إعداد الموفر
يستخدم مثال التدفق هنا Climate FieldView
الخطوة 1: إنشاء التطبيق
إذا لم يكن طلبك مسجلا بالفعل في Climate Fieldview، فانتقل إلى مدخل FieldView وقم بإرسال النموذج. بمجرد أن يعالج FieldView طلبك، يرسلون و client_id client_secret الذي ستستخدمه مرة واحدة لكل مثيل ADMA ل FieldView.
الخطوة 2: تكوين الموفر
oAuthProvider استخدم واجهة برمجة التطبيقات لإنشاء أو تحديث موفر oAuth (Ex: FIELDVIEW) ببيانات الاعتماد المناسبة للتطبيق الذي تم إنشاؤه حديثا.
وثائق واجهة برمجة التطبيقات: oAuthProviders - إنشاء أو تحديث
خطوة اختيارية: بمجرد الانتهاء من العملية، يمكنك تشغيل oAuthProviders_Get للتحقق مما إذا كان التطبيق مسجلا أم لا. الآن، يمكن لجميع الأطراف التي تم إنشاؤها في مثيل Azure Data Manager for Agriculture استخدام FieldView كموفر لجلب بيانات أنشطة المزرعة.
الخطوة 3: تكوين نقطة النهاية
نقطة نهاية إعادة توجيه المستخدم: نقطة النهاية هذه هي المكان الذي تريد إعادة توجيه المستخدمين إليه بمجرد اكتمال تدفق oAuth. سيتم إنشاء نقطة النهاية هذه بواسطةك وتوفيرها إلى ADMA كما هو الحال userRedirectLink في oauth/tokens/:connect API.
تسجيل نقطة نهاية رد الاتصال oAuth مع التطبيق الخاص بك على مدخل Climate FieldView.
إعداد حساب المستخدم النهائي
الخطوة 4: تكامل الطرف (المستخدم النهائي)
عندما يهبط طرف (المستخدم النهائي) على صفحة الويب الخاصة بك حيث يتوقع إجراء المستخدم (على سبيل المثال: الاتصال إلى زر FieldView)، قم بإجراء استدعاء لواجهة oauth/tokens/:connect برمجة التطبيقات بالطريقة التالية للحصول على عنوان uri لتسجيل الدخول لموفر oAuth (Ex: Climate FieldView) لبدء تدفق oAuth للمستخدم النهائي.
وثائق واجهة برمجة التطبيقات: oAuthTokens - Get OAuth الاتصال ion Link
oauth/tokens/:connect بمجرد أن تقوم واجهة برمجة التطبيقات بإرجاع oauthAuthorizationLink، ينقر المستخدم النهائي على هذا الارتباط لإكمال تدفق oAuth (على سبيل المثال: بالنسبة إلى Climate FieldView، يتم تقديم موافقة وصول FieldView للمستخدم وصفحة تسجيل الدخول). بمجرد اكتمال تسجيل الدخول، سيقوم ADMA بإعادة توجيه المستخدم إلى نقطة النهاية التي يوفرها العميل (userRedirectLink) مع معلمات الاستعلام التالية في عنوان url
- الحالة (النجاح/الفشل)
- الحالة (سلسلة اختيارية لتعريف المستخدم بشكل فريد في نهاية العميل)
- رسالة (سلسلة اختيارية)
- errorCode (سلسلة اختيارية مرسلة للفشل/الخطأ) في المعلمات.
إشعار
إذا كانت واجهة برمجة التطبيقات ترجع 404، فهذا يعني فشل تدفق oAuth وتعذر على ADMA الحصول على الرمز المميز للوصول.
الخطوة 5: التحقق من معلومات الرمز المميز للوصول (اختياري)
هذه الخطوة اختيارية، فقط للتأكيد على أنه بالنسبة لمستخدم معين أو قائمة مستخدمين، تم الحصول على رمز الوصول الصحيح المطلوب أم لا. يمكن القيام بذلك عن طريق إجراء مكالمة إلى oauth/tokens واجهة برمجة التطبيقات للتحقق من الإدخال isValid: true في نص الاستجابة.
وثائق واجهة برمجة التطبيقات: oAuthTokens - قائمة
تشير هذه الخطوة إلى الإكمال الناجح لتدفق oAuth للمستخدم. الآن، تم تعيين المستخدم بالكامل لتشغيل FarmOperationsDataJob جديد لبدء سحب بيانات أنشطة المزرعة من Climate FieldView.