Migration location to trash (#2904)

* importing_data.md: Add location trash
* importing_data.md: Add location trash example

Author: adriendupuis

code_samples/data_migration/examples/trash_location.yaml

@@ -0,0 +1,12 @@
+-
+    type: location
+    mode: trash
+    match:
+        field: location_remote_id
+        value: f3e90596361e31d496d4026eb624c983
+-
+    type: location
+    mode: trash
+    match:
+        field: location_id
+        value: 5

docs/content_management/data_migration/importing_data.md

@@ -45,34 +45,34 @@ Then, the step is described by additional properties depending on its type and m
 
 The following data migration step modes are available:
 
-| `type`                 | `create` | `update` | `delete` | `swap`   |
-|------------------------|:--------:|:--------:|:--------:|:--------:|
-| `action_configuration` | ✔ | ✔ | ✔ |          |
-| `attribute`            | ✔ | ✔ | ✔ |          |
-| `attribute_group`      | ✔ | ✔ | ✔ |          |
-| `content_type`         | ✔ | ✔ | ✔ |          |
-| `content_type_group`   | ✔ | ✔ | ✔ |          |
-| `content`              | ✔ | ✔ | ✔ |          |
-| `currency`             | ✔ | ✔ | ✔ |          |
-| `customer_group`       | ✔ | ✔ | ✔ |          |
-| `discount`             | ✔ | ✔ |          |          |
-| `discount_code`        | ✔ |          |          |          |
-| `language`             | ✔ |          |          |          |
-| `location`             |          | ✔ |          | ✔ |
-| `object_state`         | ✔ |          |          |          |
-| `object_state_group`   | ✔ |          |          |          |
-| `payment_method`       | ✔ |          |          |          |
-| `product_asset`        | ✔ |          |          |          |
-| `product_availability` | ✔ |          |          |          |
-| `product_price`        | ✔ |          |          |          |
-| `product_variant`      | ✔ |          |          |          |
-| `role`                 | ✔ | ✔ | ✔ |          |
-| `section`              | ✔ | ✔ |          |          |
-| `segment`              | ✔ | ✔ | ✔ |          |
-| `segment_group`        | ✔ | ✔ | ✔ |          |
-| `setting`              | ✔ | ✔ | ✔ |          |
-| `user`                 | ✔ | ✔ |          |          |
-| `user_group`           | ✔ | ✔ | ✔ |          |
+| `type`                 | `create` | `update` | `delete` | `swap`   | `trash`  |
+|------------------------|:--------:|:--------:|:--------:|:--------:|:--------:|
+| `action_configuration` | ✔ | ✔ | ✔ |          |          |
+| `attribute`            | ✔ | ✔ | ✔ |          |          |
+| `attribute_group`      | ✔ | ✔ | ✔ |          |          |
+| `content_type`         | ✔ | ✔ | ✔ |          |          |
+| `content_type_group`   | ✔ | ✔ | ✔ |          |          |
+| `content`              | ✔ | ✔ | ✔ |          |          |
+| `currency`             | ✔ | ✔ | ✔ |          |          |
+| `customer_group`       | ✔ | ✔ | ✔ |          |          |
+| `discount`             | ✔ | ✔ |          |          |          |
+| `discount_code`        | ✔ |          |          |          |          |
+| `language`             | ✔ |          |          |          |          |
+| `location`             |          | ✔ |          | ✔ | ✔ |
+| `object_state`         | ✔ |          |          |          |          |
+| `object_state_group`   | ✔ |          |          |          |          |
+| `payment_method`       | ✔ |          |          |          |          |
+| `product_asset`        | ✔ |          |          |          |          |
+| `product_availability` | ✔ |          |          |          |          |
+| `product_price`        | ✔ |          |          |          |          |
+| `product_variant`      | ✔ |          |          |          |          |
+| `role`                 | ✔ | ✔ | ✔ |          |          |
+| `section`              | ✔ | ✔ |          |          |          |
+| `segment`              | ✔ | ✔ | ✔ |          |          |
+| `segment_group`        | ✔ | ✔ | ✔ |          |          |
+| `setting`              | ✔ | ✔ | ✔ |          |          |
+| `user`                 | ✔ | ✔ |          |          |          |
+| `user_group`           | ✔ | ✔ | ✔ |          |          |
 
 ### Repeatable steps
 
@@ -313,6 +313,12 @@ The following example shows how to swap content items assigned to given location
 
 The metadata keys for Location are optional.
 
+The following example shows how to trash locations.
+
+``` yaml
+[[= include_file('code_samples/data_migration/examples/trash_location.yaml') =]]
+```
+
 ### Users
 
 The following example shows how to create a user.