> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/settings/url-actions.md).

# Ações de URL

Settings › URL Actions define links com variáveis, como a página de um cliente na central de atendimento ou na documentação, que você abre na árvore de clientes e sites com Run URL Action.

## O que é e quando usar

Uma ação de URL é um link com variáveis. Você a define uma vez em **Admin Center › Settings › URL Actions** e depois a abre para um cliente ou um site a partir da árvore de clientes: o SONAR preenche as variáveis com os valores desse cliente ou site e abre o resultado em uma nova aba do navegador.

Use as ações de URL para ir do SONAR a outra ferramenta com o registro certo já selecionado: a página do cliente na sua central de atendimento, a pasta do site no seu sistema de documentação, uma busca na sua ferramenta de inventário.

As ações de URL e os webhooks são definidos da mesma maneira, mas fazem coisas diferentes:

|           | Ações de URL                       | Webhooks                                                                           |
| --------- | ---------------------------------- | ---------------------------------------------------------------------------------- |
| Aba       | **URL Actions**                    | **Web Hooks**                                                                      |
| Quem abre | O seu navegador, quando você clica | O SONAR, quando um alerta é disparado ou resolvido                                 |
| O que é   | Um link                            | Uma requisição HTTP com método, cabeçalhos e corpo                                 |
| Página    | Esta página                        | [Webhooks](https://wiki.datadike.com/pt/sonar/administration/settings/webhooks.md) |

Como é o seu navegador que abre o link, uma ação de URL pode apontar para um sistema que só a sua própria rede alcança.

## Antes de começar

* Para listar e executar ações de URL, seu papel precisa de **Run URL Actions** (grupo **System** em **Admin Center › Roles**).
* Para adicioná-las, editá-las ou excluí-las, seu papel também precisa de **View Core Settings** e **Edit Core Settings** (grupo **Settings**).
* Para executar uma delas em um cliente ou site, o papel precisa lhe dar acesso a esse cliente ou site.

## Passos

### Adicionar uma ação de URL

1. Abra **Admin Center › Settings** e a aba **URL Actions**.
2. Clique em **Add URL Action**.
3. Digite um **Name**. É o rótulo exibido no menu **Run URL Action**.
4. Se quiser, digite uma **Description**.
5. Digite o **URL Pattern**, com variáveis onde os valores devem entrar, por exemplo `https://helpdesk.example.com/customers?search={{client.name}}`.
6. Clique em **Submit**.

### Executar uma ação de URL

1. Abra **Dashboard › Sysadmin**.
2. Na barra lateral, em **Clients**, clique com o botão direito em um cliente ou site.
3. Aponte para **Run URL Action** e clique na ação.

O SONAR monta a URL para esse cliente ou site e a abre em uma nova aba.

### Editar ou excluir uma ação de URL

1. Na aba **URL Actions**, clique duas vezes na ação para abrir **Edit URL Action**, altere-a e clique em **Submit**.
2. Para excluí-la, clique na ação com o botão direito, escolha **Delete** e confirme com **Delete**.

## Variáveis

| Variável                             | Substituída por                                                                                                                                                                                         |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{{client.name}}`                    | O nome do cliente. Em um site, o nome do cliente do site                                                                                                                                                |
| `{{client.id}}`                      | O ID do cliente, exibido na dica que aparece sobre o cliente na árvore                                                                                                                                  |
| `{{site.name}}`                      | O nome do site, quando a ação é executada em um site                                                                                                                                                    |
| `{{site.id}}`                        | O ID do site, quando a ação é executada em um site                                                                                                                                                      |
| `{{client.FIELD}}`, `{{site.FIELD}}` | O valor do campo personalizado chamado `FIELD` no cliente ou no site, ou o valor padrão dele. Veja [Campos personalizados](https://wiki.datadike.com/pt/sonar/administration/settings/custom-fields.md) |
| `{{global.NAME}}`                    | O valor da chave `NAME` no repositório de chaves. Veja [Repositório de chaves](https://wiki.datadike.com/pt/sonar/administration/settings/key-store.md)                                                 |

A URL final é codificada para o navegador, de modo que os espaços no nome de um cliente viram `%20`. A lista completa de variáveis está em [Variáveis de script](https://wiki.datadike.com/pt/sonar/reference/script-variables.md).

## O que você deve ver

O quadro **URL Actions** lista cada ação com **Name**, **Description** e **URL Pattern**; sem nenhuma, ele mostra **No URL Actions added yet.**

Na árvore de clientes, **Run URL Action** abre um submenu com as ações de URL em ordem alfabética. Clicar em uma delas abre uma nova aba do navegador na URL final. Sem nenhuma ação de URL definida, um aviso informa que nenhuma está configurada.

## Como verificar se funcionou

1. Execute a ação em um cliente de teste. A nova aba precisa abrir na URL com os valores do cliente no lugar das variáveis.
2. Abra **Reports & Audits › Audits** e escolha **URL Action** em **Action**. Uma entrada registra quem executou qual padrão de URL em qual cliente ou site. Veja [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md).

## Erros comuns

| Sintoma                                                                                    | Causa                                                                                                             | Correção                                                                            |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| A URL contém `None`                                                                        | Uma variável não pôde ser resolvida: está grafada errado, ou é um campo personalizado ou uma chave que não existe | Confira a variável na tabela acima, e os nomes em **Custom Fields** e **Key Store** |
| Uma variável de site mostra o valor do cliente                                             | A ação foi executada em um cliente, que não tem site                                                              | Execute as ações que usam variáveis de site em um site                              |
| **Failed to save** com uma mensagem sobre um campo em branco                               | **Name** ou **URL Pattern** está vazio                                                                            | Preencha os dois                                                                    |
| **Run URL Action** aparece desabilitado, com **You don't have permission for this action** | O papel não tem **Run URL Actions**                                                                               | Conceda essa permissão em **Admin Center › Roles**                                  |
| **Failed to load actions** na aba **URL Actions**                                          | O papel não tem **Run URL Actions**                                                                               | Conceda essa permissão, ou peça a um usuário que a tenha                            |
| Nada abre                                                                                  | O navegador bloqueou a nova aba                                                                                   | Permita janelas pop-up para o console                                               |
| A nova aba abre, mas a página não é encontrada                                             | O padrão de URL não corresponde ao sistema de destino                                                             | Teste a URL final manualmente e corrija o padrão                                    |

## Referência de campos

| Campo           | O que faz                                             | Valores aceitos                                                      | Padrão |
| --------------- | ----------------------------------------------------- | -------------------------------------------------------------------- | ------ |
| **Name**        | Rótulo no menu **Run URL Action** e na lista          | Texto. Obrigatório                                                   | Vazio  |
| **Description** | Nota para os outros administradores, exibida na lista | Texto                                                                | Vazio  |
| **URL Pattern** | O link, com as variáveis entre chaves duplas          | Uma URL completa, começando com `https://` ou `http://`. Obrigatório | Vazio  |

## Páginas relacionadas

* [Webhooks](https://wiki.datadike.com/pt/sonar/administration/settings/webhooks.md): requisições que o SONAR envia nos alertas
* [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md): a árvore onde as ações de URL são executadas
* [Campos personalizados](https://wiki.datadike.com/pt/sonar/administration/settings/custom-fields.md): valores que você pode pôr em uma URL
* [Repositório de chaves](https://wiki.datadike.com/pt/sonar/administration/settings/key-store.md): valores globais que você pode pôr em uma URL
* [Variáveis de script](https://wiki.datadike.com/pt/sonar/reference/script-variables.md): a lista completa de variáveis
