Delete Simple Table Rows
The Delete Simple Table Rows task will delete the specified rows from the nominated Simple Table Name.
When using pipebar (|) delimited lists to delete from multiple columns please note you can only match
ONE item for each column to delete having specified the columns in the Field Names property and
the Items in the Match Values property.
You can not use a pipebar delimited list to delete multiple different items from the same column. You can only
delete multiple of the same item from a column.
It is important to make sure that the number of items in the Match Values property is the same as the number of
columns specified in the Field Names.
If you specify two columns to look in for the Field Names property you must make sure you have two items
specified for the Match Values property as well.
Properties
Property Name | Description |
---|
Field Names | The column names to match against, delimited by pipe bars "|". |
Match Values | The values to match against based on the fields specified in the Field Names property. Values should be
delimited by pipe bars "|". |
Table Name | The name of the Simple Table to remove rows from. |
Title | Changes the Title (not the name) of the task. |
Outputs
This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.
Outputs are only available within Specification Macros. Currently Outputs are not available Specification Flow.
Data Outputs
Output Name | Description |
---|
Deleted Rows Count | This is the number of rows deleted from the table. |
Status Outputs
This task supports Status Outputs. These can be used to perform different actions depending on what the status
outcome of the task is. For more information see Status Outputs in the Task Node
Outputs section of Specification Macros Task Node.
The status output navigation is as follows:
Success
- Rows successfully deleted.
Success with Warnings
Failed (one of the following occurred)
- Unable to find table with name provided.
- Table found is not a simple table.
- Field names not found.
- Match values not found.
- General failure - Check the specification report for more details.
Examples
When this task is added the properties are static by default.
See How To: Change A
Static Property To A Dynamic Property to enable rules to be built on these properties.
Example Data
ID | Company Name | City | Country |
---|
1 | Amazon Warriors | Strasbourg | France |
2 | Amazon Warriors | Munich | Germany |
3 | Super Jets | Treviso | Italy |
4 | Super League | Leeds | England |
5 | Super League | Granada | Spain |
One Column
Property | Example Rule | Example Result | Meaning |
---|
Field Names | "Company Name" | Company Name | Company Name will be used as the Field to match values against. |
Match Values | "Amazon Warriors" | Amazon Warriors | Amazon Warriors will be looked for in the Simple Table. Matching rows will be deleted. |
Table Name | "Customers" | Customers | Customers is the name of the Simple Table to delete these rows from. |
Two Columns
Property | Example Rule | Example Result | Meaning |
---|
Field Names | "Company Name|City" | Company Name|City | Company Name and City will be used as the Fields to match values against. |
Match Values | "Amazon Warriors|Munich" | Amazon Warriors|Munich | Amazon Warriors based in Munich will be looked for in the Simple Table in their corresponding columns.
Matching rows will be deleted. |
Table Name | "Customers" | Customers | Customers is the name of the Simple Table to delete these rows from. |
Example Result
One Column
ID | Company Name | City | Country |
---|
3 | Super Jets | Treviso | Italy |
4 | Super League | Leeds | England |
5 | Super League | Granada | Spain |
The Output results for the example would be:
Output Name | Output Value |
---|
Deleted Rows Count | 2 |
Two Columns
ID | Company Name | City | Country |
---|
1 | Amazon Warriors | Strasbourg | France |
3 | Super Jets | Treviso | Italy |
4 | Super League | Leeds | England |
5 | Super League | Granada | Spain |
The Output results for the example would be:
Output Name | Output Value |
---|
Deleted Rows Count | 1 |
Additional Resources
MyDriveWorks - Tech Tips
Table Actions
Learn how to add, edit, delete and copy data from a Simple Table inside DriveWorks with this Tech Tip. The demonstrated functionality can be applied to other Table t
Table Control
Learn more about manipulating Calculation Table data as well as Simple Table data inside DriveWorks Projects.
Tech Tips Index
View all available MyDriveWorks Tech Tips.
DriveWorks Tech Tips Index