فئة <SI-Namespace>::proxy::fields::<Field>

[SWS_CM_00008] Upstream: RS_CM_00216, RS_AP_00114

class <Field> final {...};

Service proxy Field class, one for each Field defined in the ServiceInterface in the role field.

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Forwarding-Header	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy/<SiShortname>_proxy_fwd.h"
Scope	namespace <SI-Namespace>::proxy::fields

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

يتيح لتطبيقات العميل الاستعلام غير المتزامن عن حقل خدمة وتعديله ومراقبته عبر الاشتراك.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7495b8cd48c6 المصدر أسئلة مفتوحة (2)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتيح لتطبيقات العميل الاستعلام غير المتزامن عن حقل خدمة وتعديله ومراقبته عبر الاشتراك.

تُستخدم الفئة كواجهة من جانب العميل للوصول إلى حقل معرّف في ServiceInterface وتجمع دوال الجلب والتعيين والإشعار. عبر [SWS_CM_00112] و[SWS_CM_00113]، يمكن الاستعلام عن القيم وتعديلها بشكل غير متزامن، شريطة أن تكون العمليات المقابلة منمذجة. وبالنسبة لتحديثات الحقل، تُستخدم آلية تخزين مؤقت قائمة على الاشتراك، تقوم بتخزين الإشعارات مؤقتًا وإعادة توجيهها عبر معالجات رد الاتصال. ومن الشروط الأساسية مراعاة الفواصل الزمنية الدنيا للإرسال والاستغناء عن دلالات التراجع عند عمليات الكتابة.

السياق

في إدارة الاتصالات لـ AUTOSAR Adaptive Platform (ara::com)، تمثل الفئة <SI-Namespace>::proxy::fields::<Field> حقلًا فرديًا (Field) منمذجًا في واجهة الخدمة من جانب العميل أو الوكيل (Proxy). تجمع الفئة الوصول إلى قيم السمات وتربط ثلاثة أدوار وظيفية: الاستعلام عن القيمة الحالية (Getter)، وتعديل القيمة (Setter)، واستقبال تغييرات القيمة غير المتزامنة (Notifier) (AUTOSAR_AP_EXP_ARAComAPI ص. 10). وتعمل كواجهة بين تطبيق العميل وطبقة الاتصال الأساسية (Network Binding).

تحدد تعريفات واجهة الخدمة العمليات المتاحة في النسخة: لا يتم توليد التابع Get() إلا إذا تم تكوين Field.hasGetter == TRUE [SWS_CM_00112]. ويتوفر التابع Set() حصريًا إذا كان Field.hasSetter == TRUE ينطبق [SWS_CM_00113]. ويتم تمثيل نوع البيانات الفعلي للحقل بأمان نوعي عبر الاسم المستعار للنوع المتوفر FieldType [SWS_CM_11403].

دورة الحياة

يتم إنشاء كائنات الحقول كأعضاء في فئة الوكيل العليا. وبالتالي، يُرجح أن عمرها مرتبط مباشرة بدورة حياة نسخة الوكيل المقابلة. سؤال Q-22443af0e2e4cfab (مفتوح) وبالنسبة لآلية Notifier القائمة على الأحداث، تمر النسخة بدورة حياة اشتراك محددة بوضوح:

غير مشترك: في البداية، يكون الحقل في الحالة kNotSubscribed.
طُلب الاشتراك: من خلال الاستدعاء المتزامن لـ Subscribe(maxSampleCount) [SWS_CM_11601]، يتم إعداد المخزن المؤقت وبدء التسجيل. ينتقل Notifier إلى kSubscriptionPending أو بعد التأكيد من طبقة الاتصال إلى kSubscribed، حيث يُرجح أن يتم هذا التغيير في الحالة بشكل غير متزامن. سؤال Q-67af35e88035c41c (مفتوح)
أُنهي الاشتراك: عبر Unsubscribe() [SWS_CM_11602]، يتم إيقاف تدفق الإشعارات وتعود الحالة إلى kNotSubscribed.

يمكن الاستعلام عن الحالة الحالية تزامنيًا في أي وقت باستخدام GetSubscriptionState() [SWS_CM_11604]. ولمواكبة تغييرات الحالة بشكل غير متزامن، يمكن تسجيل رد اتصال باستخدام SetSubscriptionStateChangeHandler() [SWS_CM_11607]، واختياريًا مع سياق تنفيذ مخصص [SWS_CM_11608]. وقبل تدمير النسخة أو عند إلغاء التنشيط، ينبغي إزالة ردود الاتصال المسجلة صراحةً عبر UnsetReceiveHandler() [SWS_CM_11606]، وUnsetSubscriptionStateChangeHandler() [SWS_CM_11609]، وكذلك UnsetTransportFaultConditionHandler() [SWS_CM_00126].

مخطط الحالة: دورة حياة اشتراك Notifier عبر ara::com::SubscriptionState. المصادر: [SWS_CM_11601]، [SWS_CM_11602]، [SWS_CM_11604].

مسار الاستخدام

يتضمن مسار الاستخدام النموذجي تسجيل الإشعارات، وتلقي البيانات الجديدة، والوصول الموضعي للقراءة والكتابة:

إعداد الاشتراك: يستدعي التطبيق Subscribe() مع سعة التخزين المؤقت المطلوبة [SWS_CM_11601] ويسجل عبر SetReceiveHandler() رد اتصال إشعار بدون معلمات [SWS_CM_11605]. وبالنسبة للبنى التفرعية المتزامنة، يمكن تفويض التنفيذ عبر منفّذ (Executor) [SWS_CM_11611]. بالإضافة إلى ذلك، يمكن تسجيل معالج لأخطاء النقل لأحداث Notifier [SWS_CM_00109]، [SWS_CM_00110].
معالجة العينات: بمجرد أن تتلقى إدارة الاتصالات بيانات حقل جديدة، فإنها تطلق معالج الاستقبال. يحدد المعالج مواقع التخزين المؤقت المتاحة عبر GetFreeSampleCount() [SWS_CM_11603] ويعالج القيم الجديدة عبر GetNewSamples() [SWS_CM_11610]. ويمكن التحقق من حالة E2E للإشعارات المستلمة عبر GetE2EStateMachineStateNotifier() [SWS_CM_11612].
القراءة الصريحة: يتم جلب القيمة الحالية بشكل غير متزامن عبر Get() [SWS_CM_00112] ويعيد ara::core::Future<FieldType> [SWS_CM_11403]. وبعد الاكتمال، يمكن التحقق من حالة فحص E2E باستخدام GetE2EStateMachineStateGetter() [SWS_CM_00145].
الكتابة الصريحة: يتم تعديل القيمة عبر Set(value) [SWS_CM_00113]. ويعيد ara::core::Future<FieldType> المُرجع نتيجة عملية التعيين، والتي يمكن قراءة حالة E2E الخاصة بها عبر GetE2EStateMachineStateSetter() [SWS_CM_00146].

مخطط تسلسلي: المسار النموذجي للتفاعل مع الإشعارات بالإضافة إلى عمليات Get و Set. المصادر: [SWS_CM_00112]، [SWS_CM_00113]، [SWS_CM_11601]، [SWS_CM_11605]، [SWS_CM_11610].

سيناريوهات الأخطاء

عند استخدام توابع الحقل، قد تحدث حالات خطأ مختلفة:

