ci-server-engineer/knowledge/manuals/IM36K10C50-01EN.md

---

manual: IM 36K10C50-01EN title: Edit Module edition: 5th Edition, Feb. 2026 (R1.05); first summarised from the 3rd Edition, Sep. 2023 (R1.03) version: R1.05 (first written for R1.03) status: R1.05 re-check 2026-10-08 - full text diff R1.03 → R1.05 reviewed (section "Changes in R1.04 and R1.05"), from docs; nothing re-tested on the R1.05 test server (shared, no displays may be changed). R1.03 results - display CIENG_Tank built by the user in the Edit Module (text, number field, alarm overview, trend) and checked as XML and HTML 2026-10-01; jwuiutl search, validate and HTML export verified; trend settings (§2.27) tested one by one on CIENG_TrendLab 2026-10-02 (skill graphics, tasks/trend.md); generated sample displays (CIENG_*, most components: shapes, arc, text, number/text/date-time fields, buttons, toggle, check box, slider, spinner, combo box, data bar, scales, alarm overview, report, micro trend, trend) checked on desktop and web 2026-10-06; symbols, other actions and the tutorial from docs

Edit Module (R1.05)

The Edit Module draws displays and symbols for the Operator Interface (desktop) and the HTML display. Displays are XML files (IM36K10R30-01EN.md §1). Section numbers refer to the manual; the numbering is the same in R1.03 and R1.05 (§2.31 is now titled Generic Functions).

0. Changes in R1.04 and R1.05 (from docs, full text diff 2026-10-08)

Listed in the revision table: R1.04 §2.22 (alarm overview properties), §2.31 (Password Check), §4.12 (update item/parameter); R1.05 §2.22, §2.25, §2.26, §2.33 (properties), §2.31 (RDP Connect). The diff found these, including edits the table does not name:

