# Link Button

Configure a button to open a link or send an HTTP request, insert system data through snippets and display the response.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a18bf4-6e38-7715-9ed6-fb8003efe2a2"></a>

Link Button is a configurable button that an administrator can make
available to system users. When clicked, the button performs an action
defined in its configuration.

<a id="element-01a18bf4-6e38-7197-9ff7-8178884ce9f9"></a>

The button can simplify everyday tasks, such as opening a map, accessing
another system, retrieving ticket information, or sending data to an
external application. This allows users to perform specific actions
without manually searching for addresses or copying data.

<a id="element-01a18bf4-6e39-7c30-9d82-ae0c481c7d82"></a>

<a id="element-01a18bf4-6e3a-70b5-a9ad-1a1180958723"></a>

Link Button supports two action types: **Link** and **Request**. These settings are available after pressing the ![Open in a new window](https://docs.mintsd.com/api/reader/assets/assets/images/image62.png?v=0387d16f43e4cd2f748f7c35628c98f5aae39c766c69a264303c3d6923f1318c#element-01a18bf4-6e39-7c30-9d82-ae0c481c7d82) button.

<a id="element-01a18bf4-6e40-7fe1-b1cc-49297eb3a0af"></a>

**Link button sections:**

- [1. Purpose](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e42-7e0e-b131-1f3af2241092)
- [2. Configuration](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e6c-789f-9464-851439e2251e)
  - [2.1. Link configuration](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e70-7a9b-a4cd-be4cc0fbd704)
  - [2.2. Request configuration](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6ea6-7fc5-88ce-ba38755599e1)
- [3. Configuration examples](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6f0f-7025-9763-664fe5e00f3c)
  - [3.1. Opening a map — Link](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6f11-73bb-89fe-c808d8e2a0b8)
  - [3.2. Retrieving ticket status — Request](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6f25-712a-9b20-1ead5501431f)

<a id="element-01a18bf4-6e42-7e0e-b131-1f3af2241092"></a>

## 1. Purpose

<a id="element-01a18bf4-6e42-765c-8532-4ebb7a5a61f5"></a>

### Action types

<a id="element-01a18bf4-6e43-7fc7-9ada-378e84329975"></a>

### Link

<a id="element-01a18bf4-6e44-7bd9-8c68-6cecd168cec5"></a>

The Link action opens specified web addresses or launches supported
external applications.

<a id="element-01a18bf4-6e44-7abc-b513-d829ea5a42e1"></a>

Example use cases:

<a id="element-01a18bf4-6e47-76b4-8678-f9ce40d753a3"></a>

- opening a map showing a location;
- navigating to a website or a tool used at work;
- opening an application such as TeamViewer or AnyDesk.

<a id="element-01a18bf4-6e4c-7f40-b214-e3021ec35692"></a>

The administrator specifies the address to open and chooses whether it
should open in the same browser window or in a new tab.

<a id="element-01a18bf4-6e53-7cac-8879-de67469437f1"></a>

### Request

<a id="element-01a18bf4-6e54-7787-b1c5-c15a981968a8"></a>

The Request action sends requests to other systems, for example, to
retrieve information or transfer data. It can be used to communicate
with an API, an interface that allows applications to exchange data.

<a id="element-01a18bf4-6e55-7681-b5d6-80e72e206606"></a>

Example use cases:

<a id="element-01a18bf4-6e57-79ed-a512-f7cecfc22590"></a>

- retrieving the current status of a ticket;
- sending ticket data to another system;
- updating selected information in an external application;
- displaying the result of an operation.

<a id="element-01a18bf4-6e58-7383-b600-769307d72ecb"></a>

In this mode, the administrator can specify the request method,
destination address, and data sent to the external system.

<a id="element-01a18bf4-6e59-756f-8259-c778a3c8e2ec"></a>

### Using system data

<a id="element-01a18bf4-6e59-78f2-ad74-1a961cd004fa"></a>

In Request mode, snippets can be used to reference data available in
the system. This allows the button to send information related to a
specific ticket, user, asset, or contract.

<a id="element-01a18bf4-6e5a-75fd-ad89-8864af6874b5"></a>

Snippets can be added using the snippet builder, opened by clicking
the scissors icon. Instead of entering the snippet syntax manually,
the administrator selects a category and a field from which to retrieve
a value. The system automatically inserts the appropriate expression.

<a id="element-01a18bf4-6e5b-71cc-93ec-4957719a44da"></a>

Available categories include:

<a id="element-01a18bf4-6e5d-753b-9c61-36ec3cfa382e"></a>

- system data;
- user data;
- ticket data;
- asset data;
- contract data.

<a id="element-01a18bf4-6e5e-723b-9de3-c66b70c7543a"></a>

Categories may also contain custom fields created for a specific
system configuration.

<a id="element-01a18bf4-6e5e-7200-980f-22c056950fb1"></a>

For example, a button can send a ticket ID or the value of one of its
fields to an external system. Values are retrieved from the relevant
system data, allowing the same button configuration to be used for
different records.

<a id="element-01a18bf4-6e5f-754e-b23b-72f13fcb9136"></a>

### Displaying responses

<a id="element-01a18bf4-6e60-7287-ac01-6de5421bea21"></a>

In Request mode, the **Wait for response** option can be enabled to
configure how a response from an external system is displayed.

<a id="element-01a18bf4-6e61-7f29-aee3-c3dc0450cb56"></a>

When this option is enabled, the **Response modal HTML template** field
becomes available. It allows the administrator to define the appearance
of the response.

<a id="element-01a18bf4-6e62-7276-b289-046c95f5e473"></a>

The template uses HTML and can also use AngularJS. The response is
available through the `{{response}}` variable.

<a id="element-01a18bf4-6e63-7686-9d52-fcb521be5e2a"></a>

This allows the administrator to present the result in a clear and
readable format, for example, in a window with a heading and formatted
content. The template can be adapted to the type of data returned by
the external system.

<a id="element-01a18bf4-6e63-70dc-a643-1623bbbbf2b6"></a>

### Example use cases

<a id="element-01a18bf4-6e64-7c91-9a91-6e784d11deee"></a>

Link Button can simplify many everyday tasks, for example:

<a id="element-01a18bf4-6e68-7179-9413-0f5f42f60ef7"></a>

- **Opening a map** — a Link button opens a map address in a new browser
  tab.
- **Retrieving ticket status** — a Request button sends a GET request
  to an external API.
- **Sending ticket data** — a Request button sends data to another
  system, for example, using the POST method.
- **Updating information** — a Request button sends data required to
  update a record in an external system, for example, using the PATCH
  method.
- **Sending data automatically** — snippets allow the request to
  include a ticket ID or the value of a custom field.
- **Displaying operation results** — the Wait for response option and
  the Response modal HTML template allow the user to view the response
  received from an external system.

<a id="element-01a18bf4-6e69-798d-a4e6-186391a15fb7"></a>

The button’s behavior depends on its configuration and the capabilities
of the system it communicates with.

<a id="element-01a18bf4-6e6a-7924-a126-ac296574a908"></a>

[Back to Link Button overview](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e40-7fe1-b1cc-49297eb3a0af)

<a id="element-01a18bf4-6e6c-789f-9464-851439e2251e"></a>

## 2. Configuration

<a id="element-01a18bf4-6e6d-72dd-b3c4-937c0df6c5a1"></a>

<a id="element-01a18bf4-6e6f-71b7-8843-5b294ce139a5"></a>

The button is configured in the administration panel after pressing the ![Open in a new window](https://docs.mintsd.com/api/reader/assets/assets/images/image62.png?v=0387d16f43e4cd2f748f7c35628c98f5aae39c766c69a264303c3d6923f1318c#element-01a18bf4-6e6d-72dd-b3c4-937c0df6c5a1) button. Under
**Action type**, select the **Link** or **Request** tab, depending on
what the button should do.

<a id="element-01a18bf4-6e6f-729b-973c-cbc37e957519"></a>

After selecting the appropriate tab, complete the required fields and
adjust the remaining settings as needed.

<a id="element-01a18bf4-6e70-7a9b-a4cd-be4cc0fbd704"></a>

### 2.1. Link configuration

<a id="element-01a18bf4-6e71-7a86-a3c3-00cf85cbf989"></a>

![Link Button: 2.1. Link configuration](https://docs.mintsd.com/api/reader/assets/assets/images/image1458.png?v=492479b358f57e646ab2166e52a0e8840713488076ba1676e536dc5647a43ce2)

<a id="element-01a18bf4-6e72-764d-9c76-1601632b8249"></a>

The Link tab allows you to configure a button that opens a specified
address. Below are the options you can or should select for proper configuration.

<a id="element-01a18bf4-6e73-7432-96e6-c868144fb172"></a>

#### Show warning before opening the link

<a id="element-01a18bf4-6e73-7139-abb0-aa66dfd7d8e2"></a>

![Link Button: Show warning before opening the link](https://docs.mintsd.com/api/reader/assets/assets/images/image1460.png?v=2bb5840994ca08d62d10bba45e3f937398968f875f517858f4699f336e8b2cf5)

<a id="element-01a18bf4-6e74-71ad-81ae-face677b7060"></a>

This option displays a warning before opening the link.

<a id="element-01a18bf4-6e75-7a82-9b6c-73804a6fd088"></a>

Select this option if users should receive a warning before navigating
to the specified address.

<a id="element-01a18bf4-6e75-740c-8cd0-203ab052e6a4"></a>

#### Button

<a id="element-01a18bf4-6e76-7493-a582-81a7ba77f63a"></a>

This section allows you to specify the text displayed on the button.

<a id="element-01a18bf4-6e77-7b9f-8bcf-df5b07d172e9"></a>

#### Button text

<a id="element-01a18bf4-6e77-7083-8f43-bf21e33f1d25"></a>

![Link Button: Button text](https://docs.mintsd.com/api/reader/assets/assets/images/image1461.png?v=ac048c8a440881f7506abfd57788c1c4da757c1264560dce32bc7005b669aa13)

<a id="element-01a18bf4-6e79-7583-8f5f-0e8e1c244286"></a>

Here you can enter the button label which will be visible for the user. This field is required. For good responsiveness please use short, clear labels that indicate what will happen when the button
is clicked.

<a id="element-01a18bf4-6e7a-7c32-a8fc-d5204be41ed6"></a>

#### Link settings

<a id="element-01a18bf4-6e7a-7f4b-95b6-512446ae7a4e"></a>

![Link Button: Link settings](https://docs.mintsd.com/api/reader/assets/assets/images/image1462.png?v=79fa102046d9d1132790092813f33a5697dedbea1939c8827e6e66af40c94175)

<a id="element-01a18bf4-6e7b-765e-843d-08f6bee32bea"></a>

This section allows you to configure the link address and how it is
opened.

<a id="element-01a18bf4-6e7d-7f96-9e10-531e842ba096"></a>

#### Link address

<a id="element-01a18bf4-6e7e-74c4-8acf-c4397dbff33f"></a>

Enter the address that will be opened when the button is clicked.
This field is required.

<a id="element-01a18bf4-6e7f-7e46-bddf-e761a1cacaaa"></a>

The **Allowed formats** information below the field provides examples
of supported address formats:

<a id="element-01a18bf4-6e8c-75a3-8fc0-31705ae734c4"></a>

- `google.com`
- `https://google.com`
- `http://google.com`
- `www.google.com`
- `TeamViewer`
- `AnyDesk`

<a id="element-01a18bf4-6e8d-7b85-a589-52ab08e3a454"></a>

The field can be used to open websites and addresses associated with
external applications. Launching an external application depends on
whether it is installed and correctly configured on the user’s system.

<a id="element-01a18bf4-6e8e-7fab-8e7b-bede35a857d6"></a>

For websites, HTTPS addresses are recommended.

<a id="element-01a18bf4-6e8f-780b-a026-a207ec5efd3d"></a>

#### Where to open the link

<a id="element-01a18bf4-6e90-7952-a282-1660f6537d89"></a>

Select how the address should be opened.

<a id="element-01a18bf4-6e91-7e42-8758-0be999bcd653"></a>

Available options:

<a id="element-01a18bf4-6e9a-7ce2-a54e-68a7f41eb236"></a>

- **In the same window** — opens the address in the current browser
  window.
- **In a new tab** — opens the address in a new browser tab.

<a id="element-01a18bf4-6e9c-79d5-8fb8-9e45cc70245d"></a>

#### Saving the configuration

<a id="element-01a18bf4-6e9e-75ca-a713-30086e8a2dcd"></a>

After completing the required fields, you can save the button
configuration.

<a id="element-01a18bf4-6ea0-73b2-83e7-0f719d40cb02"></a>

- **Save** — saves the configuration.
- **Cancel** — cancels editing.

<a id="element-01a18bf4-6ea2-7a65-bf3b-97bd0d727960"></a>

Before saving, check that the **Button text** and **Link address**
fields have been completed.

<a id="element-01a18bf4-6ea5-7313-bfd4-d821fb9d959f"></a>

[Back to Link Button overview](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e40-7fe1-b1cc-49297eb3a0af)

<a id="element-01a18bf4-6ea6-7fc5-88ce-ba38755599e1"></a>

### 2.2. Request configuration

<a id="element-01a18bf4-6ea8-7b27-82b1-f53257ddb8f1"></a>

![Link Button: 2.2. Request configuration](https://docs.mintsd.com/api/reader/assets/assets/images/image1459.png?v=921db2116d03e6e2d5f07dcf2b15c62cd0c62ecedc20bb0222baa80dc712daa8)

<a id="element-01a18bf4-6eab-7a17-b816-8f9c3657d41d"></a>

The Request tab allows you to configure a button that sends a request
to a specified address. This can be used to communicate with other
systems, for example, to retrieve information, send data, or perform
an operation using ticket data.

<a id="element-01a18bf4-6ead-766d-98b9-08540bcbcad1"></a>

In this tab, you can specify the request method, where the request is
executed, the destination address, and additional options for handling
the request and its response.

<a id="element-01a18bf4-6eaf-7467-8a51-656c419c9394"></a>

#### Show warning before executing the request

<a id="element-01a18bf4-6eb0-789f-8c18-f172098f7c42"></a>

![Link Button: Show warning before executing the request](https://docs.mintsd.com/api/reader/assets/assets/images/image1460.png?v=2bb5840994ca08d62d10bba45e3f937398968f875f517858f4699f336e8b2cf5)

<a id="element-01a18bf4-6eb3-7d3d-b62e-2c46d5984ac6"></a>

This option displays a warning before the request is sent.

<a id="element-01a18bf4-6eb4-7ab4-9df0-4b439cdd38b9"></a>

Select this option if users should receive a warning before an
operation is performed. This can be useful when a request sends data
to another system or changes existing data.

<a id="element-01a18bf4-6eb5-7a69-a30e-d4e6d621b7e6"></a>

#### Button

<a id="element-01a18bf4-6eb6-7473-9dfa-f1534ba79fec"></a>

This section allows you to specify the text displayed on the button.

<a id="element-01a18bf4-6eb8-77d9-b123-2764b017bf88"></a>

#### Button text

<a id="element-01a18bf4-6eb8-773c-a224-41ddec0424e7"></a>

![Link Button: Button text](https://docs.mintsd.com/api/reader/assets/assets/images/image1461.png?v=ac048c8a440881f7506abfd57788c1c4da757c1264560dce32bc7005b669aa13)

<a id="element-01a18bf4-6eba-7dfc-87ba-b6c2020f18a0"></a>

Here you can enter the button label which will be visible for the user. This field is required. For good responsiveness please use short, clear labels that indicate what will happen when the button

<a id="element-01a18bf4-6ebb-7bc7-9df4-21cecf1bb649"></a>

#### Request settings

<a id="element-01a18bf4-6ebb-78f0-a595-f375eeb70888"></a>

![Link Button: Request settings](https://docs.mintsd.com/api/reader/assets/assets/images/image1463.png?v=897c5c50ac57b37657948c68ec4e4b7373a0e18342a7ec7fe951abd805bf46c8)

<a id="element-01a18bf4-6ebc-7f1a-8726-6b66b9d8de61"></a>

This section allows you to specify how the request is sent and where
it is sent.

<a id="element-01a18bf4-6ebd-715b-a6e7-0aae157793f7"></a>

#### Method

<a id="element-01a18bf4-6ebe-7d3c-8fb9-ef0109546f6f"></a>

Select the HTTP method that defines the type of operation to perform.

<a id="element-01a18bf4-6ebf-7f80-91e1-5cf448e4ac09"></a>

Available methods:

<a id="element-01a18bf4-6ec8-7de9-acce-1805a8240454"></a>

- **GET** — retrieves information from the target system.
- **POST** — sends data to the target system, for example, to create
  a new record or initiate an operation.
- **PUT** — sends data to create or replace a resource, depending on
  how the target system works.
- **PATCH** — sends data to update selected information.
- **DELETE** — sends a request to delete a resource in the target
  system.

<a id="element-01a18bf4-6ec9-7ca9-8922-a7835ce4af1c"></a>

Choose a method that matches the requirements of the system receiving
the request.

<a id="element-01a18bf4-6ecb-7639-b35b-b2d7ea6369a5"></a>

#### Where to execute the request

<a id="element-01a18bf4-6ecd-70d0-833e-ad665c5450a2"></a>

Select where the request should be executed.

<a id="element-01a18bf4-6ece-7477-8b90-8025db742cdc"></a>

Available options:

<a id="element-01a18bf4-6ed0-7113-81b9-b1c1dce038d2"></a>

- **Frontend** — the request is executed in the user’s browser.
- **Backend** — the request is executed on the server side.

<a id="element-01a18bf4-6ed1-7dad-a4b4-95ebd6997caa"></a>

The appropriate option depends on the integration method and the
requirements of the operation.

<a id="element-01a18bf4-6ed2-7c89-be8e-12cbb63cc9fc"></a>

#### Request address

<a id="element-01a18bf4-6ed3-71b3-80e0-f448a1269529"></a>

Enter the address to which the request will be sent. This field is
required.

<a id="element-01a18bf4-6ed5-7f94-99a1-03a92a6ed710"></a>

Example address:

<a id="element-01a18bf4-6ed7-7c4c-bf80-4455529cda26"></a>

```text
https://api.example.com/resource/123
```

<a id="element-01a18bf4-6ed8-70e9-a9b3-fe6433cd18d0"></a>

The address should point to an API endpoint or another service that
supports the selected request method.

<a id="element-01a18bf4-6ed9-7464-a355-255584f74930"></a>

Below the field, a button with a scissors icon opens the snippet
builder. It allows you to insert values from system data, such as a
ticket ID or a custom field value.

<a id="element-01a18bf4-6eda-7278-be44-869d944314f2"></a>

This allows the address to be adapted to the record for which the user
clicks the button.

<a id="element-01a18bf4-6edb-7101-9af7-0f6d4e9fd566"></a>

#### JSON body

<a id="element-01a18bf4-6edb-73a5-b16d-8c25aa01c699"></a>

![Link Button: JSON body](https://docs.mintsd.com/api/reader/assets/assets/images/image1464.png?v=ee5cb0eb0f06fd9a4af343f37e0e6a8659928b33db061228c10085b802fb628c)

<a id="element-01a18bf4-6edd-7253-911e-de70ada4ff84"></a>

This field specifies the request body in JSON format. It is available
for the POST, PUT, and PATCH methods.

<a id="element-01a18bf4-6edd-7733-8dd6-69393684b986"></a>

The JSON body can contain data sent to the target system. Snippets can
also be used to populate the request body with values from the system.

<a id="element-01a18bf4-6ede-7608-a278-b94ae4f35952"></a>

For example, you can send a ticket ID and its status to an external
system.

<a id="element-01a18bf4-6ede-709a-b7f1-f3fcd044da65"></a>

The JSON body field is not displayed for the GET and DELETE methods.

<a id="element-01a18bf4-6edf-7357-ab82-7d5947e57341"></a>

#### Additional options

<a id="element-01a18bf4-6ee0-7d83-9db0-ea894d7bdad1"></a>

![Link Button: Additional options](https://docs.mintsd.com/api/reader/assets/assets/images/image1465.png?v=682eca4c30f3689fd625819de55cf4bdb1eb9ddc9428000da9ab0a0ec67c37a1)

<a id="element-01a18bf4-6ee2-70c0-90ef-395efb8ae97e"></a>

#### Trust all certificates

<a id="element-01a18bf4-6ee4-7b37-88d4-4d954af3ce4b"></a>

This option relates to the verification of certificates used when
connecting to the target system.

<a id="element-01a18bf4-6ee5-7eb0-9489-e907191c3f70"></a>

Use this option with caution. In production environments, it is
recommended to leave it disabled unless there is a specific reason
to change how certificates are verified.

<a id="element-01a18bf4-6eec-7e37-b797-77e9f9e4e764"></a>

#### Wait for response

<a id="element-01a18bf4-6ef1-7131-8724-3499464e0dc9"></a>

Select this option if the button should wait for a response from the
target system and make it available for display to the user.

<a id="element-01a18bf4-6ef5-7fc8-9946-8c5435315885"></a>

When this option is enabled, the **Response modal HTML template**
field becomes available, allowing you to define how the response is
displayed.

<a id="element-01a18bf4-6ef7-7d04-90c9-ffbd2a577fcd"></a>

#### Response modal HTML template

<a id="element-01a18bf4-6ef7-7ebb-b94f-00be4b95f076"></a>

![Link Button: Response modal HTML template](https://docs.mintsd.com/api/reader/assets/assets/images/image1466.png?v=a930e8deceb33c2f76eaeed5fe9fe22ce60d06b89811d050be6a5db1c9fd6a07)

<a id="element-01a18bf4-6ef9-7452-8807-55727ae1ffb7"></a>

This field appears when **Wait for response** is enabled. It allows
you to create an HTML template that defines how the response from the
target system is presented.

<a id="element-01a18bf4-6efa-7f76-9e08-df6f43b459db"></a>

The template can use AngularJS, and the response is available through
the `{{response}}` variable.

<a id="element-01a18bf4-6efb-7a23-a5a9-2f7d6a2c00f2"></a>

Example of a simple template:

<a id="element-01a18bf4-6f03-7cf4-bf4f-a81a2dfce44e"></a>

```html
<div>
  <h3>Operation result</h3>
  <pre>{{response}}</pre>
</div>
```

<a id="element-01a18bf4-6f05-7465-8ec5-825212ec35a5"></a>

In this example, the response is displayed under the heading
“Operation result”. The `pre` element preserves the formatting of
the displayed text.

<a id="element-01a18bf4-6f06-74be-a9f1-e3b4fa72d1e7"></a>

The template can be adapted to the type of data returned by the API.

<a id="element-01a18bf4-6f07-72c4-b086-02aa52d46ef7"></a>

#### Saving the configuration

<a id="element-01a18bf4-6f07-7483-ac34-c43c9b00e63e"></a>

After completing the required fields, you can save the button
configuration.

<a id="element-01a18bf4-6f09-7516-a995-bae30f867956"></a>

- **Save** — saves the configuration.
- **Cancel** — cancels editing without saving the changes.

<a id="element-01a18bf4-6f0b-7895-a98e-2d081c7eda18"></a>

Before saving, check that the **Button text** and **Request address**
fields have been completed. Adjust the remaining settings to meet the
requirements of the operation.

<a id="element-01a18bf4-6f0d-72df-937b-47614eeff4f5"></a>

[Back to Link Button overview](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e40-7fe1-b1cc-49297eb3a0af)

<a id="element-01a18bf4-6f0f-7025-9763-664fe5e00f3c"></a>

## 3. Configuration examples

<a id="element-01a18bf4-6f11-73bb-89fe-c808d8e2a0b8"></a>

### 3.1. Opening a map — Link

<a id="element-01a18bf4-6f12-71ba-ac83-1fc603058309"></a>

To create a button that opens a map, configure it as follows:

<a id="element-01a18bf4-6f18-769a-ac02-74d81f42b4f2"></a>

| Field | Value |
| --- | --- |
| Action type | Link |
| Button text | Open map |
| Link address | Address of the selected map |
| Where to open the link | In a new tab |

<a id="element-01a18bf4-6f19-7ced-bbef-30ddee186f62"></a>

![Link Button: Field Value Action type Link Button text Open map Link address Address of the selected map Where to open the link In a new tab](https://docs.mintsd.com/api/reader/assets/assets/images/image1467.png?v=841e05895c4b7c9a1fd1dc27abc39448dd7652d87640272a9908680dc1269a52)

<a id="element-01a18bf4-6f1b-7094-9ba9-568c31abdd4c"></a>

You can enable **Show warning before opening the link** if a warning
should be displayed before opening the address.

<a id="element-01a18bf4-6f1c-7cbb-93c4-61474d89aef6"></a>

After completing the fields, click **Save** to save the configuration.

<a id="element-01a18bf4-6f1d-7ec1-9a76-5f80e0c9f597"></a>

When the user clicks the Open map button, the configured address opens
in a new browser tab.

<a id="element-01a18bf4-6f1d-7a10-871f-f49413b3a9be"></a>

![Link Button: When the user clicks the Open map button, the configured address opens in a new browser tab.](https://docs.mintsd.com/api/reader/assets/assets/images/image1468.png?v=856a23daec68c631d2e8915b1b413a414c76bd170935c615e1f42bbbcfe77a19)

<a id="element-01a18bf4-6f1f-7e2b-a392-f00fe2988fda"></a>

After clicking, if **Show warning before opening the link** was checked, the warning modal will appear

<a id="element-01a18bf4-6f1f-769f-8132-e95681700fbf"></a>

![Link Button: After clicking, if Show warning before opening the link was checked, the warning modal will appear](https://docs.mintsd.com/api/reader/assets/assets/images/image1469.png?v=0be7ecb0da0edc6423a81dc2b86293bf3d034793bdeef48fcbd871fa70e78dcd)

<a id="element-01a18bf4-6f22-777f-b984-8e8683e73a77"></a>

If the address needs to be generated using ticket or asset data, check
whether the Link address field supports dynamic value substitution
mechanisms such as snippets.

<a id="element-01a18bf4-6f23-734a-b933-e1e535a9464c"></a>

[Back to Link Button overview](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e40-7fe1-b1cc-49297eb3a0af)

<a id="element-01a18bf4-6f25-712a-9b20-1ead5501431f"></a>

### 3.2. Retrieving ticket name — Request

<a id="element-01a18bf4-6f26-71ae-a5a1-cab4f90e1b4d"></a>

The administrator wants to provide users with a button that retrieves
a ticket name from the specified ticket that user is checking at the moment. When the button is clicked,
the system sends a request to an API and then displays the response.

<a id="element-01a18bf4-6f26-747c-bc37-eeeb36c99168"></a>

Example configuration:

<a id="element-01a18bf4-6f35-7db3-8341-c83704c758b8"></a>

| Field | Value |
| --- | --- |
| Action type | Request |
| Button text | Get ticket name |
| Method | GET |
| Where to execute the request | Frontend |
| Request address | API address containing the ticket ID |
| Trust all certificates | Disabled |
| Wait for response | Enabled |

<a id="element-01a18bf4-6f38-789f-a1dd-0894ee79ef47"></a>

In the **Request address** field, enter the appropriate API endpoint.
If the address needs to include the current ticket ID, you can insert
it using the snippet builder, available by clicking the scissors icon.
In this particular example, if a user is viewing a specific ticket, the
`{{TicketId}}` snippet will be replaced with the ID of the ticket the user is currently viewing

<a id="element-01a18bf4-6f39-740d-8455-c9a587349e06"></a>

For example, the address could look like this:

<a id="element-01a18bf4-6f3b-78e9-ac72-8e748cd6442f"></a>

```text
https://mintsd.opgksoftware.com/api/tickets/{{TicketId}}
```

<a id="element-01a18bf4-6f3c-7e84-84ea-367fe0cdefde"></a>

To display the response received from the target system, enable
**Wait for response**. Then use the **Response modal HTML template**
field to create a template for displaying the returned data - in our example we want only the name parameter.

<a id="element-01a18bf4-6f3d-7e9d-88e8-422085b9a385"></a>

Example template:

<a id="element-01a18bf4-6f43-70a9-8f8b-bc3dfef8b5f0"></a>

```html
<div>
  <strong>Ticket name:</strong> {{response.data.name}}
</div>
```

<a id="element-01a18bf4-6f43-7fca-b13d-6a1a4603c07f"></a>

You can easily manage the response view by entering HTML code along with styling.

<a id="element-01a18bf4-6f44-7140-ae1c-616626c38561"></a>

Example configuration below:

<a id="element-01a18bf4-6f44-7d5d-a070-5d7adfc4a690"></a>

![Link Button: Example configuration below:](https://docs.mintsd.com/api/reader/assets/assets/images/image1470.png?v=b2e3eb9c4b925cd54a718f0d30538414decf2961fd5ae02bd6d8f73276462fca)

<a id="element-01a18bf4-6f49-70a8-bc9c-91d520acaf18"></a>

After saving the configuration, users can click the Get ticket status
button.

<a id="element-01a18bf4-6f49-7b08-9918-d0c9d80cd798"></a>

![Link Button: After saving the configuration, users can click the Get ticket status button.](https://docs.mintsd.com/api/reader/assets/assets/images/image1471.png?v=c991bfcd129896479a6af047c628cd96a3a60b8950f1917b7724ada1a6ba058f)

<a id="element-01a18bf4-6f4b-7052-8093-843d0a423b8d"></a>

The system sends a GET request to the specified address, and
the response is made available in the configured window.

<a id="element-01a18bf4-6f4c-74e8-b866-821fc39d4afc"></a>

![Link Button: The system sends a GET request to the specified address, and the response is made available in the configured window.](https://docs.mintsd.com/api/reader/assets/assets/images/image1472.png?v=8cc192d285898631feb7be5520a44c9bc96f7c2785cbda3892c4530e10827a70)

<a id="element-01a18bf4-6f4d-7966-9677-1f01020ff1eb"></a>

The actual result depends on the data returned by the API and the
configuration of the target system.

<a id="element-01a18bf4-6f4e-7061-b3d5-a8595f5719b2"></a>

[Back to Link Button overview](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-link-button#element-01a18bf4-6e40-7fe1-b1cc-49297eb3a0af)

