DEENESPTFRRUARHIKOZHNL

structure ara::diag::SovdBulkData::DeletionError

[SWS_DM_01844] Upstream: RS_Diag_04266

struct DeletionError {...};

Definition of DeletionError for a single bulk-data instance.

Header-Datei#include "ara/diag/sovd_bulk_data.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopeclass ara::diag::SovdBulkData

Guide utilisateurGÉNÉRÉ PAR IA

Encapsule les métadonnées et la cause d'erreur d'un objet de données de masse individuel dont la suppression a échoué.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 6e6e835c2f85 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Encapsule les métadonnées et la cause d'erreur d'un objet de données de masse individuel dont la suppression a échoué.

La structure [SWS_DM_01844] représente le résultat d'erreur lors d'une opération de suppression défaillante d'un objet de données de masse individuel dans le module de diagnostic SOVD (AUTOSAR_AP_SWS_Diagnostics §8.53.4 « Struct: DeletionError »). Elle associe les métadonnées de l'élément de données non supprimé item au code d'erreur survenu error [SWS_DM_01845], [SWS_DM_01846]. En tant qu'objet-valeur pur, elle sert à l'appelant pour l'identification ciblée et l'analyse de cause des nettoyages défaillants.

Contexte

La structure de données [SWS_DM_01844] décrit une erreur individuelle qui survient pendant l'opération de suppression de données de masse (Bulk Data) au sein du framework SOVD (Service-Oriented Vehicle Diagnostics) d'AUTOSAR Adaptive (AUTOSAR_AP_SWS_Diagnostics §8.53.4 « Struct: DeletionError »). En tant que composant de l'interface ara::diag::SovdBulkData, la structure sert à établir, lors d'actions de nettoyage ou de suppression défaillantes, une correspondance précise entre l'élément de données concerné et la cause de l'erreur. Elle relie ainsi le descripteur de métadonnées du fichier non supprimable à un code d'erreur AUTOSAR standardisé.

L'interaction a lieu principalement entre le serveur de diagnostic ou le composant ara::diag::SovdBulkData qui exécute la suppression, et la logique de diagnostic ou d'application appelante. Cette dernière demande le nettoyage de données en masse et reçoit des retours en cas d'erreur afin de déterminer quels enregistrements spécifiques n'ont pas pu être supprimés et pourquoi. L'interaction des composants impliqués et le renvoi de l'objet d'erreur lors d'une tentative de suppression sont représentés dans le diagramme de séquence suivant.

Déroulement du traitement des erreurs lors de la suppression de données en masseClientSovdBulkDataDemander une tâche de suppression de données en masseÉchec de la tentative de suppression d'un élément de donnéesRetour de DeletionError (item, error)Évaluation de item et error (ara::core::ErrorCode)

Diagramme de séquence : déroulement typique d'une suppression de données de masse défaillante avec renvoi de DeletionError. Sources : [SWS_DM_01844], [SWS_DM_01845], [SWS_DM_01846], AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 « Public Member Variables »

Cycle de vie

La structure [SWS_DM_01844] est conçue comme un objet-valeur pur (Plain Old Data / type valeur). Son instanciation a lieu du côté de l'infrastructure de diagnostic précisément lorsqu'une erreur est constatée lors du traitement d'un ordre de suppression pour un élément de données de masse déterminé. Le champ item est alors initialisé avec le BulkDataMetaDataDescriptor correspondant [SWS_DM_01845] et le champ error avec le code d'erreur spécifique ara::core::ErrorCode [SWS_DM_01846].

En ce qui concerne les relations de propriété, l'instance (ou une collection de telles instances) passe typiquement dans la propriété de l'appelant en tant que valeur de retour ou au sein d'un conteneur d'erreurs. Interprétation : la structure ne possède pas de ressources à longue durée de vie propres ni de threads actifs ; son cycle de vie est directement lié à la portée (scope) du bloc de traitement d'erreurs appelant ou du conteneur de résultats. Question Q-60f135b9e36d7083 (ouverte) Après évaluation par l'application, la structure est détruite par défaut sur la pile ou dans le tas avec ses variables membres. Puisqu'il s'agit d'un paquet de données passif, aucune transition d'état interne ni aucune exigence de synchronisation concurrente ne survient au sein de la structure.

