Documentation Vision Library+ Documentation

Manual Input Table+

Manual Input Table+ shows the recorded values of PI Points and AF attributes in a table, one row per timestamp. Operators review the values next to each other, correct them, add rows, and write the changes to the PI Data Archive with one Save.

Overview

Manual Input Table+ showing recorded values of three data sources and one time data source

Watch the demo

See Manual Input Table+ in a practical PI Vision workflow.

When to use it

Use this symbol when you need to:

  • Review recorded values of several data sources in one table.
  • Correct a recorded value or fill a gap at an existing timestamp.
  • Add a row of values at a chosen time.
  • Paste or import a block of timestamped values from a spreadsheet.
  • Warn operators, or stop them, when a value is outside its limits.

Choose Manual Data Entry+ to type one new value per data source, with a prefilled user name and an ad-hoc trend, without showing the history. Choose Quick Input+ to write a value immediately, without a Save step.

Before you begin

  • Use writable PI Points or AF attributes, and make sure the operators have write permission for them.
  • Turn compression off on every PI Point you edit here. With compression on, the PI System can discard a manually entered value that falls inside the compression deviation.
  • Set Step to On for numeric PI Points. With Step off, the PI System interpolates between stored values, and trend and table symbols show misleading values between your entries.
  • Set the display time range to the period you want to review. The table loads the recorded values of that range.

Add and set up the symbol

  1. Select Manual Input Table+ in the PI Vision symbol gallery, and drag the PI Points or attributes onto the display. Each data source becomes one column.
  2. Set the display time range to the period to review. Every distinct timestamp in that range becomes one row, and a data source without a value at that time leaves its cell empty.
  3. Right-click the symbol and select Configure Table....
  4. Under Editing, check Existing Data Rule (1). Under Data Retrieval, keep Start- and Endtimes (2) at Display time range.
  5. Close the configuration pane.
  6. Click an empty cell, for example the Fan running cell of a row, and select a value. The cell shows the value (1) and Save (2) turns active.
Editing and Data Retrieval sections of the configuration pane
A Fan running value staged in the 9:22 AM row, with Save active

Important: Nothing is written until you select Save. Save writes the staged cells to the PI Data Archive and then reloads the table.

Common tasks

Add a row at a chosen time

Use this to record a reading that you took earlier, or a set of values for one moment. A new row starts with the time that Default Time sets, and you can change it.

  1. Select Add Row (1). A new row appears at the bottom of the table.
  2. Click the Time cell (2) and type the time of the reading, for example 10/08/2026 10:00:00 AM.
  3. Enter or select the values in the other cells (3, 4). Leave a cell empty to skip that data source.
  4. Select Save (5).
A new row at 10:00 AM with Control mode Auto and Air velocity 44.0 m/s, waiting to be saved

A digital or Boolean cell offers a list of its states, so operators cannot type an invalid state. Closing the list without a choice leaves the cell unchanged.

Default Time sets the time of a new row. The default * is the moment of saving. Allow Adding New Rows under Editing shows or hides Add Row.

Allow Adding New Rows and Default Time under Editing

Correct a recorded value

Use this to fix a value that was entered wrongly. Editing a cell at an existing timestamp replaces the value at that timestamp.

  1. Click the cell (1) of the value, and type the corrected value or select another state. Press Enter.
  2. Check the Time (2) of the row. The value is written at that time.
  3. To take the change back before saving, select Undo (3).
  4. Select Save (4).
A corrected Air velocity value staged in the 8:27 AM row

Existing Data Rule under Editing decides what Save does when a value already exists at the timestamp. Replace Existing overwrites it, Add as Duplicate keeps both values, and Protect Existing cancels the save and lists the existing values.

Important: Editing a saved value changes history. Follow your site's correction and audit procedure.

Check entries against limits

Use this to catch typing mistakes in numeric values. The check runs when the operator leaves the cell and again at Save.

  1. Right-click the symbol and select Configure Table....
  2. Under Columns, select the data source and select Validate Input (1).
  3. Set Limits (2) to Custom and enter Max (3) and Min, or set it to Database to use the limits the data source reports.
  4. To block out-of-range values instead of only warning, select Prevent Entry Outside Limits (4).
  5. Optionally, enter a Message (5) with guidance for the operator.
Validate Input settings of the Air velocity data source

Without Prevent Entry Outside Limits, a value outside the limits opens a Limit Warning. The operator can select Cancel to take the value back, or Continue to keep it.

Limit Warning for the value 75

With Prevent Entry Outside Limits, the dialog is titled Invalid Value and offers only Cancel. The value is not accepted.

Invalid Value dialog for the value 500

Pasted and imported values get no dialog per value. At Save, the symbol checks every value it writes: a value outside a hard limit blocks the whole save with an error message, and values outside soft limits are listed in one Limit Warning that the operator confirms.

