# Âncoras

**Âncoras** — blocos no documento processado, com os quais o Robô determina em qual parte do documento determinados dados são colocados.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-ae361ef3be8dd1f16dccb1fa3dee7e4a59b40271%2Fimage%20(49).png?alt=media" alt=""><figcaption></figcaption></figure>

Com as Âncoras, são definidos os limites de determinados Atributos. O número de Âncoras pode ser ilimitado, dependendo do tipo de documento.

## Ferramentas para trabalhar com Âncoras

Ao criar uma nova Âncora, uma lista de propriedades e ferramentas para trabalhar com a Âncora é exibida no painel de trabalho.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-aba62f623dc5420b0cf7b557595c094128aa4a22%2F2025-10-01_16-54-35.png?alt=media" alt=""><figcaption></figcaption></figure>

As principais ferramentas para trabalhar com Âncoras:

<table data-header-hidden><thead><tr><th width="53"></th><th width="143"></th><th></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Ferramenta</strong></td><td><strong>Descrição</strong></td></tr><tr><td>1.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-15201dec4efa417be0850b6b3dc54fff10cb5cdb%2Fimage%20(52).png?alt=media" alt=""></td><td><p>Permite adicionar uma nova Âncora.</p><p>O botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-2174b562669f5c87a55735b3f1f064f272e4815e%2Fimage%20(53).png?alt=media" alt=""> permite adicionar uma nova Âncora subordinada, sendo necessário selecionar a propriedade “Nova Âncora subordinada” na lista.</p></td></tr><tr><td>2.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-4c92265d7b7373314bc57602121a6e672e09b3cb%2Fimage%20(54).png?alt=media" alt=""></td><td>Permite mover a Âncora para cima.</td></tr><tr><td>3.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-1f0b99ec1ccbd12ccae483d074f4b4d16fe3505c%2Fimage%20(55).png?alt=media" alt=""></td><td>Permite mover a Âncora para baixo.</td></tr><tr><td>4.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-1111ba5dcbb763d0b626baa63ac7582733f93cac%2Fimage%20(56).png?alt=media" alt=""></td><td>Permite copiar a Âncora selecionada e adicionar automaticamente uma nova Âncora com as configurações especificadas.</td></tr><tr><td>5.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-740012e9fb37f604ee0dccb758c2df85f6f21751%2Fimage%20(57).png?alt=media" alt=""></td><td>Permite excluir a Âncora selecionada.</td></tr><tr><td>6.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-d61eeb78b228cfdba0556b529b79d895900c8b65%2Fimage%20(58).png?alt=media" alt=""></td><td>Permite adicionar uma nova vinculação à Âncora selecionada.</td></tr><tr><td>7.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-803c1e75d7a89624a2cb1c94a1d42904f7ecedf3%2Fimage%20(59).png?alt=media" alt=""></td><td>Permite excluir a vinculação selecionada.</td></tr><tr><td>8.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-f730fa8fd624801db6b8ae4aa0efe16342e45883%2Fimage%20(60).png?alt=media" alt=""></td><td>Permite mover a vinculação para cima.</td></tr><tr><td>9.</td><td>botão <img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-43e77ec85bb1530cbeed075960b72769dc0aab9a%2Fimage%20(61).png?alt=media" alt=""></td><td>Permite mover a vinculação para baixo.</td></tr></tbody></table>

## **Configurações da Âncora**

