Home Search

DriveWorks Pro 21
Delete Simple Table Rows

Send Feedback

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 NameDescription
Field NamesThe column names to match against, delimited by pipe bars "|".
Match ValuesThe values to match against based on the fields specified in the Field Names property. Values should be delimited by pipe bars "|".
Table NameThe name of the Simple Table to remove rows from.
TitleChanges 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 NameDescription
Deleted Rows CountThis 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

  • N/A

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

IDCompany NameCityCountry
1Amazon WarriorsStrasbourgFrance
2Amazon WarriorsMunichGermany
3Super JetsTrevisoItaly
4Super LeagueLeedsEngland
5Super LeagueGranadaSpain

One Column

PropertyExample RuleExample ResultMeaning
Field Names"Company Name"Company NameCompany Name will be used as the Field to match values against.
Match Values"Amazon Warriors"Amazon WarriorsAmazon Warriors will be looked for in the Simple Table. Matching rows will be deleted.
Table Name"Customers"CustomersCustomers is the name of the Simple Table to delete these rows from.

Two Columns

PropertyExample RuleExample ResultMeaning
Field Names"Company Name|City"Company Name|CityCompany Name and City will be used as the Fields to match values against.
Match Values"Amazon Warriors|Munich"Amazon Warriors|MunichAmazon Warriors based in Munich will be looked for in the Simple Table in their corresponding columns. Matching rows will be deleted.
Table Name"Customers"CustomersCustomers is the name of the Simple Table to delete these rows from.

Example Result

One Column

IDCompany NameCityCountry
3Super JetsTrevisoItaly
4Super LeagueLeedsEngland
5Super LeagueGranadaSpain

The Output results for the example would be:

Output NameOutput Value
Deleted Rows Count2

Two Columns

IDCompany NameCityCountry
1Amazon WarriorsStrasbourgFrance
3Super JetsTrevisoItaly
4Super LeagueLeedsEngland
5Super LeagueGranadaSpain

The Output results for the example would be:

Output NameOutput Value
Deleted Rows Count1

DriveWorks Tech Tips Portal

Copy Table

Shows how you can copy data from one Simple Table to another, remove selected rows and clear the whole table using macros.

View all Tech Tips

Editing Table Data

This project shows how to add, edit and delete data from a Simple Table. The methods used in this can be transferred to Group Tables and also SQL Tables.

View all Tech Tips

DriveWorks Tech Tips Portal is available to DriveWorks Pro customers with an active subscription and support contract.

Tech Tips provide cut down projects that highlight specific functionality for faster and more effective learning.

To access the portal:

  1. Go to https://my.driveworks.co.uk/learn/tech-tips/
  2. Login with your DriveWorks Pro account credentials, if asked
  3. Click the Visit Tech Tips Portal button for access

The portal provides a search facility, start typing the name of the Tech Tip (as indicated above) to display the Tip you require.