Delete a row of recorded values

Use this to remove the values of a timestamp from the archive, for example a row that was entered by mistake.

  1. Select the check box (1) of each row to delete.
  2. Select Delete Rows (2), the trash icon.
  3. Check that the rows are gone from the table.
  4. Select Save.
One row selected, with Delete Rows active

Deleting only stages the change. The rows leave the table and Save (1) becomes active, but the archive keeps the values until you save. Undo (2) cancels the staged delete.

The row removed from the table, waiting to be saved

To delete the value of one data source only, including a system state such as Shutdown, clear its cell and select Save. With Existing Data Rule set to Protect Existing, the symbol asks you to confirm the removal first.

Important: Save removes the values of every data source in the deleted row at that timestamp. A row older than the Max Age cannot be deleted.

Paste or import values from a spreadsheet

Use this when the readings are in a spreadsheet or a CSV file. Pasting or importing adds rows to the table. Nothing is written until you select Save.

  1. Prepare the data without a header row. Use one column for Time, followed by one column for each data source, in the order of the data source list in the configuration pane. A hidden data source still takes a column: leave it empty.
  2. In the spreadsheet, select the cells and copy them (Ctrl+C).
  3. Select Paste Data from Clipboard (1) in the toolbar. To use a CSV file instead, select Import CSV.
  4. Check the new rows (2).
  5. Select Save (3).
Three pasted rows waiting to be saved

For example, the display above has the data sources Fan running, Control mode, three hidden data sources, Air velocity and Next inspection. The first pasted row is 10/08/2026 10:00:00 AM, True, Auto, three empty cells, 44, and one empty cell.

A CSV file needs the same columns. Its first line is a header and is skipped while Skip First Row is on. Separate the values with a comma, or with a semicolon where your regional settings use a decimal comma. A value that contains the separator goes in double quotes. If the source has no time column, turn on Skip Time Column under Editing: every row then gets the Default Time. The browser may ask for permission to read the clipboard.

Use the symbol

Manual Input Table+ with numbered callouts
What it shows
(1)Row selection. Select rows to delete them or to copy them. The header box selects all rows.
(2)Time: the timestamp of the row. Editable unless the designer turned Allow Edit off. A changed time moves every value of the row, system states included, to that time.
(3)A value cell. An empty cell means the data source has no value at that time. Click it to enter a value.
(4)Column filter, when Column Filters is on. Type to filter the rows.
(5)Toolbar: copy, Paste Data from Clipboard, Import CSV, Export to CSV, Reload, and Delete Rows.
(6)Add Row and Save (Ctrl+S). Undo and Redo sit at the left of the toolbar.
  • Type, then save. Typing, pasting, importing, adding a row and deleting a row only stage a change. Save, or Ctrl+S in the table, is available as soon as one change is staged.
  • Save writes to the PI Data Archive, and the table reloads. You cannot undo a saved change from the symbol.
  • Undo and Redo step through the staged changes. Reload reads the archive again.
  • While you hold unsaved edits, the table does not reload by itself. Leaving the display with unsaved edits shows a warning.
  • A row older than the Max Age of Limit Changes is read-only, and Save refuses changes to it.
  • The table loads at most Max. Events values per data source. Shorten the range if it has more.

Configure the symbol

Right-click the symbol and select Configure Table.... The pane has the sections General (the groups Table, Header, Time and Editing), Columns, Editing, Data Retrieval, Toolbar, Style, Export Data and Numbers.

General: Table

SettingWhat it does
LayoutFit Data, Fit Table Width, or Manual column widths. Manual widths are saved with the display.
Range SelectionTurns on spreadsheet-style selection of cell ranges, which you can copy and paste into. Editing a cell then needs a double-click. Row Selection is not offered while this is on.
Row SelectionShows the check box column that selects rows to delete.
Wrap TextWraps long cell text. Off clips it.
Right to LeftReverses the reading direction.
PagingSplits a long table into pages instead of scrolling.

General: Header

SettingWhat it does
ShowShows or hides the header row.
Column FiltersShows a filter row under the headers. Off by default. Available when Show is on.
AlignmentAligns the header captions.
Group, ByGroups the column headers by Custom, Asset, Category or Description. With Custom, each data source has a Group name under Columns.

General: Time

SettingWhat it does
ShowShows or hides the Time column.
Allow EditLets operators change the time of a row. Available when Show is on.
Time PickerShows a date and time picker in the Time cell. Available when Allow Edit is on.
Datetime FormatDefault hides milliseconds. Exact shows them.
Pin Time ColumnKeeps the Time column in place while the other columns scroll sideways.

General: Editing

SettingWhat it does
Allow Adding New RowsShows Add Row. See Add a row at a chosen time.
Default TimeThe time of a new row: * (the moment of saving), Current (the local time as an absolute timestamp), Custom (a time expression you enter), Relative to Last Time, Input Time, Display Start Time, or Display End Time. Relative to Last Time, Display Start Time and Display End Time take an offset.
Copy / PasteShows the copy and paste buttons. Skip Time Column makes pasted rows take the Default Time instead of a time from the clipboard.
Import / ExportShows the import and export buttons. Skip Time Column works as for paste. Skip First Row ignores the first line of the CSV file. On by default.
Limit ChangesMakes values older than Max Age read-only and undeletable. Set Max Age as a number and a unit.

Columns

Select a data source in the list, then set it.

SettingWhat it does
LabelChooses the caption of the column from the attribute, asset and PI Point names, or a custom name.
Show UnitsAdds the unit of measure to each value.
Allow EditTurns off to make the column read-only.
Mode, Sort ByDropdown or Dialog for choosing a digital state, and the order of the states in the dialog. Available for digital data sources that allow editing.
HiddenRemoves the column from the table. A hidden column still takes part in paste and import.
AlignmentAligns the values of the column.
GroupThe group name of the column. Available when Group under Header is on and By is Custom.
Prefilled ValueThe value a new row starts with: None, User (the PI Vision user name, for string data sources), Last Value, or Custom. Time data sources also offer Display Start Time and Display End Time. Available when Allow Adding New Rows is on.
Validate Input, Limits, Max, Min, Prevent Entry Outside Limits, MessageLimit checking for numeric data sources that allow editing. See Check entries against limits.

The point attributes button beside the list shows the PI Point attributes of the selected data source. Multi-state colors come from Add Multi-State... on the right-click menu. They color the cells by the limits of the data source.

Editing

SettingWhat it does
Existing Data RuleReplace Existing overwrites the value at the timestamp. Add as Duplicate keeps both values. Protect Existing cancels the save when a value already exists or when two rows hold a value of one data source at the same time, and asks you to confirm before it removes values.
Set Questionable flagMarks every written value as questionable.

Data Retrieval

SettingWhat it does
Max. EventsThe most values loaded per data source, from 1 to 10,000.
Data Update ModeManual reloads only when the time range changes or when you select Reload. Auto (Interval) reloads the table at the display update interval. Auto (Event Based) updates only the cells whose archive values changed.
Start- and EndtimesDisplay time range, Custom time range (a fixed start and end), or Duration and offset (a duration that ends at the display end time, moved by the offset).

Toolbar

SettingWhat it does
Save TextReplaces the label of the save button.
Undo / Redo, Copy / Paste, Import / Export, Reload, DeleteShow or hide each group of toolbar buttons.

Style, export, and numbers

SettingWhat it does
Theme, Container Style, Comfortable, Apply to all symbolsSet the table appearance. Choose Custom Theme for colors, fonts, borders, and row heights. A table owns its header and row surfaces, so it has no Surface setting. See Themes and container styles.
Export DataFile Format (CSV, JSON, XLSX, PDF) and Download of the current table.
Numbers, FormatDatabase follows the display digits of the PI Point (an AF attribute without a PI Point shows 5 significant digits). General shows all significant digits. Number sets decimal places and the thousands separator. Scientific shows 0.00E+00.

Troubleshooting and limitations

SymptomCauseWhat to do
Save is dimmed.No change is staged.Edit a cell, add a row, paste, import, or delete a row.
Add Row is missing.Allow Adding New Rows is off.Ask the designer to turn it on.
Invalid Value appears and the cell goes back.The value is outside the limits and Prevent Entry Outside Limits is on.Enter a value within the limits shown in the dialog.
Save shows an error about limits.A pasted or imported value is outside a hard limit.Correct the value and save again.
The save is cancelled and lists existing values.Existing Data Rule is Protect Existing and a value exists at that time.Change the Time, or ask the designer to change the rule.
Save shows an error and some cells stay edited.Those values could not be written. The other values were saved.Read the message, correct the values, and select Save again.
Save reports No write permission for a data source.Your PI identity cannot write to that PI Point or attribute.Ask your PI administrator for write access.
Saved values are missing, or a trend interpolates between them.Compression is on, or Step is off, for the PI Point.Turn compression off and Step on.
Pasted values land in the wrong columns.Each pasted column goes to the data source in the same position, and hidden data sources keep their column.Add an empty column for every hidden data source.
Paste shows an error about the clipboard.The browser blocked access to the clipboard.Allow clipboard access for the PI Vision site.
A row cannot be edited or deleted.The row is older than the Max Age.Ask the designer to change Limit Changes.

Limitation: Editing or deleting a saved value is a historical change. Follow your site's correction and audit procedure.