EA Import Guide - UDS Security Example

# EA Import Guide - UDS Security Example Diagrams

Kit location: `Examples/Diagrams/EA/`

## Files
- `SYS_Import_EA.js` - EA JScript: creates **SYS.3 System Architectural Design** (Context, Architecture, State Machine diagrams, native EA elements + connectors + layout)
- `SW_Import_EA.js` - EA JScript: creates **SWE.2 SW Architectural Design** (SSA-AP internal architecture, Flash/NvM block layout)
- `EA_Sequences_EA.js` - creates the three sequences natively with **explicit Seqno in source order** (preferred when order fidelity matters)
- `EA_ReorderSeq.js` - repairs scrambled message order after an XMI import: selects sequence package, re-assigns Seqno from the `.puml` source, then Layout Diagram
- `EA_Cleanup.js` (v2) - renames 'None' packages by diagram name, strips literal `\n` from lifeline names, converts state connectors Dependency->Transition, adds SecOC key provisioning (SYS-RQ-025/SWRQ-027)
- `SYS_AuthSequence.xmi` / `SW_AuthSequence.xmi` / `SW_CertVerifySequence.xmi` - XMI 2.1 sequences (named via patch)
- `patch_xmi_names.py` - adds missing `name` attributes; **run after every -txmi export**

## Structure: EA script
PlantUML `-txmi` emits UML 1.3 for component/state - poor EA import. Use scripts.
1. Select target package in Project Browser.
2. Scripting window -> group -> Add Script (Language = **JScript**) -> paste -> Save -> Run (F5).
3. One-shot: paste into the Scripting console + Enter.

## Sequences - LESSON LEARNED (order!)
XMI import works (elements + diagram) BUT **EA assigns Seqno arbitrarily** because PlantUML XMI has no Diagram Interchange and no explicit sequence numbers - messages arrive scrambled and Layout Diagram follows Seqno.
Two reliable paths:
- **Native:** run `EA_Sequences_EA.js` (sets Seqno explicitly in .puml order), or
- **XMI + repair:** import XMI, then run `EA_ReorderSeq.js` with the sequence package selected (syncs Seqno from the .puml), then Layout Diagram.
Manual reorder in EA also works (dragging rewrites Seqno) but is throwaway - next re-import scrambles again.

## No delta merge
EA matches by GUID; PlantUML IDs are not EA GUIDs -> re-import duplicates. One sub-package per sequence; to update: delete sub-package, re-import (patched XMI + EA_ReorderSeq.js).

## Notes
- Element Notes carry SYS-RQ/SWRQ/HWRQ references - the traceability hook. Consider EA tagged values for requirement IDs.
- Stereotypes: MICROSAR, MBBL, SSA-AP, HW, offboard, initial. Connectors: Dependency (structure) / Transition (states).
- Cross-check against PNG renders after import; adjust frames if fonts overflow.
- Re-running a structure script duplicates packages - delete the old tree first.
- Reordering message blocks in EA: multi-select + drag or arrow keys; activation bars/fragments need manual attention; replies can end up before calls - EA won't stop you.

id: 5e634876c359468e83c41e2534c5db94
parent_id: 111595e632f1437d8c451eb73811d9c2
created_time: 2026-08-25T07:03:38.799Z
updated_time: 2026-08-27T09:13:06.888Z
is_conflict: 0
latitude: 0.00000000
longitude: 0.00000000
altitude: 0.0000
author: 
source_url: 
is_todo: 0
todo_due: 0
todo_completed: 0
source: joplin-desktop
source_application: net.cozic.joplin-desktop
application_data: 
order: 1787641418799
user_created_time: 2026-08-25T07:03:38.799Z
user_updated_time: 2026-08-27T09:13:06.888Z
encryption_cipher_text: 
encryption_applied: 0
markup_language: 1
is_shared: 0
share_id: 
conflict_original_id: 
master_key_id: 
user_data: 
deleted_time: 0
is_locked: 0
extracted_resource_ids: 
type_: 1