فشل الاتصال: إذا فشل نقل الشبكة عند Get() أو Set()، يتم إرسال الخطأ ComErrc::kCommunicationFailure في Future [SWS_CM_00112]، [SWS_CM_00113]. ومع Get()، تنطبق دلالات التراجع؛ ومع Set() ينطبق no_rollback_semantics، بحيث قد تنشأ حالة غير محددة على الخادم عند حدوث مهلة [SWS_CM_00113].
انتهاك الفاصل الزمني للإرسال: إذا تم إرسال الطلبات بشكل أسرع مما تم تكوينه في النشر (deployment)، ينتج عن ذلك ComErrc::kMinimumSendIntervalViolationError [SWS_CM_00112]، [SWS_CM_00113].
حدود المخزن المؤقت: إذا تعذر تخصيص الذاكرة عند Subscribe()، يُرجع التابع ComErrc::kMaxSampleCountNotRealizable [SWS_CM_11601]. وإذا تم جلب عينات كثيرة جدًا عند GetNewSamples()، يفشل الاستدعاء بـ ComErrc::kMaxSamplesExceeded [SWS_CM_11610].
انتهاكات الوصول والمعالج: تؤدي حقوق التنفيذ المفقودة إلى InsufficientPermissionsViolation عند Get() أو Set() أو Subscribe() [SWS_CM_00112]، [SWS_CM_00113]، [SWS_CM_11601]. ويؤدي تمرير كائنات قابلة للاستدعاء فارغة أو غير صالحة إلى تسجيلات المعالج إلى إطلاق InvalidHandlerViolation [SWS_CM_11605]، [SWS_CM_11607]، [SWS_CM_00109].
تحقيق الفعالية الذاتية (Idempotence): استدعاء Subscribe() متكرر بنفس قيمة المخزن المؤقت في الحالات kSubscribed أو kSubscriptionPending يظل بلا أثر [SWS_CM_11601]؛ وبالمثل، يعود Unsubscribe() دون اشتراك نشط دون أي تأثير [SWS_CM_11602].

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

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

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

Get GetE2EStateMachineStateGetter GetE2EStateMachineStateNotifier GetE2EStateMachineStateSetter GetFreeSampleCount GetNewSamples GetSubscriptionState Set SetReceiveHandler SetSubscriptionStateChangeHandler SetTransportFaultConditionHandler Subscribe UnsetReceiveHandler UnsetSubscriptionStateChangeHandler UnsetTransportFaultConditionHandler Unsubscribe

أسماء الأنواع البديلة

FieldType

مخطط الفئة

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

عرض التفاصيل

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

لا توجد بيانات عناصر لهذا الإصدار

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

Get دالة

Get the current value of the Field. The method is present only if Field.hasGetter ==TRUE, otherwise it is not present (shall not be generated)

ara::core::Future< FieldType > Get () noexcept;

GetE2EStateMachineStateGetter دالة

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Get()

ara::com::e2e::SMState GetE2EStateMachineStateGetter () const noexcept;

GetE2EStateMachineStateNotifier دالة

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()

ara::com::e2e::SMState GetE2EStateMachineStateNotifier () const noexcept;

GetE2EStateMachineStateSetter دالة

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Set()

ara::com::e2e::SMState GetE2EStateMachineStateSetter () const noexcept;

GetFreeSampleCount دالة

Query Free Sample Slots

std::size_t GetFreeSampleCount () const noexcept;

GetNewSamples دالة

Method to update the field notification cache.

template <typename F> ara::core::Result< std::size_t > GetNewSamples (F &&f, std::size_t max NumberOfSamples=std::numeric_limits< std::size_t >::max());

GetSubscriptionState دالة

Query ara::com::SubscriptionState, as per [SWS_CM_00310].

ara::com::SubscriptionState GetSubscriptionState () const noexcept;

Set دالة

Set a new value of the Field. The method is present only if Field.hasSetter==TRUE, otherwise it is not present (shall not be generated). There is no need to have Get method itself return [Application Errors] errors when getting a field value (as there are no errors possible when getting a field value). The Set-Method may return [Application Errors], but does so via returning a value different from the one passed in the request parameter.

ara::core::Future< FieldType > Set (<PFieldDerivedType> value) noexcept;

SetReceiveHandler دالة 2

Set/Register the Field notification receive handler

التحميلات الزائدة SetReceiveHandler 2

void SetReceiveHandler (ara::com::FieldReceiveHandler handler) noexcept; SWS_CM_11605

template <typename ExecutorT> void SetReceiveHandler (ara::com::FieldReceiveHandler handler, ExecutorT &&executor) noexcept;

SWS_CM_11611

SetSubscriptionStateChangeHandler دالة 2

Set ara::com::SubscriptionState change handler

التحميلات الزائدة SetSubscriptionStateChangeHandler 2

void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept; SWS_CM_11607

template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept;

SWS_CM_11608

SetTransportFaultConditionHandler دالة 2

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Proxy Field Notifier.

التحميلات الزائدة SetTransportFaultConditionHandler 2

void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept; SWS_CM_00109

template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept;

SWS_CM_00110

UnsetReceiveHandler دالة

Disable service field notification trigger

void UnsetReceiveHandler () noexcept;

UnsetSubscriptionStateChangeHandler دالة

Unset ara::com::SubscriptionState change handler

void UnsetSubscriptionStateChangeHandler () noexcept;

UnsetTransportFaultConditionHandler دالة

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Field Notifier.

void UnsetTransportFaultConditionHandler () noexcept;

Unsubscribe دالة

Method to unsubscribe from a service field notification. If the Field is not subscribed to at the time of the call, Unsubscribe() shall return without action.

void Unsubscribe () noexcept;

أسماء الأنواع البديلة

FieldType اسم نوع بديل

As per [SWS_CM_11402]

using FieldType = <PFieldCppidt>;

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الفئةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل صفحة الفئة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.جديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

توثيق الدوال

دالة Get [SWS_CM_00112] Upstream: RS_CM_00218, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

ara::core::Future< FieldType > Get () noexcept;

Get the current value of the Field. The method is present only if Field.hasGetter ==TRUE, otherwise it is not present (shall not be generated)

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الطريقة Get في نطاق الوكيل (proxy scope) <SI-Namespace>::proxy::fields::<Field> للاسترجاع غير المتزامن لقيمة الحقل الحالية ([SWS_CM_00112]؛ انظر أيضاً AUTOSAR_AP_EXP_ARAComAPI §6 «FieldGet»). تتوفر الدالة عبر ترويسة الوكيل <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h وتوجد فقط إذا تم تصميم Field.hasGetter == TRUE للحقل ([SWS_CM_00112]). وهي لا تأخذ أي معاملات وتُرجع ara::core::Future<FieldType>، والذي يحتوي على القيمة الحالية بعد النقل الناجح ([SWS_CM_00112]).

معالجة الأخطاء والشروط الحدية

تم تعريف الواجهة على أنها noexcept وآمنة من الاستثناءات ([SWS_CM_00112]). إذا فشلت العملية، يحتوي الـ ara::core::Future المرتجع على رمز خطأ بدلالات التراجع (rollback semantics) ([SWS_CM_00112]):