Parâmetros de configuração da Âncora:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-2132817973a93aab2b0b3576e379ee9d6c7c3828%2Fimage%20(62).png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="53"></th><th width="175"></th><th></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Parâmetro</strong></td><td><strong>Valor do parâmetro</strong></td></tr><tr><td>1.</td><td>ID</td><td>Identificador da Âncora. Atribuído automaticamente.</td></tr><tr><td>2.</td><td>Vinculações de âncoras</td><td>Lista de vinculações de âncoras.</td></tr><tr><td>3.</td><td>Tipo</td><td><p>Tipo da Âncora. Selecionado a partir de uma lista suspensa:</p><ul><li>Texto – texto;</li><li>Tabela – tabela ou célula da tabela;</li><li>Pacote – pacote de Âncoras intercambiáveis (ao vincular a esta Âncora, suas Âncoras subordinadas serão consideradas, sendo a primeira a Âncora encontrada com sucesso na lista).</li></ul></td></tr><tr><td>4.</td><td>Valor</td><td><p>Valor da Âncora.<br><br>Para Âncoras do tipo “Texto”, é possível usar caracteres curinga: <code>(*)(?)</code>.<br></p><p>Para Âncoras do tipo “Tabela”, o valor é registrado no formato:</p><p>“Índice da tabela:Índice da linha:Índice da coluna”</p><p>Exemplo para Âncora do tipo “Texto”:</p><p><code>“*região* seguro*”</code></p><p>(duas palavras ao ativar “Palavras separadas”)</p><p>Exemplos para Âncora do tipo “Tabela”:</p><p><code>“0:1:2”</code></p><p>(tabela 0, linha 1, coluna 2)</p><p><code>“1:2”</code></p><p>(tabela 1, linha 2)</p><p><code>“2”</code></p><p>(toda a tabela 2)</p></td></tr><tr><td>5.</td><td>Modo de operação</td><td><p>Modo de operação da Âncora.<br><br>Valores possíveis:</p><ul><li>Padrão – Âncora obrigatória na primeira página de um documento de várias páginas;</li><li>ÚltimaPágina – Âncora obrigatória em um documento de várias páginas que indicará a última página;</li><li>Opcional – Âncora não obrigatória. Se não for encontrada na página, nenhum erro será gerado.</li></ul></td></tr><tr><td>6.</td><td>Modo de verificação de valor</td><td><p>Seleção do modo de verificação de valores.<br><br>Valores possíveis:</p><ul><li>Padrão (por padrão);</li><li>EveryWordContains (verificação de cada palavra no valor como ocorrência na string. Exemplo: <code>“teste” => ”*teste*”</code>);</li><li>RemoveNonWordSumbols (na verificação, todos os símbolos não numéricos e não alfabéticos são removidos).</li></ul></td></tr><tr><td>7.</td><td>Palavras separadas</td><td>O valor da Âncora é dividido em palavras e cada palavra é buscada separadamente.</td></tr><tr><td>8.</td><td>Ignorar maiúsculas e minúsculas</td><td>Com esta configuração ativada, será ignorada a distinção entre maiúsculas e minúsculas.</td></tr><tr><td>9.</td><td>Número de blocos</td><td>Se a configuração “Palavras separadas” estiver ativada, ao buscar a Âncora, pode ocorrer uma situação em que vários valores de blocos correspondentes às palavras especificadas sejam encontrados na área designada.<br><br>Esta propriedade permite limitar o número máximo de palavras entre os blocos.</td></tr><tr><td>10.</td><td>Verificação da posição dos blocos</td><td>Com esta configuração ativada, a posição dos blocos é verificada em relação à coordenada Y e são considerados os blocos com o menor valor.</td></tr><tr><td>11.</td><td>Busca reversa</td><td>Com esta configuração ativada, a busca da Âncora será feita de baixo para cima na página.</td></tr><tr><td>12.</td><td>Capturar blocos adjacentes</td><td>Captura de blocos próximos à Âncora.<br><br>Permite capturar na Âncora blocos próximos ao valor já capturado.<br><br>Por exemplo, se especificar <code>+2-1</code>, os blocos próximos (<code>2</code> blocos à direita e <code>1</code> bloco à esquerda) serão adicionados à Âncora já capturada.<br><br>Esta propriedade pode ser utilizada quando não é possível estabelecer um valor totalmente estável para a Âncora, mas parte dela tem um valor estável.</td></tr><tr><td>13.</td><td>Porcentagem da imagem</td><td><p>Porcentagem da imagem na qual a busca da Âncora será realizada.<br><br>O valor deve ser registrado como um único número ou dois números separados por um hífen.<br><br>Por exemplo:</p><p>30 (0-30) - serão utilizados 0-30 % da imagem;<br>30-70 - será utilizada parte da imagem;<br>70-100 - serão utilizados os 30 % inferiores da imagem.</p></td></tr><tr><td>14.</td><td>Descrição</td><td>Descrição personalizada da Âncora.</td></tr><tr><td>15.</td><td>Âncoras subordinadas</td><td><p>Âncoras que dependem diretamente da Âncora pai.<br><br>A busca por Âncoras subordinadas ocorrerá apenas após a Âncora principal/pai ser encontrada.<br><br>No caso de:</p><ul><li>no configurações da Âncora pai estiver definido o modo Opcional (ou seja, a Âncora não é obrigatória),</li><li>a Âncora pai não foi encontrada,</li></ul><p>a busca por Âncoras subordinadas não será realizada, e as Âncoras serão ignoradas.<br><br>Este parâmetro é utilizado se o Atributo estiver no meio de um documento de várias páginas.</p></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/shablonizator/interfeis-shablonizatora/panel-nastroek-shablonizatora/yakorya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
