DEENESPTFRRUARHIKOZHNL

واجهة خدمة StateMachineService

Als ara::com-Dienst modellierte Schnittstelle; Methoden/Felder werden über generierte Proxies/Skeletons aufgerufen (Parameterrichtung IN/OUT).

دليل المستخدممولَّد بالذكاء الاصطناعي

يمكّن تطبيقات التحكم من طلب تغييرات الحالة لآلات الحالات المكونة.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e242ff13fc20 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيمُولَّد بالذكاء الاصطناعيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يمكّن تطبيقات التحكم من طلب تغييرات الحالة لآلات الحالات المكونة.

يتم توفير واجهة الخدمة StateMachineService بواسطة State Management لكل آلة حالات مكونة، حتى تتمكن SMControlApplication من طلب تغييرات الحالة بشكل موجه عبر الطريقة RequestTransition [SWS_SM_00600]، [SWS_SM_91107]. يتم تقديم الخدمة مباشرة بعد التنفيذ الناجح لخطوة بدء آلة الحالات، وتؤكد استلام الطلبات بدون دلالات Fire-and-Forget. ومع ذلك، يتم رفض الطلبات بأخطاء محددة إذا كانت القيمة الممررة غير صالحة، أو إذا كان الانتقال من الحالة الحالية غير مسموح به، أو إذا كانت جلسة تحديث أو استرداد نشطة في الوقت ذاته [SWS_SM_91107].

دور واجهة الخدمة وسياق النظام الخاص بها

يتم توفير واجهة الخدمة StateMachineService من الـ Functional Cluster State Management (SM) عبر منفذ خدمة قياسي [SWS_SM_91021]. ووفقاً للتعريف الرسمي للواجهة [SWS_SM_91022]، يقوم State Management بإنشاء مثيل وتقديم هذه الخدمة المستندة إلى ara::com لكل مثيل فردي مكوّن من StateMachine [SWS_SM_00600].

يعمل SMControlApplication كمستهلك رئيسي لهذه الواجهة، حيث يتفاعل مباشرة مع آلة الحالات عبر الخدمة لطلب تغييرات الحالة SWS StateManagement §9.2.2 «StateMachine service». وفي حين أن الإشعارات بشأن الحالات التي حدثت تُرسل إلى التطبيقات التكيفية العادية في المقام الأول عبر واجهة الخدمة المنفصلة StateMachineNotification [SWS_SM_00665]، فإن StateMachineService يشكل واجهة التحكم النشطة لبدء الانتقالات.

الطرق ودلالات الاستدعاء

تحدد الواجهة الطريقة RequestTransition، والتي يجب استدعاؤها بواسطة SMControlApplication لإحداث تغيير في الحالة في StateMachine المشار إليها [SWS_SM_91107]. تتوقع الطريقة معلمة الإدخال TransitionRequest من النوع TransitionRequestType، والتي تمثل قيمة الانتقال المطلوبة داخل TransitionRequestTable الأساسية [SWS_SM_91107]، SWS StateManagement §7.x «TransitionRequestTable».

بالنسبة إلى RequestTransition، تم تعيين الخاصية Fire & Forget على false [SWS_SM_91107]. وبذلك يتلقى التطبيق المستدعي تأكيداً ملزماً للطلب. Interpretation: ضمن نمط الوكيل-Skeleton الخاص بـ ara::com، من المرجح أن يتم تقديم الاستجابة عادةً عبر ara::core::Future أو كائن نتيجة مطابق، والذي يكتمل بنجاح في حالة النجاح أو يرسل حالة خطأ محددة في حالة الفشل. سؤال Q-41fa67738672c735 (مفتوح)

دورة الحياة والتبعيات المعتمدة على الحالة

يجب أن تكون كل خدمة ara::com مكونة لـ StateMachine المراد تشغيلها – بما في ذلك StateMachineService – متاحة ومعروضة (Offer) بمجرد اكتمال معالجة ActionListItem \"StartStateMachine\" بنجاح [SWS_SM_00618]. يتيح ذلك لـ SMControlApplication طلب انتقال فور إنشاء آلة الحالات بنجاح، حتى لو كانت آلة الحالات لا تزال تعالج ActionList الأولية في ذلك الوقت SWS StateManagement §7.x «StateMachine service interfaces - Offer».

