cliu
5e77aada8e
Summaries of IM 36K10L50, P30, P20, R40, C30 and E10 (R1.03). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
55 lines
3.4 KiB
Markdown
55 lines
3.4 KiB
Markdown
---
|
||
manual: IM 36K10E10-01EN
|
||
title: Excel Add-in Data Analysis and Reporting
|
||
edition: 3rd Edition, Sep. 2023
|
||
version: R1.03
|
||
status: from docs only — Microsoft Excel and the add-in are not installed on the test system (checked 2026-10-01)
|
||
---
|
||
|
||
# Excel Add-in — DART (R1.03)
|
||
|
||
DART (Data Analysis and Reporting Tool) is a Microsoft Excel add-in that reads CI Server data into
|
||
worksheets for reports and analysis. It connects through CI Portal (web ports 8080 local /
|
||
8443 remote) and logs in as a CI Server user, so the user's authorizations limit what it sees.
|
||
Section numbers refer to the manual.
|
||
|
||
## 1. Install (§2)
|
||
|
||
Admin rights; close Excel; run `Windows\EngineeringTools\ExcelAddIn\ExcelAddInfoForReports_x64.exe`
|
||
from the CI Server DVD (SmartScreen: *More info › Run anyway*), accept the licence, *Install*. A
|
||
*CI Server* ribbon tab appears. Uninstall: *Programs and Features › CI Server Excel Add-in*.
|
||
Remote CI Portal on another machine needs SSL certificates.
|
||
|
||
## 2. Ribbon functions (§3)
|
||
|
||
| Group | Command | Gives |
|
||
|---|---|---|
|
||
| Connections | Connection Manager | Connect (server name/IP, default `localhost`; login dialog depends on the `dssana.sup` login method) / disconnect |
|
||
| Item Search | Item Search | Items by name and description filters (`*`, `?`, both filters ANDed); paste vertically or horizontally |
|
||
| Current Data | Current Data / Item Attribute Value | Latest value (optional time stamp left or above); description, data type, engineering unit, status, quality, update time (one attribute per call) |
|
||
| History Data | Single / Constant Interval / Timestamp Based / Fixed Duration–Fixed Count | Value at a time; values at an interval (optional slope interpolation); values at another item's sample times; all samples in a period or N samples |
|
||
| Calculated Data | Aggregation Data | Values of an Aggregation storage group: maximum, minimum, average, standard deviation, counter, integration, differential summation per 30 min, hour, shift, day, week, month, year (only what the group stores; time stamp = start of the period) |
|
||
| Refresh Data | Refresh UDF / Refresh Workbook | Re-create the array formula at the cursor (needed when the number of values changes) / recalculate all |
|
||
| Others | Settings, About, Help | Number and date formats, interpolation (previous or next value), ports |
|
||
|
||
Cells hold user-defined array functions, so workbooks refresh themselves (Excel calculation
|
||
*Automatic*). Fetch options when no sample exists at a time: *Next*, *Actual* ("No Data"),
|
||
*Interpolated* (previous/next per Settings); edge options for periods: *Actual*, *Nearest*,
|
||
*Interpolated*.
|
||
|
||
## 3. Times (§5)
|
||
|
||
Absolute: `n` now, `t` today 00:00, `y` yesterday, `b` first of the month, weekday names,
|
||
`MM/dd/yyyy H:mm:ss`, `dd`, `HH:`, `dd HH:`, `H:mm:ss` (type a leading `'` in a cell). Relative:
|
||
`+/-` with `s`, `m`, `h`, `d`, `w`, `M` (months), `y` units, one unit per term (`t+2h`, `y+23h`,
|
||
`n-15s`). Intervals for constant-interval history use the same units. A daily report of yesterday:
|
||
start `y`, end `y+23h`, interval `1h`.
|
||
|
||
## 4. Tips and errors (§4, §6, §7)
|
||
|
||
Keep the number of values per formula constant (fixed start/end relative to `y`) so the workbook
|
||
refreshes without *Refresh UDF*; format time cells as text or `H:mm` for charts. The manual's
|
||
error list explains connection, login, item and time-format errors.
|
||
|
||
Known issue (IM 36K01A50): Excel via ODBC cannot write to CI Server R1.03; the add-in (read) is
|
||
the supported Excel route.
|