ci-server-engineer/.claude/skills/graphics/SKILL.md
cliu a298fdebc1 Layouts: every Layouts.xml parameter tested on desktop and web (#23)
## Summary
- `graphics/tasks/layouts.md` §6: tested reference of every `Layouts.xml` parameter for the Operator Interface (desktop) and the HTML display (web) — frames, window options, menu/toolbars/status line, all commands, popups/modal/maximumOpen, translations, debug key, tabs.
- New rules: web-compatible frame shape (one `n*` per frame set, nested frame set only in that slot), `type="check"` required for `toolbar`/`statusline`/`playback record` (else the desktop client does not start), profile initial display replaces `initialDisplay` of frame `default`, always set `title`.
- Issues ISS-062..067 (readme differences and web limits), progress row, skill index.

## Test plan
- [x] 5 rounds of test layouts (`LT_*`) in a marked block of `Layouts.xml`; desktop via `jwuipoi -layout <name>` with window captures/recorder, web via `?d=…&l=…` in the browser and the web client code (CI Server R1.03.00).
- [x] Launcher display `LT_Launcher` for layouts opened from a display.
- [x] Clean-up: test system restored to its pre-test state; `LT_Launcher` removed.
- [ ] Not tested: print orientation/margins, playback, second-screen positions, `maximumTabs` limit for new tabs.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: cliu/ci-server-config#23
Co-authored-by: cliu <cliu@noreply.git.yokogawa.tech>
Co-committed-by: cliu <cliu@noreply.git.yokogawa.tech>
2026-10-02 22:26:29 +10:00

3.6 KiB

name description
graphics CI Server R1.03 operator graphics for the Operator Interface (desktop) and the HTML display (web): displays, symbols, layouts. Use when the user wants to create or change a display or symbol in the Edit Module (number field, text, alarm overview, trend, buttons, actions, parameters, connecting a component to an item), deploy or remove display files, export displays to HTML / Mobile Operator, open a display in a web browser (localhost:8080/mobileoperator), validate, search or unlock displays (jwuiutl, .lck files), find where displays, symbols and layouts are stored (DEPLOY folder, Layouts.xml), create or change layouts (operator window, navigation frame, main frame, alarm banner, popup / faceplate window, kiosk or full-screen screen, menus, toolbars, status line, frames, tabs, open a display in a frame or another layout), build dataset forms (*Dia.xml), or use the AOG library (Advanced Operating Graphics, AOG_Style, AOG symbols, faceplates). Sources IM 36K10C50-01EN, IM 36K10R30-01EN, IM 36K10C60-01EN and the installed Layouts.readme.

Graphics: displays, symbols, layouts (R1.03)

Background: knowledge/manuals/IM36K10C50-01EN.md (Edit Module, components, sheets, symbols, jwuiutl, display file contents), IM36K10R30-01EN.md (folders, layouts, dataset forms, HTML display), IM36K10C60-01EN.md (AOG library).

Rules:

  • Drawing is done by the user in the Edit Module (GUI). Claude prepares the steps, checks the saved XML, deploys/exports/validates files and checks the HTML display in the browser.
  • Displays and layouts are shared by every operator: changing or deleting existing files only with the user's approval; keep a copy first (Layouts-original.xml is the factory layout file).
  • The HTML display needs a CI Server login: the user logs in; Claude never enters passwords. Reloading the browser page logs out — use the display menu View > Reload, and the display box to open other displays.
  • jwuiutl -vf, -u, -c, -a rewrite or unlock files of all displays: only with approval.
  • Ask the user to close the Edit Module before CI Server is stopped or restarted: otherwise the next start fails (skill system-check, §3).
  • The Operator Interface (desktop) reads Layouts.xml only at start: after layout changes, restart it (a running client falls back to the current window and just reloads the display).
Task File Status
Build a display in the Edit Module (text, number field, alarm overview, trend) and check the saved XML tasks/create-display.md verified
Deploy / remove display files, export HTML, validate and search with jwuiutl tasks/deploy-displays.md verified
Trend: pen sources (history group, aggregates), every pen and chart setting, desktop vs HTML display, 50-pen web workaround (add_trend_spares.ps1), Micro Trend tasks/trend.md verified (desktop); web workaround verified; Micro Trend open (ISS-055)
Open and check a display in the browser (HTML display / Mobile Operator) tasks/deploy-displays.md §4 verified
Operator layouts (Layouts.xml): windows, menus, toolbars, frames, popups, kiosk screens; open displays in frames and layouts; every parameter and command, desktop vs web (§6) tasks/layouts.md verified (dual screen, per-user layout from docs)
Dataset forms (*Dia.xml) and the form description language R30 summary §3 from docs
Symbols, parameters, actions, localisation, record/playback C50 summary §1, §4, §5 from docs
AOG library (styles, symbols, faceplates, templates) C60 summary from docs