• §1.5 jwuiutl -m / -M: output described as space-separated instead of CSV; cross-reference "previous section" → "next section" (wording). (not in the table)
• §1.7: the note "HTML display is not supported for enterprise operations" was removed. (not in the table)
• §2.22 Alarm overview: [Acknowledgement] category - Use Custom Acknowledgement (acknowledge from a separate user-made window) enabling Acknowledge Event (pulses TRUE), Acknowledged Alarm / Text / Time; Selected Alarm Key; [External Acknowledgement] Alarm Key, Approver, Reason, Trigger; [Enterprise Alarm Locations] Alarm Source Locations[nn].
• §2.25 Dataset tables: column Icon, Icon filter (match, not-match, bitwise AND), Icon tooltip; operator column sorting; single / multiple row selection; [Enterprise Dataset Locations]; enterprise location now supported on the HTML display. Example filters use ACTION_TIME >=.
• §2.26 Report: [Enterprise] primary / secondary data location (supported on the web).
• §2.27 Trend: Enterprise property now supported on the HTML display. (not in the table)
• §2.31 Calculation/Function renamed Generic Functions; execution timing documented (Date and Time 200 ms; other operations on input change, polled every 100 ms, and at display load/reload) (timing not in the table); Password Check (T[I1] user, T[I2] password → B[O], T[O] user name or the DSS error; needs login method Manual CI Server or Manual OS for the Password Check function in dssana.sup, Login control); RDP Connect (T[I1] host, optional T[I2] RemoteApp, T[I3] its arguments, T[I4] RD Gateway host[:port]; writes an .rdp file, name to T[O]; installed tls\com\connectrdp.cmd).
• §2.32 JavaScript Function: inputs polled every 100 ms, script also runs at display load/reload; the io object is described as implemented in Java. (not in the table)
• §2.33 Web Browser: new engine (WebRTC, HTTPS, WebSocket, HTTP/2, HTTP/3; VP8/VP9/WebM, Opus/Vorbis/PCM; Media player wording removed); content from R1.04 or earlier may not play after upgrade; right-click menu; new [Printing], [Status], [Security] properties (Enable Microphone/Camera, Allow Insecure Certificates, Allow Local file access; local files for CI Mobile View go under %TLS_ALLUSERS_PATH%\wap).
• §2.36 Display generator: the note "not supported on HTML displays" was removed. (not in the table)
• §2.37 Map viewer: wording of centre latitude/longitude (decimal fractions), click information cross-references. (not in the table; same meaning)
• §4.12 Actions sheet: Update item/parameter can record Reason (≤ 256 characters) and Approver (≤ 128) in AUDIT_TRAIL (APPROVAL_REASON, APPROVER); values can be offered from user-defined parameters; two recipes for alarm acknowledgement with reason/approver (item parameter with attribute Acknowledged, item alarms only; or the overview's External Acknowledgement properties, item and external alarms).

Practical notes for the skill: .claude/skills/graphics/tasks/create-display.md (section R1.05).

1. Window and files (§1)

• Window: sheets, component bar, graphic sheet, symbols sheet, menu, toolbar, edit area.
• File > New Display (Ctrl+N), New Symbol (Ctrl+Shift+N), Save (Ctrl+S), Save with Revision Information (who/when/why, kept in revisionHistory), Save As, Save Selection as (new symbol or display), print area, print. Open displays are locked (<name>.lck); autosave writes <name>.xml.autosave.
• Edit > Find searches the open display; jwuiutl -m searches all.
• HTML display check box (new display dialog / display properties): the editor then offers only HTML-supported components, properties and actions, and saving also writes the HTML file. HTML mode can be switched off later. Not for enterprise displays. The tab icon shows normal / HTML / HTML with unsupported content.
• Localisation: Tools > Configure Localization → Extract Text, add locale, translate; global and per-file tables; the operator's locale decides.
• Playback > Record records operator/editor sessions; Open viewer plays them back.

2. jwuiutl — batch operations (§1.5)

jwuiutl.cmd (in tls\com, Java; runs from a normal prompt):

Option	Use
-d / -s	Only displays / only symbols (-p <palette>, -g <group>)
-v	Validate (connected items exist, components defined); report only. -l <file> writes the result, -i shows progress (Validating <name> / Info: No problems found)
-vf	Force validation and save every display/symbol
-u	Unlock locked files (.lck left by a crashed editor)
-c / -a	Clean up temporary files / validate + unlock + clean up
-m <terms> / -M <terms>	Print matching components (CSV) / with actions and properties
-e HTML [-o <dir>] [-f <deployment>] [<display>]	Export HTML displays
-b, -z, -h true/false	Also save .xml.bin (faster loading) / compressed / set HTML mode
-un, -pw	User for enterprise displays
-t, -? / --help	Debug trace / print the option list (read-only)

R1.05: the option list in the manual is unchanged; the installed help text on the R1.05 test server was not compared yet (awaiting user verification, ISS-094).

Verified on the test system: -d -m TANK1 and -d -v -i -l ran without errors; locked displays and displays saved by a newer version are skipped (*** Display locked <name>, … created with a newer version of CI Server (R1.04.0.0)); -e HTML -i -f DEPLOY CIENG_Tank wrote mobileoperator\operatorInterfaces\DEPLOY\displays\CIENG_Tank.html. 2026-10-06: -v with a display name also re-saved that display (normalised XML, same content; skill graphics, tasks/deploy-displays.md §2).

3. Components (§2)

Shapes (rectangle, ellipse, arc, polygon, spline, line, links), text / text field / text area / password field, number and number field, icon, rectangular and circular scales, radial, data bar, spinner, slider, push/toggle button, check box, radio button, combo box, list box, date and time field, alarm overview (current/historical; acknowledge, block, shelve, link display, export; dialog tabs Types, Columns, Filter, Alarm link display, Appearance, Header and footer, Fetching, Alarm Shelving, Enterprise, Advanced, Attributes), list of blocked items, alarm sound, dataset tables (view/edit dataset records), report, trend (pens on items with history; shows limits; time slider and controls; definitions can be saved from the operator interface; every setting tested in skill graphics, tasks/trend.md), DTS trend, micro trend, playback indicator, Generic Functions (R1.03: calculation/function; §0), JavaScript function, web browser, PDF viewer, navigation tree, display generator, map viewer.

4. Sheets (§4)

Visualization (displays/symbols tree), zoom, visibility groups (shown by zoom factor), parameters (default read-only ones such as name, attachedObject, client, server, mouseX; user-defined with scope; $name in command lines), messages, symbols, properties (connect a property to an item attribute, parameter or dataset field; linear transformations; writable properties: value, item name parts, id, units, description, status number/text, control status, option bits), layers, attributes, edit history (undo/redo), actions (open / close display, execute command, read/write parameters; triggered by component events).

Open-display action (verified): <action type="actionActivateDisplay"> with <type type="displayActivationType" value="ActivateSpecific"/> (factory files also use ActivateReplace), <display>, optional <layout> (empty = current window) and <layoutFrame>, plus <parameter> entries for display parameters. Layout commands from a component: Execute command ACTION <command> (e.g. ACTION navigate back default). A trend property connected by mistake (chart.attribute[00] -> item) makes the Operator Interface show Short attribute name ... is invalid when the display opens; remove the connection.

5. Symbols (§5)

File > New Symbol; put it on a palette (attributes sheet); external user-defined parameters become properties of each instance; after changing a symbol run Tools > Validate all Symbols and Validate all Displays (with all tabs closed); a symbol can be linked to a PROCESS Service class so each instance shows one object; data location (display, operator's CI Portal, display's server, enterprise, node).

6. What the display file stores (verified with CIENG_Tank, removed from the sample 2026-10-06)

• <coreObjectDefinition type="displayDefinition"> with <html>true</html>, <width>, <height>, grid, revision history, visibility groups, layers.
• Components as elements (text, numberField, alarmOverview, chart = trend).
• Item connections in <globalSection>: <itemName>CI-Eng-Sample.TANK1.LEVEL</itemName> and <itemId>1.1.248.0.0.1.1.7</itemId>. Trend pens: <source uri="ci:/item/<item>"/>; a new trend has 5 empty pens.
• After a sample remove/reload the item got id 268 while the file kept 248: jwuiutl -v still reported No problems found, and a newly opened session showed the live value — the name is what counts. Sessions that were already open kept the old binding (value frozen) until the display was opened in a new session.
• Rules for writing display XML directly (text size, rounding, arc angles, item attributes for the web, server-side commands, alarm overview columns): skill graphics, tasks/create-display.md, verified 2026-10-06 with the generated CIENG_* displays.

7. Tutorial (§6)

Builds wheels, faceplates, valve symbols, indicators, PID faceplates with mode and setpoint dialogs, scales, limit colours, tag info and pinning buttons — a guided exercise in the GUI.