ComErrc::kCommunicationFailure: يُبلغ ربط الشبكة عن خطأ اتصال قابل للإصلاح أو فشل في الاتصال الآمن ([SWS_CM_00112]).
ComErrc::kMinimumSendIntervalViolationError: حدث طلب إرسال بسرعة أكبر مما يسمح به الحد الأدنى لفاصل الإرسال الزمني (minimumSendInterval) الذي تم تكوينه للعنصر ([SWS_CM_00112]).
InsufficientPermissionsViolation: يتم رفض التنفيذ بواسطة فرض المنح (Grant Enforcement) ([SWS_CM_00112]).

لا توجد أخطاء تطبيقية (Application Errors) لدالة الجلب (getter) ([SWS_CM_00113]).

تفاعل

من جانب الهيكل (skeleton)، تتطلب معالجة طلب دالة الجلب رد اتصال مسجلاً عبر RegisterGetHandler ([SWS_CM_00114]). يؤدي كل استدعاء لـ Get() إلى تنفيذ فحص شامل (E2E)؛ ويمكن الاستعلام عن حالة الحالة الناتجة عن ذلك بشكل متزامن من جانب الوكيل عبر GetE2EStateMachineStateGetter ([SWS_CM_00145]).

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على وثائق المواصفات.

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InsufficientPer- Refused by Grant Enforcement missionsViolation

Rückgabewert

Typ	Beschreibung
ara::core::Future< FieldType >	• If successful: an ara::core::Future containing a Field Type object as per [SWS_CM_11403] • If unsuccessful: an ara::core::Future containing a corresponding ara::core::FutureErrc

Fehler

Fehlercode	Beschreibung
ComErrc::kCommunicationFailure	rollback_semantics The network binding reported a recoverable communications error or a secure communication failure
ComErrc::kMinimumSendIntervalViolationError	rollback_semantics Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.

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

Record: AUTOSAR/AP/record/SWS_CM_00112
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00112@rel:R25-11#b2fd1f2e
Content hash: b2fd1f2e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00112

Status: valid/unmigrated Version: rel:R25-11#ec4a8dc1 Versionshistorie & Revisions (1 transition, 8 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_CM_00112@rel:R25-11#ec4a8dc1

Recorded Revisions (8):

R25-11rel:R25-11#0bc1ce772026-09-30
R19-11rel:R19-11#85c2390c2026-10-14
R20-11rel:R20-11#85c2390c2026-10-14
R21-11rel:R21-11#85c2390c2026-10-14
R22-11rel:R22-11#5a1fa5a12026-10-14
R23-11rel:R23-11#da1367322026-10-14
R24-11rel:R24-11#78164d832026-10-14
R25-11rel:R25-11#ec4a8dc12026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetE2EStateMachineStateGetter [SWS_CM_00145] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineStateGetter () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Get()

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
ara::com::e2e::SMState	State of the specific field class

Siehe auch: [SWS_CM_90417]

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

Record: AUTOSAR/AP/record/SWS_CM_00145
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00145@rel:R25-11#94d111f0
Content hash: 94d111f0
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00145

Status: valid/unmigrated Version: rel:R25-11#cd76263f Versionshistorie & Revisions (1 transition)

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_CM_00145@rel:R25-11#cd76263f

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetE2EStateMachineStateNotifier [SWS_CM_11612] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineStateNotifier () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
ara::com::e2e::SMState	State of the specific field class

Siehe auch: [SWS_CM_90417]

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

Record: AUTOSAR/AP/record/SWS_CM_11612
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11612@rel:R25-11#5b7dcc66
Content hash: 5b7dcc66
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11612

Status: valid/unmigrated Version: rel:R25-11#cf34f3ea 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_CM_11612@rel:R25-11#cf34f3ea

Recorded Revisions (3):

R25-11rel:R25-11#de1830f72026-09-30
R24-11rel:R24-11#22d8a9c22026-10-14
R25-11rel:R25-11#cf34f3ea2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetE2EStateMachineStateSetter [SWS_CM_00146] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineStateSetter () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Set()

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
ara::com::e2e::SMState	State of the specific field class

Siehe auch: [SWS_CM_90417]

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

Record: AUTOSAR/AP/record/SWS_CM_00146
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00146@rel:R25-11#270bd89d
Content hash: 270bd89d
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00146

Status: valid/unmigrated Version: rel:R25-11#beb55f07 Versionshistorie & Revisions (1 transition)

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_CM_00146@rel:R25-11#beb55f07

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetFreeSampleCount [SWS_CM_11603] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00139

std::size_t GetFreeSampleCount () const noexcept;

Query Free Sample Slots

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
std::size_t	The number of free/unused slots for field notification sample data in the local cache

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

Record: AUTOSAR/AP/record/SWS_CM_11603
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11603@rel:R25-11#2950195b
Content hash: 2950195b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11603

Status: valid/unmigrated Version: rel:R25-11#8c94be2d 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_CM_11603@rel:R25-11#8c94be2d

Recorded Revisions (3):

R25-11rel:R25-11#726052692026-09-30
R24-11rel:R24-11#6336d44d2026-10-14
R25-11rel:R25-11#8c94be2d2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetNewSamples [SWS_CM_11610] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139

template <typename F> ara::core::Result< std::size_t > GetNewSamples (F &&f, std::size_t max NumberOfSamples=std::numeric_limits< std::size_t >::max());

Method to update the field notification cache.

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	not exception safe

Template-Parameter

Parameter	Beschreibung
F	As per [SWS_CM_00701]

Parameter (in)

Parameter	Beschreibung
f	As per [SWS_CM_00701]
maxNumberOfSamples	As per [SWS_CM_00701]

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::size_t >	As per [SWS_CM_00701]

Fehler

Fehlercode	Beschreibung
ComErrc::kMaxSamplesExceeded	rollback_semantics As per [SWS_CM_00701]

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

Record: AUTOSAR/AP/record/SWS_CM_11610
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11610@rel:R25-11#c6727894
Content hash: c6727894
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11610

Status: valid/unmigrated Version: rel:R25-11#ad5c10b2 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_CM_11610@rel:R25-11#ad5c10b2

Recorded Revisions (3):

R25-11rel:R25-11#bd0fe9352026-09-30
R24-11rel:R24-11#3801b4392026-10-14
R25-11rel:R25-11#ad5c10b22026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة GetSubscriptionState [SWS_CM_11604] Upstream: RS_CM_00106

ara::com::SubscriptionState GetSubscriptionState () const noexcept;

Query ara::com::SubscriptionState, as per [SWS_CM_00310].

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
ara::com::SubscriptionState	The state of the subscription.

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

Record: AUTOSAR/AP/record/SWS_CM_11604
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11604@rel:R25-11#7be90981
Content hash: 7be90981
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11604

Status: valid/unmigrated Version: rel:R25-11#990d7855 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_CM_11604@rel:R25-11#990d7855

Recorded Revisions (3):

R25-11rel:R25-11#485e4d782026-09-30
R24-11rel:R24-11#de9197112026-10-14
R25-11rel:R25-11#990d78552026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Set [SWS_CM_00113] Upstream: RS_CM_00217, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00138

ara::core::Future< FieldType > Set (<PFieldDerivedType> value) noexcept;

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

يتم توفير الدالة Set في مساحة الأسماء <SI-Namespace>::proxy::fields::<Field> ولا تتاح إلا إذا تم تكوين Field.hasSetter == TRUE للحقل [SWS_CM_00113]. قبل الاستخدام، يجب تقديم مثيل الخدمة من جانب الخادم (OfferService()) والعثور عليه والاتصال به من جانب العميل ARAComAPI §4.2 «Means of Communication». يتم الاستدعاء بشكل غير متزامن: حيث يمرر قيمة الحقل الجديدة عبر المعامل value ويُرجع ara::core::Future<FieldType> [SWS_CM_00113]. تم تحديد الطريقة على أنها noexcept وتعتبر آمنة من الاستثناءات [SWS_CM_00113].

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