ينتهي عرض الخدمة (StopOffer) بمجرد تنفيذ عملية إيقاف آلة الحالات المعنية [SWS_SM_00619]. وتخضع عمليات الاستدعاء أيضاً لشروط وظيفية مسبقة: إذا كانت جلسة تحديث جارية في النظام حالياً، فإن بدء تغييرات الحالة يكون غير مسموح به من حيث المبدأ [SWS_SM_91107].

معالجة الأخطاء وأخطاء التطبيق (Application Errors)

عند تنفيذ RequestTransition، قد تحدث Application Errors محددة يتم إرجاعها من State Management إلى المستدعي [SWS_SM_91107]:

  • kInvalidValue: القيمة الممررة غير مقترنة بأي انتقال في TransitionRequestTable [SWS_SM_91107].
  • kTransitionNotAllowed: انتقال الحالة المطلوب غير مسموح به انطلاقاً من الحالة الحالية لـ StateMachine [SWS_SM_91107].
  • kRecoveryTransitionOngoing: يتم تجاهل الطلب لأن عملية معالجة أخطاء (Recovery) قيد التنفيذ حالياً [SWS_SM_91107].
  • kTransitionFailed: حدث خطأ أثناء تنفيذ الانتقال إلى الحالة المستهدفة [SWS_SM_91107].
  • kOperationCanceled: تم إلغاء الطلب لأنه تم استبداله بطلب أحدث [SWS_SM_91107].
  • kUpdateInProgress: العملية محظورة لأن جلسة تحديث نشطة حالياً [SWS_SM_91107].
سير طلب الانتقال عبر StateMachineServiceSMControlApplicationStateMachineServiceState ManagementUse Case: Service-BereitstellungStartStateMachine verarbeitet: OfferService()Use Case: طلب انتقال الحالةRequestTransition(TransitionRequest)Zustandswechsel verarbeitenaltانتقال ناجحتنفيذ الانتقال وفقاً لـ TransitionRequestTableErfolgإشعار رد: نجاحFehlerfall (z. B. kTransitionNotAllowed, kUpdateInProgress)Application Errorإشعار رد مع كود الخطأ

مخطط التسلسل: تسلسل طلب انتقال عبر StateMachineService مع التوفير، وتأكيد النجاح، ومعالجة الأخطاء. المصادر: [SWS_SM_91107]، [SWS_SM_00618]، SWS StateManagement §7.x «StateMachine service interfaces - Offer».

تم إنشاء هذا الدليل بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R25-11.

Mitglieder

خريطة الأعضاء

الدوال الأعضاء

1
RequestTransition

أنواع البيانات

1
TransitionRequestType

أخطاء التطبيق

6
kInvalidValuekOperationCanceledkRecoveryTransitionOngoingkTransitionFailedkTransitionNotAllowedkUpdateInProgress

عرض التفاصيل

اختر عنصرًا من المخطط.

الدوال الأعضاء

RequestTransition دالة خدمة

Has to be called by a SMControlApplication to request a change in the referenced StateMachine.

RequestTransition (IN TransitionRequestType TransitionRequest)

أنواع البيانات

TransitionRequestType نوع بيانات

أخطاء التطبيق

kInvalidValue خطأ تطبيق

The provided value is not mapped to any transition.

kOperationCanceled خطأ تطبيق

The request was replaced by a newer one and therefore it was cancelled

kRecoveryTransitionOngoing خطأ تطبيق

Request will not be carried out, because currently recovery is ongoing.

kTransitionFailed خطأ تطبيق

During transition to the requested state an error occurred.

kTransitionNotAllowed خطأ تطبيق

Requested transition is not possible from current StateMachine state.

kUpdateInProgress خطأ تطبيق

