> For the complete documentation index, see [llms.txt](https://help.auxalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.auxalia.com/plant-tools/plantlink/how-to-use/usage/mapping-options.md).

# Mapping Options

This chapter describes the options you have on the **Mapping** page of the **PlantLink Wizard**.

{% file src="/files/ml0AJRcvkQf78V544wc0" %}

Not all options are available for all types of Link Configurations.

The project used in this chapter is based on the project created in [Create an Update Link](/plant-tools/plantlink/how-to-use/link-configurations/create-an-update-link.md). Please make sure that you are familiar with **Update Links** to better understand the options described below.

A link with the project created during this chapter is at the end of this chapter.

<details>

<summary>Write Back</summary>

Enabling **Write Back** you can override the mapped value in the Properties Palette, Data Manager, or PlantDataManager. Let's enable **Write Back** for the Description property.

![](/files/vh3Kkphu8RhhEmpPt2rN)

Here we see die mapped data for both pumps.

![](/files/ZCvMciOyscCAvdZMPJwr)

Now we select just one pump and we change the Description.

![](/files/TsvklLFYM3UOUUKzrcsR)

When we save the drawing now, The previous mapped Description for the second pump is no out-of-date and therefore PlantLink wants us to select/update the data again.

![](/files/yI9cvXIjvcdcmKtVL4oi)

Now the Description for the second pump has been updated.

![](/files/3NX2CF6Y5ZjZRuYTGxJg)

</details>

<details>

<summary>Clear Value</summary>

By default, **Clear Value** is enabled, it means, that if PlantLink cannot find a suitable row in the table or view, or the user didn't select anything, then any value in the property will be deleted. This ensures, that there are no old values from previous mappings. This option can be used with or without a condition. A condition defines when a value should be cleared. For this example, we disable the checkbox **Clear Value** for the Model Number property.

![](/files/G6h8QSNkVyHP446fQgUA)

If you change the type to a value for which there are no rows available, all properties with the exception of the Model Number are cleared.

![](/files/cQ11RPnXxuzS41umavnM)

When selecting P again, the **PlantLink - External Data Viewer** dialog pops up again and you can select a row.

![](/files/PU8lKVGKZDtUSff92CVu)

The old **0001** value will be overridden with the new value.

![](/files/ziXcLQO04rjIk7Z8fU6O)

Now we will define an expression. What we want to accomplish is, that the **Model Number** will be cleared only, if **Manual Data** is set to **Yes**. This allows you to later enter a value for **Model Number** which will not be cleared. For that you click on the square button right of the checkbox for **Clear Value**.

![](/files/TDxVRafO301Ek6RMuQHE)

The **Expression Editor** opens.

![](/files/qDol9zlsE2cWpCobydcJ)

We use the following expression. This expression means, that if the property **Manual Data** shows no, the condition is True, otherwise it's False. Meaning, that if **Manual Data** is **No** the value in **Model Number** will be cleared. Otherwise the value will not be cleared.

![](/files/wYL98K03Q5uZ7xzX9LVa)

You can see the expression also in the tooltip.

![](/files/dfKnNUUd8jHDKYw6Wriy)

Let's start with this case were data are mapped and **Manual Data** is **No**.

![](/files/TXy8GVHHWj4rYDbuGpHU)

When we select a **Type** for which there are no data, the **Model Number** is cleared.

![](/files/6qHtM8kGgvLop2g3o3h3)

Now we select **P** again and select a row from the **PlantLink - External Data Viewer**. And now we change **Manual Data** to **Yes**.

![](/files/jwSbjLqQdxrrQoqlFam3)

If we select a type again for which there are no data, then the **Model Number** value stays.

![](/files/T0znpfKkQI6ps9kiTrNw)

</details>

<details>

<summary>Acquisition Mode Override</summary>

If a property is acquired, then PlantLink cannot map a value to this property. By default **Acquisition Mode Override** is disabled. When enabling this option PlantLink will change the **Acquisition Mode** to **Override** before mapping the value to the property. If the **Acquisition Mode** is set to **Override** and the mapped value is the same as the acquired value would be, then PlantLink will change the **Acquisition mode** back to **Acquire**. For this example, we have a second link configuration in this project for the **Hand Valves** class.

![](/files/RomJpdeaJHajub0OEwY4)

In the mapping page of the **Wizard** we check **Override Acquisition Mode**.

![](/files/JkipkcUuniQG9zvwoG2c)

In the drawing we see, that the Ball Valve acquires the **Size** from the **PipeLineSegment**.

![](/files/L7YHIQBC6UpVz8tPmBll)

If we use **Assign Data** from the context menu of the valve symbol we now select a valve with a different size as the **PipeLineSegment**.

![](/files/vPtrj4EsFuonqG226VYJ)

We see the new **Size** on the valve symbol and we see, that the **Acquisition Mode** for the **Size** property for the ball valve is set to **Override**.

![](/files/fjyqYFlwYuTHceLUykqR)

Now we select a row from the table where the **Size** matches the **Size** of the **PipeLineSegment**.

![](/files/QJUI9rERZ0J15TwNvJdR)

Now we see, that the **Acquisition Mode** is set back to **Acquire**.

![](/files/wzeXP8CmnDJCV38WfaC6)

</details>

<details>

<summary>Sync Mode</summary>

**Sync Mode** controls when the mapped properties will be updated. Although PlantLink will instantly map the properties whenever you change the values used in the linked expression, there are cases where you might want to ensure, that the mapped properties are updated. The options are: 1.Never Mapped properties will not be updated. Unless you use [Update Link Configurations](/plant-tools/plantlink/how-to-use/usage/update-link-configurations.md) 2.On Drawing Open Mapped properties will be updated when the drawing is opened 3.On Drawing Save Mapped properties will be updated when the drawing is saved The list option is the commonly used one, because it ensured, that the mapped properties are always up-to-date when saving, or saving\&closing a drawing

</details>