Parcours d'utilisation

Dans le cas d'application régulier, un composant de diagnostic ou un client SOVD initie la suppression d'un ou de plusieurs objets de données de masse via l'interface SovdBulkData. Si la suppression d'au moins un élément échoue, la plateforme génère une instance de DeletionError [SWS_DM_01844].

L'appelant reçoit l'objet d'erreur et évalue les deux variables publiques (AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 « Public Member Variables ») :

  • item : via le BulkDataMetaDataDescriptor, l'application identifie l'élément de données concret dont la suppression a échoué [SWS_DM_01845].
  • error : à l'aide du ara::core::ErrorCode, l'application détermine la cause exacte de l'échec de l'opération de suppression [SWS_DM_01846].

Sur la base de ces informations, la logique appelante peut réagir de manière différenciée, par exemple journaliser l'erreur, choisir une stratégie de nettoyage alternative ou notifier la cause d'erreur détaillée à un client SOVD supérieur.

Scénarios d'erreur

La structure DeletionError ne lève elle-même aucune exception et ne signale aucun code d'erreur propre, mais sert exclusivement de vecteur d'information pour encapsuler les échecs d'opérations de suppression préalables. La sémantique d'erreur centrale est fournie via la variable error du type ara::core::ErrorCode [SWS_DM_01846]. Ce code spécifie en détail pour quelle raison l'objet de données de masse [SWS_DM_01845] référencé par item n'a pas pu être supprimé (par exemple refus d'accès, ressources verrouillées ou erreurs de système de fichiers).

La condition préalable à une évaluation judicieuse est que les variables item et error aient été renseignées avec des données de contexte valides par l'environnement d'exécution SovdBulkData générateur. Après achèvement de l'inspection, la structure ne requiert aucune action de nettoyage par le développeur.

Ce guide repose exclusivement sur les extraits de spécification d'AUTOSAR Adaptive R25-11.

Diagramme de classes UML

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

G nara__diag__SovdBulkData__DeletionError56 «struct» DeletionError + error + item

Constantes

error variable

Corresponding error, that specifies why the bulk data could not be deleted.

item variable

bulk data that could not be deleted.

Documentation des constantes / variables

variable error [SWS_DM_01846] Upstream: RS_Diag_04266

ara::core::ErrorCode error;

Corresponding error, that specifies why the bulk data could not be deleted.

Header-Datei#include "ara/diag/sovd_bulk_data.h"
Scopestruct ara::diag::SovdBulkData::DeletionError
Symbolerror
Typara::core::ErrorCode

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

Record
AUTOSAR/AP/record/SWS_DM_01846
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01846@rel:R25-11#6ff3444c
Content hash
6ff3444c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01846
Status: valid/unmigrated Version: rel:R25-11#5fc21fda Versionshistorie & Revisions (1 transition, 4 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_DM_01846@rel:R25-11#5fc21fda
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#6ff3444c2026-09-30
  • R23-11rel:R23-11#bbba0cd42026-10-14
  • R24-11rel:R24-11#bbba0cd42026-10-14
  • R25-11rel:R25-11#5fc21fda2026-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

variable item [SWS_DM_01845] Upstream: RS_Diag_04266

BulkDataMetaDataDescriptor item;

bulk data that could not be deleted.

Header-Datei#include "ara/diag/sovd_bulk_data.h"
Scopestruct ara::diag::SovdBulkData::DeletionError
Symbolitem
TypBulkDataMetaDataDescriptor

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

Record
AUTOSAR/AP/record/SWS_DM_01845
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01845@rel:R25-11#81ffea3c
Content hash
81ffea3c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01845
Status: valid/unmigrated Version: rel:R25-11#656f0547 Versionshistorie & Revisions (1 transition, 4 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_DM_01845@rel:R25-11#656f0547
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#81ffea3c2026-09-30
  • R23-11rel:R23-11#2453664f2026-10-14
  • R24-11rel:R24-11#2453664f2026-10-14
  • R25-11rel:R25-11#656f05472026-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