ci-server-engineer/.claude/skills/graphics/tasks/deploy-displays.md
cliu ecf1f226f2 Knowledge: sample operator HMI findings (layouts, display XML, users), ISS-068..075
- layouts.md: tab set must be the last child of its frame set (web); desktop tab frames ignore
  zoom (navigate ... stretchDisplay); web activates the last tab loaded; web tab labels = display
  title; one layout command at a time; connectionState breaks the web layout (corrects 6.3);
  per-user layout verified on desktop and web
- create-display.md: new section "Writing display XML directly" (text size, rounding, arc angles
  clockwise on both clients, Clicked b1, web item attributes, asDateTime, server-side command as
  CIX_PROCESS with group OPERATOR, alarm overview columns / white area)
- deploy-displays.md: 8-display sample scripts; jwuiutl -v re-saves files
- trend.md: CIENG_TrendLab as history, cieng_feed.ps1, 50-pen hairline trade-off, component
  opaque, micro trend "Record not found" without history
- users-groups.md: PASSWORD "" for an empty password; sample user CIENG; open session blocks
  group removal (DSSSDA03 stopped)
- configure-audit.md, L25 / R30 / C50 summaries, SKILL.md, issues ISS-068..075, progress rows
- Every statement tested on CI Server R1.03.00 2026-10-02..06 (desktop and web, test display and
  test layouts removed afterwards)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 11:25:41 +11:00

3.3 KiB

task version source status
Deploy, remove, export, validate and search displays; open them in the browser R1.03 IM 36K10C50-01EN §1.5; IM 36K10R30-01EN §1.1, §4; practiced on CI-Eng-Sample 2026-10-01; sample operator HMI (8 displays) and validate test 2026-10-06 verified

Deploy and check displays

No admin rights needed (C:\Users\Public\Yokogawa\tls\wap). jwuiutl.cmd is in tls\com (on PATH); call it through cmd (cmd /c "jwuiutl.cmd …").

1. Deploy / remove (sample scripts)

examples/CI-Eng-Sample/displays/deploy_displays.cmd: copies the 8 sample displays (CIENG_Header, CIENG_Overview, … CIENG_TankFaceplate) to %TLS_WAP_PATH%\cfg\operatorInterfaces\DEPLOY\displays\ and runs jwuiutl.cmd -e HTML -i -f DEPLOY <name> for each (HTML into %TLS_WAP_PATH%\mobileoperator\operatorInterfaces\DEPLOY\displays\). remove_displays.cmd deletes both files of each (close the displays in the Edit Module first). Deploy after load.cmd so the items exist. Verified 2026-10-06: remove → 0 sample files left, deploy → exactly the 8 XML + 8 HTML files.

For another display: copy <name>.xml into DEPLOY\displays and export it the same way. Displays with symbols also need the symbol files in DEPLOY\symbols.

2. Validate (re-saves the validated files)

cmd /c "jwuiutl.cmd -d -v -i -l <scratch>\validate.txt"

Per display: Validating <name> then Info: No problems found, or *** Validation failed for display <name>: with Problem: <component>: Connected item is not found (<item>). Skipped: *** Display locked <name> (open in the Edit Module or a stale .lck; -u unlocks — with approval), displays saved by a newer version. -vf re-saves all displays — only with approval.

-v also re-saves (tested 2026-10-06: jwuiutl -d -v -i -l … CIENG_Test reported No problems found and rewrote the file, 9 618 → 11 191 bytes: default values dropped, positions moved into attributes - same content). Run it on copies, or redeploy the source files afterwards. On 2026-10-02 a validation of eight displays once hung on one of them and left <name>.lck and <name>.xml.tmp (stop the java process, delete both files); not reproduced on 2026-10-06 (ISS-075).

cmd /c "jwuiutl.cmd -d -m <term> > <scratch>\match.txt 2>&1"

CSV Type, File, Component per match; -M adds actions and properties. Use it before deleting or renaming items to find the displays that use them.

4. Open in the browser (HTML display)

http://localhost:8080/mobileoperator/?d=<display> (&l=<layout>). The user logs in with a CI Server user. The page shows the operator frame (menu, navigation buttons, alarm banner, status line). To switch displays type the name in the display box and press Enter. To refresh, use the display menu View > Reload (keeps the session) — reloading the browser page ends the session and needs a new login. Check live values by writing a test value (itmval -p, test items only).

Verified (2026-10-01)

Remove → deploy recreated both files; -e HTML output identical to the Edit Module's HTML; validation of CIENG_Tank No problems found (also after a sample reload with new item ids — but a stale <itemId> then shows 0 at run time, ISS-052); search worked; browser showed live values. HTML trend without line: ISS-041 (cause and workaround in trend.md §6).