إذا فشل النقل، يتم توفير الخطأ المقابل عبر ara::core::Future المرتجع [SWS_CM_00113]:

ComErrc::kCommunicationFailure: يُبلغ عن خطأ اتصال قابل للإصلاح أو خلل في النقل الآمن؛ وفي حالة انتهاء المهلة، قد توجد حالة غير محددة على جانب الخادم بدون دلالات التراجع [SWS_CM_00113].
ComErrc::kMinimumSendIntervalViolationError: يحدث عندما يتم إرسال طلب إرسال بسرعة أكبر من الحد الأدنى لفاصل الإرسال الزمني المكوَّن (minimumSendInterval) (أيضًا بدون دلالات التراجع) [SWS_CM_00113].
تؤدي أذونات الوصول المفقودة إلى الرفض من خلال فرض المنح (Grant Enforcement) (InsufficientPermissionsViolation) [SWS_CM_00113].
لا تُنقل أخطاء التطبيق عبر الاستثناءات، بل من خلال إرجاع قيمة تختلف عن معامل الطلب في حالة نجاح الـ future [SWS_CM_00113].

التفاعل والتزامن

على جانب الخادم، يتوافق الاستدعاء مع رد اتصال على مثيل الهيكل (skeleton)، والذي يجب تسجيله مسبقًا باستخدام RegisterSetHandler [SWS_CM_00116] ARAComAPI §4.2 «Means of Communication». لمراقبة أمان نقل E2E على جانب العميل، يمكن الاستعلام عن حالة آلة حالة E2E لآخر استدعاء Set() عبر GetE2EStateMachineStateSetter() [SWS_CM_00146].

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

Parameter	Beschreibung
value	New value of field

Rückgabewert

Typ	Beschreibung
ara::core::Future< FieldType >	• If successful: an ara::core::Future containing a Field Type object as per [SWS_CM_11403] • If unsuccessful: an ara::core::Future containing a corresponding ara::core::FutureErrc

Fehler

Fehlercode	Beschreibung
ComErrc::kCommunicationFailure	no_rollback_semantics The network binding reported a recoverable communications error or a secure communication failure. In case of a communication timeout this could lead to an uncertain state on the remote server side.
ComErrc::kMinimumSendIntervalViolationError	no_rollback_semantics Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.

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

Record: AUTOSAR/AP/record/SWS_CM_00113
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00113@rel:R25-11#0801073a
Content hash: 0801073a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00113

Status: valid/unmigrated Version: rel:R25-11#46c10d7a Versionshistorie & Revisions (1 transition, 8 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_CM_00113@rel:R25-11#46c10d7a

Recorded Revisions (8):

R25-11rel:R25-11#9918c4b62026-09-30
R19-11rel:R19-11#73765f662026-10-14
R20-11rel:R20-11#73765f662026-10-14
R21-11rel:R21-11#73765f662026-10-14
R22-11rel:R22-11#fcbc0baa2026-10-14
R23-11rel:R23-11#009371872026-10-14
R24-11rel:R24-11#ae7474142026-10-14
R25-11rel:R25-11#46c10d7a2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetReceiveHandler [SWS_CM_11605] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120, RS_AP_00121

void SetReceiveHandler (ara::com::FieldReceiveHandler handler) noexcept;

Set/Register the Field notification receive handler

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تتوفر الدالة SetReceiveHandler في جانب الوكيل في مساحة الأسماء <SI-Namespace>::proxy::fields::<Field> عبر ملف الرأس <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h ([SWS_CM_11605]). وهي تسجل في جانب العميل دالة رد نداء للإشعارات عند تغير قيمة حقل ([SWS_CM_11605]). وتتبع هذه الآلية إجراء الإشعار الخاص بالأحداث، وبذلك تُخطر Communication Management العميل عند حدوث تحديثات (EXP_ARAComAPI §4.2 «Means of Communication»).

يتم تمرير ara::com::FieldReceiveHandler كمعلمة، وهو يمثل دالة بدون معلمات ([SWS_CM_11605]). ولا تُرجع الدالة أي قيمة (void) وهي محددة بأنها آمنة من الاستثناءات (noexcept) ([SWS_CM_11605]).

معالجة الأخطاء والتزامن

إذا كان كائن Callable الممرر غير موجود أو فارغًا (null)، تُبلغ الدالة عن الانتهاك InvalidHandlerViolation ([SWS_CM_11605]). وإذا كان ينبغي تنفيذ المعالج في سياق تنفيذ محدد، فإن متغير القالب مع ExecutorT يكون متاحًا ([SWS_CM_11611]).

تفاعل

