> 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/link-configurations/create-a-document-link.md).

# Create a Document Link

A link configuration can turn file paths and web addresses from a data source into document links on the objects. It is an Update Link (see [Create an Update Link](https://help.auxalia.com/plant-tools/plantlink/how-to-use/link-configurations/create-an-update-link.md)) with one mapped field marked as **Document link**. This example uses a SQLite table with two columns: **Tag** holds the tag of a vessel, **DataSheet** the path of its data sheet or a web address - B-200 and B-201 name a PDF outside the project, B-202 a web address, B-203 nothing. Other data sources can be used too (see [Use SQL-Server](https://help.auxalia.com/plant-tools/plantlink/how-to-use/link-configurations/use-sql-server.md), [Use MS Access](https://help.auxalia.com/plant-tools/plantlink/how-to-use/link-configurations/use-ms-access.md), [Use MS Excel](https://help.auxalia.com/plant-tools/plantlink/how-to-use/link-configurations/use-ms-excel.md)).

1. Open **PlantLink** from the **PlantTools** ribbon and click **New\...**.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-e07af354b8c35bd59dabebc782e6de3cc82ae119%2FPL-create-a-document-link-0001.png?alt=media)
2. On **External data source selection**, select **Data source File:** and browse to the SQLite file.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-4ba8938557a94d2c4a22caae65b63b04964e001e%2FPL-create-a-document-link-0002.png?alt=media)
3. On **Link type selection**, keep **Update AutoCAD P\&ID/Plant 3D properties**. With **Drawing Properties** the document is linked to the drawing instead.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-2ebdf9dacf7f31b29103510a911df02e7a48fd24%2FPL-create-a-document-link-0003.png?alt=media)
4. On **Class selection**, select **Tanks**, and on **External data table selection** the table.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-7e19eee518a25ff91e6c896be351e97f8e5ca0c6%2FPL-create-a-document-link-0004.png?alt=media)
5. On **Linked fields selection**, link the column **Tag** to the property **Tag** with **= Equals**.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-7bd8d66e1a7856d6aa2c37105a131b1fefeb536a%2FPL-create-a-document-link-0005.png?alt=media)
6. On **Mapped fields selection**, map the column **DataSheet** to a property - here a new property **DataSheet**, created with **New Property...** (see [Create an Update Link](https://help.auxalia.com/plant-tools/plantlink/how-to-use/link-configurations/create-an-update-link.md)). The value itself is imported like any other mapped value.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-9be49c6d4787e69857ee8bd15e6a4b6a52c97626%2FPL-create-a-document-link-0006.png?alt=media)
7. Tick **Document link** for this field: updating the link then also links the document to the object.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-52408d0480494ff4413b87932c13f737db9f5bd7%2FPL-create-a-document-link-0007.png?alt=media)
8. In **Document folder**, pick or type the folder that files from outside the project are copied into - here `Data Sheets\Vessels`, a folder below the project's document folder. Leave it empty to use the document folder itself. A folder that does not exist yet is created on the first copy. The cell can only be edited where **Document link** is ticked; a folder outside the document folder is refused.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-78c338d3749233b5e29ea58b0d2ee9e50e2fe180%2FPL-create-a-document-link-0008.png?alt=media)
9. On the last page, enter a name, e.g. **Vessel Data Sheets**, and click **Finish**.

   ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-9b38d09361759fa43a63872192ee7bf3bebc4cb6%2FPL-create-a-document-link-0009.png?alt=media)
10. Run **Update Links**, select B-200 and open the **Docs** tab of the Properties palette (see [Docs Tab](https://help.auxalia.com/plant-tools/planttools/document-linking/reference/docs-tab.md)).

    ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-7ffd1e9acb880a86306352188f5feaa637616ba8%2FPL-create-a-document-link-0010.png?alt=media)

B-200's data sheet is listed in the folder **Data Sheets\Vessels** - a copy in the project's document folder. B-202 shows the web address as a hyperlink; B-203 has no link. Run **Update Links** again: nothing is copied or asked a second time. What happens on file name collisions and when the values change is described in [Create links from external data](https://help.auxalia.com/plant-tools/planttools/document-linking/workflows/links-from-external-data.md).
