The Delete Calculation Table Rows task will delete the specified rows from the nominated Calculation 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.
When rows are re-added (when using the Export To Calculation Table document, for example) any Column Rules applied previously will be re-applied.
| Property Name | Description |
|---|---|
| Field Names | The column names to match against, delimited by pipe bars "|" if more than one field is to be matched against. |
| Match Values | The values to match against based on the fields specified in the Field Names property. Values should be delimited by pipe bars "|" and be in the same order as the field names. |
| Table Name | The name of the Calculation Table to remove rows from. |
| Title | Changes the Title (not the name) of the task. |
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.
| Output Name | Description |
|---|---|
| Deleted Rows Count | This is the number of rows deleted from the table. |
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
Success with warnings.
Failed (one of the following occurred)
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.
| 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 |
| 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 Calculation Table. Matching rows will be deleted. |
| Table Name | "Customers" | Customers | Customers is the name of the Calculation Table to delete these rows from. |
| Property | Example Rule | Example Result | Meaning |
|---|---|---|---|
| Field Names | "Company Name|City" | Company Name|City | Company Name and City will be used as the Fields for each column to match values against. |
| Match Values | "Amazon Warriors|Munich" | Amazon Warriors|Munich | Amazon Warriors based in Munich will be looked for in the Calculation Table in their corresponding columns. Matching rows will be deleted. |
| Table Name | "Customers" | Customers | Customers is the name of the Calculation Table to delete these rows from. |
| 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 |
| 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 |
See Also