Requested operation is not allowed as update session is in progress.

التوثيق

دالة خدمة RequestTransition [SWS_SM_91107] Upstream: RS_SM_00001, RS_SM_00004

RequestTransition (IN TransitionRequestType TransitionRequest)

Has to be called by a SMControlApplication to request a change in the referenced StateMachine.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e769039e5880 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

يتم استدعاء أسلوب الخدمة RequestTransition بواسطة SMControlApplication على الواجهة StateMachineService لطلب تغيير حالة لـ StateMachine مُشار إليها ([SWS_SM_91107]، SWS StateManagement §7.7 «SMControlApplication»). ويُمرَّر TransitionRequest كمعلمة. يمتلك الأسلوب قيم إرجاع ولا يعمل وفق مبدأ أطلق وانسَ (Fire-and-Forget). يقوم State Management بتعيين قيمة الإدخال عبر TransitionRequestTable اعتمادًا على الحالة الحالية إلى حالة لاحقة ([SWS_SM_00607]) ويطلب Function Group States الناتجة عبر SetState() من Execution Management (AP EXP SWArchitecture §11.1 «Change System State»).

معالجة الأخطاء

في حالة الخطأ، تتوقف المعالجة ويُرجع RequestTransition أخطاء تطبيقية محددة ([SWS_SM_91107]):

  • kInvalidValue: القيمة الممررة لـ TransitionRequest غير مهيأة في TransitionRequestTable ([SWS_SM_00604]).
  • kTransitionNotAllowed: الانتقال غير مسموح به وفقًا للتهيئة انطلاقًا من الحالة الحالية لـ StateMachine ([SWS_SM_00603]).
  • kRecoveryTransitionOngoing: عملية تصحيح أخطاء داخلية نشطة، ولهذا السبب لا تتم متابعة معالجة الطلب ([SWS_SM_00605]).
  • kUpdateInProgress: أثناء جلسة تحديث نشطة، يكون تغيير الحالة غير مسموح به ([SWS_SM_91107]).
  • kTransitionFailed: حدث خطأ أثناء تنفيذ ActionListItems ([SWS_SM_00650]).

التزامن والقيود

إذا تم قبول رغبة انتقال جديدة بينما لا يزال استدعاء RequestTransition سابق معلقًا لنفس StateMachine، يتم إلغاء الطلب السابق والإقرار به عبر kOperationCanceled ([SWS_SM_00606]). الإجراءات المحددة زمنيًا مثل Sleep ActionListItem لا تحظر المحفزات الواردة؛ وبالتالي يمكن لاستدعاء RequestTransition إطلاق تغيير في الحالة حتى أثناء فترة انتظار كهذه (SWS StateManagement §7.7.9 «ActionListItem Sleep»).

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا وتستند حصريًا إلى مواصفات AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Scopeservice interface StateMachineService
Fire & Forgetfalse
Version1.0

Parameter

NameRichtungTypBeschreibung
TransitionRequestINTransitionRequestTypeRepresents the value to be used as TransitionRequest value in the Transition RequestTable.

Application Errors

FehlerBeschreibung
kInvalidValueThe provided value is not mapped to any transition.
kTransitionNotAllowedRequested transition is not possible from current StateMachine state.
kRecoveryTransitionOngoingRequest will not be carried out, because currently recovery is ongoing.
kTransitionFailedDuring transition to the requested state an error occurred.
kOperationCanceledThe request was replaced by a newer one and therefore it was cancelled
kUpdateInProgressRequested operation is not allowed as update session is in progress.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_SM_91107
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_SM_91107@rel:R25-11#47dd4198
Content hash
47dd4198
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_StateManagement.pdf#nameddest=SWS_SM_91107
Status: valid/unmigrated Version: rel:R25-11#d4767b6b Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_SM_91107@rel:R25-11#d4767b6b
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a5b9b5c32026-09-30
  • R24-11rel:R24-11#75ea2a2c2026-10-14
  • R25-11rel:R25-11#d4767b6b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

View in Curation Report →