يتوافق السلوك مع تسجيلات المعالجات الخاصة بالأحداث ([SWS_CM_00181]) والمشغلات ([SWS_CM_00250]). ويُرجح أن إلغاء التسجيل يتم عبر UnsetReceiveHandler() اتباعًا لنمط واجهة فئة الوكيل (EXP_ARAComAPI §5.3.1 «Proxy Class API’s»). سؤال Q-74cd83b99aadec16 (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويُستخدم كدليل توجيهي. المرجع المعتمد هو مواصفة AUTOSAR الرسمية.

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

Parameter	Beschreibung
handler	The handler that shall be called by Communication Management upon notification arrival. The FieldReceiveHandler constitutes a function without parameters and has to use the f method of the specific Field class to access the retrieved event data. See [SWS_CM_11615] for its definition.

Rückgabewert

Typ	Beschreibung
None

Siehe auch: [SWS_CM_00181], [SWS_CM_00250], [SWS_CM_11356]

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

Record: AUTOSAR/AP/record/SWS_CM_11605
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11605@rel:R25-11#2938b271
Content hash: 2938b271
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11605

Status: valid/unmigrated Version: rel:R25-11#86f81336 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_CM_11605@rel:R25-11#86f81336

Recorded Revisions (3):

R25-11rel:R25-11#03682cbd2026-09-30
R24-11rel:R24-11#8bb5f2572026-10-14
R25-11rel:R25-11#86f813362026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetReceiveHandler [SWS_CM_11611] Upstream: RS_CM_00211, RS_AP_00151, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetReceiveHandler (ara::com::FieldReceiveHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_11605] but the handler shall execute in a provided context

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

دالة القالب SetReceiveHandler هي جزء من فئة الوكيل class <SI-Namespace>::proxy::fields::<Field> ([SWS_CM_11611]؛ ملف الرأس #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"). وتُستخدم في جانب العميل لتسجيل معالج استقبال للإشعارات عند تغير قيمة حقل ما (AUTOSAR_AP_EXP_ARAComAPI §4.2 «Means of Communication»، [SWS_CM_11605]). ويتم عبر المعلمات تمرير كائن قابل للاستدعاء handler من النوع ara::com::FieldReceiveHandler بالإضافة إلى سياق تنفيذ executor كمرجع عام ExecutorT&& ([SWS_CM_11611]). ولا تمتلك الدالة أي قيمة إرجاع (void).

معالجة الأخطاء والأمان من الاستثناءات

تم التصريح عن الأسلوب بصفة noexcept وتحديده بأنه آمن من الاستثناءات (exception safe) ([SWS_CM_11611]). وإذا كان الـ Callable الممرر handler غير موجود أو فارغًا (null)، فإن ذلك يُعد InvalidHandlerViolation ([SWS_CM_11611]). لذلك، يجب على الجهات المستدعية التأكد من توفير دالة صالحة أو كائن دالة صالح قبل الاستدعاء.

التزامن والتفاعل

على عكس التسجيل القياسي بدون منفذ ([SWS_CM_11605])، تتم معالجة دالة رد النداء عند ورود إشعار الحقل في سياق التنفيذ المقدم بواسطة executor ([SWS_CM_11611]). التفسير: يُرجح أن يحقق ذلك فكًا للارتباط، بحيث لا تتم معالجة البيانات الخاصة بالتطبيق في سياقات تنفيذ مؤشرات الترابط الداخلية للبرمجية الوسيطة. سؤال Q-cbe1af19bea15a88 (مفتوح) وتنتمي الطريقة إلى واجهات برمجة تطبيقات فئة الوكيل (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s») وتتبع نفس النمط الخاص بمتغيرات المنفذ للأحداث ([SWS_CM_11356] استنادًا إلى [SWS_CM_00181]) والمشغلات ([SWS_CM_00352] استنادًا إلى [SWS_CM_00250]).

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

Parameter	Beschreibung
ExecutorT	As per [SWS_CM_11360]

Parameter (in)

Parameter	Beschreibung
handler	As per [SWS_CM_11605]
executor	As per [SWS_CM_11360]

Rückgabewert

Typ	Beschreibung
None

Siehe auch: [SWS_CM_11605], [SWS_CM_00250], [SWS_CM_11356]

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

Record: AUTOSAR/AP/record/SWS_CM_11611
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11611@rel:R25-11#c06a521c
Content hash: c06a521c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11611

Status: valid/unmigrated Version: rel:R25-11#b32e3974 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_CM_11611@rel:R25-11#b32e3974

Recorded Revisions (3):

R25-11rel:R25-11#7debf3322026-09-30
R24-11rel:R24-11#2328e4dd2026-10-14
R25-11rel:R25-11#b32e39742026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetSubscriptionStateChangeHandler [SWS_CM_11607] Upstream: RS_CM_00106

void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept;

Set ara::com::SubscriptionState change handler

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تسجل الدالة SetSubscriptionStateChangeHandler على حقل وكيل (النطاق <SI-Namespace>::proxy::fields::<Field>) رد نداء محدد من قِبل المستخدم، والذي يستدعيه Communication Management بمجرد تغير حالة الاشتراك (ara::com::SubscriptionState) للحقل ([SWS_CM_11607]، [SWS_CM_00333]). يتم الاستدعاء بشكل متزامن ولا يُرجع أية قيمة ([SWS_CM_11607]). وتُعد من واجهات الوكيل المركزية لإدارة اشتراكات الأحداث والحقول (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s»).

فيما يتعلق بمعالجة الأخطاء، تم تحديد دالة التسجيل على أنها exception safe وأُعلن عنها باستخدام noexcept ([SWS_CM_11607]). وإذا كان الكائن القابل للاستدعاء المُمرر handler غير موجود أو كان null، فإن ذلك يُعد انتهاكًا للمواصفة في صورة InvalidHandlerViolation ([SWS_CM_11607]).

في إطار التفاعل المتبادل مع إنشاء الاتصال، تجدر الإشارة إلى أنه يجب مبدئيًا اعتبار Subscribe() عملية غير متزامنة ([SWS_CM_12006]). ولذلك، لا يجوز للتطبيقات افتراض نجاح الاشتراك حتى بعد العودة الخالية من الأخطاء لـ Subscribe() إلا بعد أن يشير المُعالج المسجل إلى الحالة kSubscribed ([SWS_CM_12006]). بالإضافة إلى ذلك، يستدعي Communication Management المُعالج بالقيمة kSubscriptionPending إذا تعذر إتمام الربط الفعلي على الفور أو عند تعطل مثيل الخادم على سبيل المثال نتيجة لإعادة التشغيل أو خطأ في الشبكة ([SWS_CM_00313]). وإذا كان مطلوبًا تنفيذ المُعالج في سياق تنفيذ محدد، فإن المتغير القالبي المحمل تحميلاً زائدًا مع ExecutorT يكون متاحًا لهذا الغرض ([SWS_CM_11608]).

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

Parameter	Beschreibung
handler	As per [SWS_CM_00333]

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_11607
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11607@rel:R25-11#f6ac809e
Content hash: f6ac809e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11607

Status: valid/unmigrated Version: rel:R25-11#ab897290 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_CM_11607@rel:R25-11#ab897290

Recorded Revisions (3):

R25-11rel:R25-11#ad5e599c2026-09-30
R24-11rel:R24-11#13e960cd2026-10-14
R25-11rel:R25-11#ab8972902026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetSubscriptionStateChangeHandler [SWS_CM_11608] Upstream: RS_CM_00211, RS_AP_00151, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_11607] but the handler shall execute in a provided context

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم دالة القالب SetSubscriptionStateChangeHandler في مساحة الأسماء <SI-Namespace>::proxy::fields::<Field> لتسجيل دالة رد نداء لمراقبة تغيرات حالة اشتراك حقل ما ([SWS_CM_11608]). وهي توسع السلوك الأساسي من [SWS_CM_11607] من حيث أن المعالج المسجل يتم تنفيذه في سياق تنفيذ ممرر صراحة (executor) ([SWS_CM_11608]).

يستقبل الأسلوب معلمتين ([SWS_CM_11608]):

handler: دالة رد النداء المراد استدعاؤها من النوع ara::com::SubscriptionStateChangeHandler ([SWS_CM_11354])، والتي يتم إطلاقها بمجرد أن تتغير ara::com::SubscriptionState ([SWS_CM_00333]).
executor: مرجع إعادة توجيه من النوع ExecutorT&& ([SWS_CM_11360])، والذي يوفر السياق لتنفيذ المعالج ([SWS_CM_11608]).

لا تُرجع الدالة أي قيمة (void) ومُصرح عنها بصفة noexcept ([SWS_CM_11608]). وهي محددة بأنها exception safe ([SWS_CM_11608]). وحُدد InvalidHandlerViolation كانتهاك في حال كان الـ Callable الممرر غير موجود أو null ([SWS_CM_11608]).

التفسير: من خلال تمرير executor، يُرجح نقل تنفيذ المعالج من السياق الداخلي لإدارة الاتصال إلى سياق مؤشر ترابط التطبيق أو سياق مهامه. سؤال Q-647f618545799c4e (مفتوح) وفي إطار تضافر واجهات برمجة تطبيقات الوكيل (Proxy-APIs)، ينضم الاستدعاء إلى أساليب مثل Subscribe() و Unsubscribe() و UnsetSubscriptionStateChangeHandler() (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s»). وتوجد متغيرات محملة بحمل زائد مماثلة مع سياق تنفيذ لأحداث الوكيل ([SWS_CM_11354]) وكذلك مشغلات الوكيل ([SWS_CM_01106]).

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

Parameter	Beschreibung
ExecutorT	As per [SWS_CM_11360]

Parameter (in)

Parameter	Beschreibung
handler	As per [SWS_CM_11354]
executor	As per [SWS_CM_11360]

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_11608
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11608@rel:R25-11#3dddebcf
Content hash: 3dddebcf
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11608

Status: valid/unmigrated Version: rel:R25-11#d63fd7bc 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_CM_11608@rel:R25-11#d63fd7bc

Recorded Revisions (3):

R25-11rel:R25-11#27b2d6982026-09-30
R24-11rel:R24-11#9fc7873d2026-10-14
R25-11rel:R25-11#d63fd7bc2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetTransportFaultConditionHandler [SWS_CM_00109] Upstream: RS_CM_00224, RS_E2E_08534

void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept;

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Proxy Field Notifier.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام وسياق الاستدعاء

تُستخدم دالة العضو SetTransportFaultConditionHandler لتسجيل معالج أخطاء لجهاز إشعار حقل الوكيل في مساحة الاسم <SI-Namespace>::proxy::fields::<Field> [SWS_CM_00109]. ويتم تمرير كائن قابل للاستدعاء (Callable) من النوع ara::com::e2e::TransportFaultConditionHandler كمعلمة. ولا تُرجع الدالة أي قيمة وتربط رد الاتصال بأجهزة الإشعار لمثيلات الخدمة الفردية لتلقي أخطاء الإرسال من الواجهة الخلفية للاتصالات AUTOSAR_AP_SWS_CommunicationManagement §7.4 «End-to-end communication protection» ص. 235.

معالجة الأخطاء والأمان من الاستثناءات

تم التصريح عن الطريقة كـ noexcept ومحددة بأنها آمنة من الاستثناءات (exception safe) [SWS_CM_00109]. وإذا كان الكائن القابل للاستدعاء الممرر غير صالح أو فارغًا (null)، فإن هناك انتهاكًا للشرط المسبق في صورة InvalidHandlerViolation [SWS_CM_00109]. تفسير: نظرًا لأنه لا يُسمح للدالة بإطلاق استثناءات، فمن المرجح أن يؤدي مثل هذا الانتهاك في AUTOSAR Adaptive عادةً إلى إنهاء البرنامج فورًا. سؤال Q-74df6934d4ae3c93 (مفتوح)

التزامن والتفاعل

بينما تسجل هذه الصيغة الأساسية المعالج مباشرةً، توجد صيغة قالب ذات تحميل زائد مع [SWS_CM_00110] تقبل بالإضافة إلى ذلك منفذًا (ExecutorT&& executor) لتحديد سياق التنفيذ غير المتزامن. وتندمج الدالة في معالجة الأخطاء من طرف إلى طرف (End-to-End): فبينما تبلّغ أجهزة الإشعار ([SWS_CM_00109]، [SWS_CM_00110]) والأحداث ([SWS_CM_00099]) والمشغلات ([SWS_CM_00106]) عن أخطاء الإرسال بشكل غير متزامن عبر هذه المعالجات، يتم بدلاً من ذلك الإبلاغ عن أخطاء النقل في طلبات الطرق ودوال getter وsetter عبر ComErrc::kCommunicationFailure في ara::core::Future الناتج [SWS_CM_00090].

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

Parameter	Beschreibung
handler	Handler of type ara::com::e2e:: TransportFaultConditionHandler to be set

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_00109
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00109@rel:R25-11#d92f1bf6
Content hash: d92f1bf6
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00109

Status: valid/unmigrated Version: rel:R25-11#989525ac 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_CM_00109@rel:R25-11#989525ac

Recorded Revisions (3):

R25-11rel:R25-11#57896b862026-09-30
R24-11rel:R24-11#1aaf6ef92026-10-14
R25-11rel:R25-11#989525ac2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة SetTransportFaultConditionHandler [SWS_CM_00110] Upstream: RS_CM_00224, RS_E2E_08534

template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept;

Execution Context overload for hierarchicalnamespacelistlowerproxy::proxy:: fields::fieldname::SetTransportFaultConditionHandler for a given Proxy Field Notifier.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم دالة القالب العضو SetTransportFaultConditionHandler ضمن نطاق فئة حقل Proxy (<SI-Namespace>::proxy::fields::<Field>) لتسجيل معالج لمنبه الحقل المعني [SWS_CM_00110]. وهي تستقبل معلمتَي إدخال:

handler: الكائن القابل للاستدعاء المراد تسجيله من النوع ara::com::e2e::TransportFaultConditionHandler [SWS_CM_00110].
executor: مرجع rvalue لكائن مُنفِّذ (ExecutorT&&)، يتم في سياق تنفيذه بدء أي عمليات حسابية مطلوبة بشكل غير متزامن [SWS_CM_00110].

لا تُرجع الدالة أي قيمة (void) ومُعلنة بصفتها noexcept [SWS_CM_00110].

معالجة الأخطاء وأمان التنفيذ

تم تحديد الواجهة بأنها آمنة من الاستثناءات (exception safe) [SWS_CM_00110]. إذا مُرِّر كائن قابل للاستدعاء غير موجود أو بقيمة خالية كـ handler، فسيؤدي ذلك إلى InvalidHandlerViolation [SWS_CM_00110]. يتم الإبلاغ عن حالات محددة لأخطاء النقل عبر هذا المعالج، في حين تشير الدوال وغيتِرات وسِتِرات الحقول إلى أي أخطاء نقل عبر ComErrc::kCommunicationFailure في كائنات Future المرجعة الخاصة بكل منها [SWS_CM_00090].

التزامن والتفاعل

تمثل الدالة التحميل الزائد لسياق التنفيذ بالنسبة للدالة الأساسية الأقل معلمات [SWS_CM_00109]. ومن خلال كائن المُنفِّذ المُمرَّر، تفصل عملية التنفيذ بين تنفيذ المعالج وسياق الاستقبال الداخلي لإدارة الاتصالات (Communication Management) [SWS_CM_00110]. وتتوفر تحميلات زائدة مماثلة لأحداث Proxy [SWS_CM_00100]، ومُشغِّلات Proxy [SWS_CM_00107]، وكذلك لدوال Skeleton [SWS_CM_00094] وحقول Skeleton [SWS_CM_00097]. تفسير: يُرجَّح أن يتم الاستدعاء بشكل معقول قبل ورود إشعارات المنبه أو قبل الاشتراك في المنبه، لضمان مراقبة شاملة للأخطاء. سؤال Q-bc5c62dd39c09029 (مفتوح)

تم توليد إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

Parameter	Beschreibung
handler	Handler to be set
executor	Executor object in which any asynchronous computation spawn shall be invoked

Rückgabewert

Typ	Beschreibung
None

Siehe auch: [SWS_CM_00109]

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

Record: AUTOSAR/AP/record/SWS_CM_00110
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00110@rel:R25-11#3c6a8ec6
Content hash: 3c6a8ec6
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00110

Status: valid/unmigrated Version: rel:R25-11#9be0f9ef 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_CM_00110@rel:R25-11#9be0f9ef

Recorded Revisions (3):

R25-11rel:R25-11#b46bf6592026-09-30
R24-11rel:R24-11#e56df0462026-10-14
R25-11rel:R25-11#9be0f9ef2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Subscribe [SWS_CM_11601] Upstream: RS_CM_00103

ara::core::Result< void > Subscribe (std::size_t maxSampleCount) noexcept;

Method to subscribe to a service field notification. If the Field is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSample Count value is the same as for the current subscription, the method shall return without action.

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يُستخدم التابع Subscribe للاشتراك في إشعارات لحقل تابع لنسخة وكيل خدمة في النطاق proxy::fields::<Field> ([SWS_CM_11601]). تحدد التطبيقات عبر المعلمة maxSampleCount الحد الأقصى لعدد عينات البيانات التي ترغب في الاحتفاظ بها في الوقت نفسه، وبذلك تقوم بإعداد ذاكرة التخزين المؤقت المحلية للاستلام ([SWS_CM_11601]، EXP ARAComAPI §5.3 «Proxy Class API’s»). الاستدعاء غير متزامن: تشير القيمة المُرجعة ara::core::Result<void> فقط إلى قبول الاشتراك بواسطة Communication Management (EXP ARAComAPI §5.3.5.2 «Monitoring Event Subscription»).

فيما يتعلق بسلوك الحالة ومعالجة الأخطاء، تنطبق القواعد التالية:

الجمود الفعّال (Idempotence): إذا كان الحقل بالفعل في الحالة kSubscribed أو kSubscriptionPending وتطابقت القيمة الممررة maxSampleCount مع قيمة الاشتراك الحالي، فإن التابع يعود دون أي تأثير ([SWS_CM_11601]).
رموز الأخطاء: إذا تعذر توفير ذاكرة التخزين المؤقت المطلوبة، تفشل العملية بالخطأ ComErrc::kMaxSampleCountNotRealizable ([SWS_CM_11601]، [SWS_CM_10432]).
التحقق من الصلاحيات: إذا كانت الأذونات المطلوبة مفقودة، يتم رفض الاستدعاء بواسطة Grant Enforcement باستخدام InsufficientPermissionsViolation ([SWS_CM_11601]).

تم التصريح عن التابع كـ noexcept وتحديده على أنه آمن من الاستثناءات (Exception-safe) ([SWS_CM_11601]). من الناحية الدلالية، يتبع سلوك الاشتراك في الحدث ([SWS_CM_00141])؛ وتُشكل ذاكرة التخزين المؤقت المهيأة الأساس لاستقبال العينات اللاحق عبر توابع مثل GetNewSamples ([SWS_CM_00701]).

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe
Verletzungen (Violations)	InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

Parameter	Beschreibung
maxSampleCount	As per [SWS_CM_00141]

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	As per [SWS_CM_00141]

Fehler

Fehlercode	Beschreibung
ComErrc::kMaxSampleCountNotRealizable	rollback_semantics As per [SWS_CM_00141]

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

Record: AUTOSAR/AP/record/SWS_CM_11601
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11601@rel:R25-11#31261904
Content hash: 31261904
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11601

Status: valid/unmigrated Version: rel:R25-11#ae9652a7 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_CM_11601@rel:R25-11#ae9652a7

Recorded Revisions (3):

R25-11rel:R25-11#4d27d6072026-09-30
R24-11rel:R24-11#19da91452026-10-14
R25-11rel:R25-11#ae9652a72026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة UnsetReceiveHandler [SWS_CM_11606] Upstream: RS_CM_00203

void UnsetReceiveHandler () noexcept;

Disable service field notification trigger

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة UnsetReceiveHandler() على مستوى الوكيل لإلغاء تسجيل معالج استلام تم تسجيله مسبقاً لإشعارات الحقل ([SWS_CM_11606]). تنتمي إلى واجهات برمجة التطبيقات لفئة الوكيل الخاصة بـ ara::com (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s») وتقع في مساحة الاسم <SI-Namespace>::proxy::fields::<Field> ([SWS_CM_11606]).

فيما يتعلق بسياق الاستدعاء ودلالاته، لا تقبل الطريقة أية معلمات ولا تُرجع أية قيمة ([SWS_CM_11606]). ومن خلال هذا الاستدعاء، يمكن للتطبيق التبديل في أي وقت من نموذج الإشعار الموجه بالأحداث إلى نمط الاستطلاع القائم على الاستعلام، وذلك عن طريق سحب رد النداء المخصص للمستخدم (AUTOSAR_AP_EXP_ARAComAPI §5.3.2 «RadarService Proxy Class Example»).

بالنسبة لمعالجة الأخطاء، تم تحديد الدالة على أنها noexcept وكذلك exception safe ([SWS_CM_11606])؛ ووفقًا للمواصفة، لا توجد رموز أخطاء محددة. يتم الاستدعاء بشكل متزامن؛ وبعد السحب الناجح للمُعالج، لا يُطلق Communication Management أية استدعاءات رد نداء إضافية عند ورود بيانات جديدة (تفسير: من المرجح أن تكتمل عمليات التنفيذ الجارية أو المجدولة مسبقًا أو تُعالج تسلسليًا قبل السحب، نظرًا لأن استدعاءات رد النداء عبر Communication Management يجب أن تتم تسلسليًا؛ قارن AUTOSAR_AP_EXP_ARAComAPI §5.3.2 «RadarService Proxy Class Example»). سؤال Q-fbc65e80b8d8be38 (مفتوح)

في إطار التفاعل المتبادل، تتطابق الطريقة مع تعطيل المشغلات عند أحداث الخدمة ([SWS_CM_00183]؛ AUTOSAR_AP_EXP_ARAComAPI §10) والمشغلات ([SWS_CM_11614]). وفي ربط DDS، يتم تمثيل السلوك عبر تعيين UnsetReceiveHandler() إلى DataReader المعني ([SWS_CM_11141]).

أُنشئت هذه الملاحظة بواسطة ذكاء اصطناعي بناءً على قاعدة بيانات AUTOSAR R25-11.

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_11606
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11606@rel:R25-11#f7808708
Content hash: f7808708
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11606

Status: valid/unmigrated Version: rel:R25-11#16565755 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_CM_11606@rel:R25-11#16565755

Recorded Revisions (3):

R25-11rel:R25-11#e89f906f2026-09-30
R24-11rel:R24-11#d180a3442026-10-14
R25-11rel:R25-11#165657552026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة UnsetSubscriptionStateChangeHandler [SWS_CM_11609] Upstream: RS_CM_00106, RS_AP_00114, RS_AP_00120

void UnsetSubscriptionStateChangeHandler () noexcept;

Unset ara::com::SubscriptionState change handler

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

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة UnsetSubscriptionStateChangeHandler في إطار AUTOSAR Adaptive Platform لإزالة دالة رد نداء مسجلة مسبقاً لتغييرات حالة اشتراك (ara::com::SubscriptionState) حقل ما [SWS_CM_11609]. يتم استدعاؤها بشكل متزامن على نُسخ حقول وكيل الخدمة في مساحة الأسماء <SI-Namespace>::proxy::fields::<Field> وتتطلب تضمين الترويسة المُنشأة #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" AUTOSAR_AP_SWS_CommunicationManagement §8.3.3.2.4.5 «UnsetSubscriptionStateChangeHandler». لا يقبل هذا الاستدعاء أي معاملات تمرير ولا يُرجع أي قيمة.

معالجة الأخطاء والتزامن

تم التصريح عن الواجهة بأنها noexcept وتلبي وفقاً للمواصفة خاصية exception safe [SWS_CM_11609]. وبالتالي فإن حدوث أخطاء أو استثناءات أمر مستبعد. ونظراً لأن إلغاء التسجيل يسري مفعوله على الفور، يُفترض (تفسير) عدم تمرير أي إشعارات جديدة إلى المعالج السابق بعد انتهاء الدالة. سؤال Q-30238329b76b64f4 (مفتوح)

تفاعل

تنتمي الدالة إلى واجهات برمجة التطبيقات الأساسية لفئة الوكيل لإدارة الاشتراكات في ara::com AUTOSAR_AP_EXP_ARAComAPI §5.3.1 «Proxy Class API’s». وتوجد دوال مماثلة لتعطيل معالجات تغيير الحالة لأحداث الوكيل [SWS_CM_00334] ومُطلِقاته [SWS_CM_01108]، وبالمثل على جانب الهيكل الأساسي (Skeleton) للأحداث [SWS_CM_12010] والمُطلِقات [SWS_CM_01112].

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_11609
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11609@rel:R25-11#51c87672
Content hash: 51c87672
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11609

Status: valid/unmigrated Version: rel:R25-11#1abd2b15 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_CM_11609@rel:R25-11#1abd2b15

Recorded Revisions (3):

R25-11rel:R25-11#0c91f75a2026-09-30
R24-11rel:R24-11#678da2882026-10-14
R25-11rel:R25-11#1abd2b152026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة UnsetTransportFaultConditionHandler [SWS_CM_00126] Upstream: RS_CM_00224, RS_E2E_08534

void UnsetTransportFaultConditionHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Field Notifier.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c996ada4784f المصدر أسئلة مفتوحة (2)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الدالة UnsetTransportFaultConditionHandler لإلغاء تسجيل ara::com::e2e::TransportFaultConditionHandler تم تسجيله مسبقًا لمنبه حقل Proxy معين [SWS_CM_00126]. وهي معرّفة ضمن النطاق <SI-Namespace>::proxy::fields::<Field> ويتم تضمينها عبر ملف الترويسة <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h AUTOSAR_AP_SWS_CommunicationManagement §8.3.3.2.1.4 «UnsetTransportFaultConditionHandler». ويتم الاستدعاء دون معلمات ولا تُرجع أي قيمة (void).

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

تم الإعلان عن الدالة بصفتها noexcept وتتمتع بضمانة الأمان من الاستثناءات exception safe [SWS_CM_00126]. ولا يتم إرجاع رموز خطأ أو طرح استثناءات. وإذا لم يكن هناك معالج مسجل مسبقًا، يُرجَّح أن الاستدعاء المتكرر سيبقى دون أي تأثير. سؤال Q-85da9a7b00678748 (مفتوح)

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

لا تحدد المواصفة أي متطلبات خاصة بالتزامن أو أمان الخيوط (Thread Safety). وبما أن الواجهة تعمل بشكل متزامن ولا تستخدم أنواعًا غير متزامنة، فيُرجَّح أن سحب معالج الأخطاء يسري بشكل متزامن وفوري. سؤال Q-ed4cc712bb55aee5 (مفتوح) وينبغي لجهات الاستدعاء تنسيق الاستدعاء في دورة حياة التطبيق بحيث لا تتم معالجة إشعارات المنبه لمثيلات الخدمة الفردية بشكل غير خاضع للرقابة دون وجود معالج AUTOSAR_AP_SWS_CommunicationManagement §7.4.1 «End-to-end communication protection for SOMEIP».

تفاعل

يتبع إلغاء التسجيل نمط تسمية ووظائف متسقًا في AUTOSAR Adaptive:

على مستوى Proxy، تتوفر دوال مكافئة للأحداث ([SWS_CM_00105]) وكذلك للمُشغِّلات ([SWS_CM_00108]).
على مستوى Skeleton، تتوفر نظائر مقابلة لغيتِرات وسِتِرات الحقول ([SWS_CM_00098]) وكذلك بشكل عام لكافة دوال واجهة Skeleton ([SWS_CM_00095]).

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

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

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_00126
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00126@rel:R25-11#2d482c7e
Content hash: 2d482c7e
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00126

Status: valid/unmigrated Version: rel:R25-11#34c05de8 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_CM_00126@rel:R25-11#34c05de8

Recorded Revisions (3):

R25-11rel:R25-11#b31fdb2c2026-09-30
R24-11rel:R24-11#00a5c4a32026-10-14
R25-11rel:R25-11#34c05de82026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

دالة Unsubscribe [SWS_CM_11602] Upstream: RS_CM_00104

void Unsubscribe () noexcept;

Method to unsubscribe from a service field notification. If the Field is not subscribed to at the time of the call, Unsubscribe() shall return without action.

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheit	exception safe

Rückgabewert

Typ	Beschreibung
None

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

Record: AUTOSAR/AP/record/SWS_CM_11602
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11602@rel:R25-11#120dacda
Content hash: 120dacda
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11602

Status: valid/unmigrated Version: rel:R25-11#77e3e54d 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_CM_11602@rel:R25-11#77e3e54d

Recorded Revisions (3):

R25-11rel:R25-11#0705e32a2026-09-30
R24-11rel:R24-11#af6d228d2026-10-14
R25-11rel:R25-11#77e3e54d2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

توثيق أسماء الأنواع البديلة

اسم نوع بديل FieldType [SWS_CM_11403] Upstream: RS_CM_00216, RS_AP_00114

using FieldType = <PFieldCppidt>;

As per [SWS_CM_11402]

Header-Datei	#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scope	class <SI-Namespace>::proxy::fields::<Field>
Symbol	FieldType

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

Record: AUTOSAR/AP/record/SWS_CM_11403
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11403@rel:R25-11#45ceac9b
Content hash: 45ceac9b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11403

Status: valid/unmigrated Version: rel:R25-11#cc450956 Versionshistorie & Revisions (1 transition, 5 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_CM_11403@rel:R25-11#cc450956

Recorded Revisions (5):

R25-11rel:R25-11#926271042026-09-30
R22-11rel:R22-11#8ef005dd2026-10-14
R23-11rel:R23-11#8ef005dd2026-10-14
R24-11rel:R24-11#46a194152026-10-14
R25-11rel:R25-11#cc4509562026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

فئة <SI-Namespace>::proxy::fields::<Field>

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

السياق

دورة الحياة

مسار الاستخدام

سيناريوهات الأخطاء

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

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

أسماء الأنواع البديلة

مخطط الفئة

عرض التفاصيل

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

أسماء الأنواع البديلة

توثيق الدوال

دالة Get [SWS_CM_00112] Upstream: RS_CM_00218, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

الاستخدام

معالجة الأخطاء والشروط الحدية

تفاعل

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetE2EStateMachineStateGetter [SWS_CM_00145] Upstream: RS_CM_00224, RS_E2E_08534

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetE2EStateMachineStateNotifier [SWS_CM_11612] Upstream: RS_CM_00224, RS_E2E_08534

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetE2EStateMachineStateSetter [SWS_CM_00146] Upstream: RS_CM_00224, RS_E2E_08534

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetFreeSampleCount [SWS_CM_11603] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00139

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetNewSamples [SWS_CM_11610] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139

Template-Parameter

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetSubscriptionState [SWS_CM_11604] Upstream: RS_CM_00106

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Set [SWS_CM_00113] Upstream: RS_CM_00217, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00138

الاستخدام وسياق الاستدعاء

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

التفاعل والتزامن

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetReceiveHandler [SWS_CM_11605] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120, RS_AP_00121

الاستخدام وسياق الاستدعاء

معالجة الأخطاء والتزامن

تفاعل

Parameter (in)

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release: