Manage decision tables in Excel
Summarize
Summary of Manage decision tables in Excel
This feature enables ServiceNow customers to efficiently manage large decision tables by exporting them to Excel, making edits, and importing the updated tables back into Workflow Studio. It streamlines the process of building and maintaining complex decision logic by allowing different team members to collaborate—developers can define the structure and others can author rules using Excel.
Show less
Key Features
- Export to Excel: Export decision tables in .xlsx format, including two worksheets—one with the table and another with instructions to guide rule building and avoid import errors.
- Editing in Excel: Add, remove, edit, or reorder decision rules. Operators and values are selected or entered based on condition column field types, with drop-down lists provided for certain data types like dates and choices.
- Import to Workflow Studio: After editing, import the Excel file back. The system validates changes before applying them, providing success confirmation or detailed error reports to fix issues.
- History Tracking: Export and import activities are recorded with user and timestamp details. Relevant Excel files can be downloaded from the history sidebar for auditing or re-use.
- System Property Control: The property
glide.ui.export.choicelistmaxcharacterscontrols the maximum characters exported from condition fields to Excel and displayed in Core UI lists.
Important Usage Guidelines and Limitations
- Only modify decision rules (Condition and Result columns) in Excel; do not add or change condition or result columns themselves.
- Do not alter or remove headers, and edit only the original exported Excel file (renaming is allowed; copying contents to a new file is not).
- Ensure no empty rows exist, as data after five consecutive empty rows is ignored during import.
- Advanced rows in decision tables are read-only in Excel and cannot be edited.
- Import option is available only for files originally exported from Workflow Studio.
- Editing in Excel is not supported for decision tables without condition columns, with unsaved changes, containing unsupported field types, or linked to inactive inputs.
- The Edit in Excel feature does not support localization; it requires English-language instances.
Manage large decision tables in Excel. Export a decision table to an Excel file, edit the file to add or update rows, and import the file back into Workflow Studio.
Export a decision table to Excel
After creating and saving inputs, condition columns, and result columns, export a decision table to Excel in .xlsx format by selecting Export. The exported file contains two worksheets: One with the decision table and the other with instructions on how to build decision rows and prevent import errors.
Editing your decision tables in Excel can help you build large tables more quickly. You can assign the structural setup to a developer, then delegate rule authoring to someone else to complete in Excel.
Modify the decision table in Excel
- Build conditions using the operator and value columns.
- In each Operator cell, choose the relevant operator from the drop-down list. The operator list is specific to the condition column field type.
- In each Value cell, enter or select the condition value, following the format guidance from the instructions sheet.
- When building date, due date, date/time, reference, or choice conditions, you can select a value from the drop-down list.
- Specify result values.
- In each Result cell, enter the result value.
- For reference or choice results, select a result value from the drop-down list.
- Use Excel to add, remove, or edit decision rules, but do not use Excel to add or modify condition columns or result columns.
- Edit only cells in the Condition and Result columns. During the import, any data entered to the right of these columns are ignored.
- Retain the headers in the exported file, and do not modify them in any way.
- Modify only the original exported file in Excel. Do not copy and paste the contents of an exported file into a new Excel file. However, the original file can be renamed.
- Verify that there are no empty rows. Any entry after five consecutive empty rows is ignored.
Importing an Excel file into Workflow Studio
- Successful import: The Excel file import is successful. The Import window closes automatically, and your decision table is updated with the imported data. Save your changes before continuing.
- Failed import: The Excel file import has failed. Download the Error.xlsx file that contains the detailed description about the errors and how to fix them. After fixing the errors, follow the import process and import the corrected error file.
View export and import history
View the export and import history of a decision table in the History sidebar. Each entry displays the name of the user who imported or exported the file and the timestamp.
glide.ui.export.choice_list_max_characters property sets the maximum number of characters included from a condition field type when
exporting to Microsoft Excel, and the maximum number of characters displayed in the list view condition builder in Core UI. This property is of type integer and has a default value of 80. To use this property, add it
to the System Property [sys_properties] table. This property does not affect the length of condition field values in tables.Limitations
- Decision table does not contain a conditions column.
- Decision table has unsaved changes.
- Decision table has condition columns with unsupported field types.
- Decision table has a condition column that is related to an inactive input.