# Criar Ordem de Matrícula

Vamos considerar um exemplo de robô que é projetado para a formação automática e impressão de ordens de matrícula de estudantes. Os dados de entrada são um registro de estudantes (participantes do programa de treinamento). O processo é frequentemente utilizado em instituições de ensino e agências de recrutamento.

O projeto do robô consiste em dois diagramas e três arquivos, sendo um deles no formato xlsx e os outros dois no formato docx.

Se descrevermos passo a passo, este robô funciona da seguinte maneira:

1. Carrega a tabela de dados do arquivo "P1\_Treinamento\_modelo.xlsx".
2. Percorre as células com o número da ordem.
3. Acessa o cenário do diagrama “CreateEnrollmentOrder\_ProcessCreateWord”, que insere os dados, obtém a data e a hora, as transforma em texto e, em seguida, insere os dados no "P1\_Modelo de ordem de matrícula.docx", enviando-o para impressão.
4. Preenche o “Modelo de ordem de matrícula.docx", salva e imprime.

**Diagrama principal do projeto**

O diagrama principal do projeto é assim (para conveniência, os blocos do diagrama estão numerados):

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdPcwkCWPYMUfTMwBYwGZT-2G8lsrjeKsvCMAlbBE5BZLYHLPoUq0EMT_rINn-twLAV2tum0tp6DKDoxVO5N2g6f_QZ7DOSpTVpAOdubbT3VeSoB54sj0a6Pq0nJqtLAFgvMASU4C_jZtBYVLB5ijP5xLEP?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

1. **Bloco “Início”** (todas as diagramas começam a partir deste bloco).
2. **Bloco “Carregar Tabela de Dados”** permite carregar a “Tabela de Dados” de um documento Excel. Para este bloco, as seguintes propriedades são especificadas:

* Caminho do arquivo (caminho para o documento Excel do qual as informações devem ser carregadas na Tabela de Dados);
* Cabeçalho (com a flag ativada, a primeira linha será usada como cabeçalho);
* Planilha (número da planilha da qual os dados devem ser lidos na Tabela de Dados).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcRYBZsTdSg9zUKoHktBFyKGXWw8NpklhqXUEbx2LPBEIJAtzSq0CfauvQR6YeNT4TOi0ul-CJpHcsSthnJnvOrJX-njg9IfS6HJVwIYYWLIDVIIoCB41gP5nmnpaGRxUwWWI096BFvS8PU-CPepqInn3tU?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

3. **Bloco “Ciclo para cada (Tabela de Dados)”** percorre ciclicamente todas as linhas da tabela de dados.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdVPDsSXxFMhzYKTazSK7rm8YirEr8SlcD5RkghuvBzt0IKQeSTRgF8UDvd2w9gPJMT7_UfZiGFVzmA5HMckjUu4PAwMU8-64mq3_GGw2uK8Nm9zDgD8p_m20EooSkhTevK9RYGKsnWfqSvpHIVSPE-EcE?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

4. **Bloco “Processo”** permite criar cenários compostos por vários diagramas. A execução do cenário continuará a partir do bloco “Início” do diagrama do projeto especificado. A execução do cenário retornará ao bloco atual e continuará no diagrama atual assim que o bloco “Fim” do diagrama externo for alcançado. Para o bloco “Processo”, a propriedade “Nome do diagrama” é especificada (nome do arquivo do diagrama onde a execução do cenário continuará).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXep74ybO3eOkTMAaDSWwHFkK7yh8CVL80sh5NBdBkjDmfQtQ-dDycC961JjPX_nsWyZXhoW5irSClPGAOLZ0E__zLoIFglFRp-3W8YbYqq_wsZVgY70fSUcyhY2AXJ1DaGpLrzhTWbCBQFLCsX6iRp9MAWN?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

5. **Bloco “Condição”** verifica a condição especificada para ver se é verdadeira, após o que a execução do cenário continua na saída “Sim” (se a condição for atendida) ou na saída “Não” (se a condição não for atendida).

A condição é escrita no formato: “variável” é igual (==)/ maior (>)/ menor (<) “valor”.

Por exemplo: $a == “Olá”, ou seja, se o valor da variável $a for igual a “Olá”, então a saída é “Sim”, caso contrário – a saída é “Não”.

$Result > 5, ou seja, se o valor da variável $Result for menor que 5, então a saída é “Sim”, caso contrário – a saída é “Não”.

Neste caso, a condição estabelecida é: -Not \[string]::IsNullOrEmpty($Row\[0]). Ou seja, verifica se o valor da célula zero nesta linha não está vazio.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXefMrdvPilTAKF_1pXT2tVhyHCo4Q1yVy3_us79DGuOEpxIqsy9J90JUbtW8mSrIEM_mq8JBeFTNOo5cabCqUKVFwB3nQ_1C1SnP3gUhLEyrykdaip9WebVKK-mNn-_cAYDjJnqMhbwDzJMN9RkBJNHFik?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

6. **Bloco “Atribuir valor à variável”** estabelece novos valores para uma ou mais variáveis. Neste caso, nas propriedades são especificados três valores que devem ser atribuídos a três variáveis, respectivamente.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf3sdzcpZ4xW9MhN8QwdIPFJ4g_m18eTYF_N3vbJqf8IW3DBbxkY_TLBinORcrj-pKv_gSmYGQ5fVzO-GG6ZTcqyQFvaVIJ1owZATZ4Snq7ZGp6SiS6H2O67XMb00fbsKGBUkJv80BAd-XjHrgdhCey0_eE?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

3. **Bloco “Executar expressão PowerShell”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, é utilizada uma expressão: $ListFIOString += ($Index+1).ToString() + ". " + $ListFIO\[$Index] + \[Environment]::NewLine. Ela adiciona à string uma nova linha no formato “1. Ivanov Ivan Ivanovich\r\n”.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfYJuG5b7yMBfr3MnSUIZI85JspoTD1TRFqIPfMCuNN1DS8CLH3xjmjiz0FJMTO6du6MO9FVGUWBqB_dUqI1J-VuHHRimcKSOLqPV_RUm6yKPEyxTaOSph-YP_i-0o76FfEfZIX-EeOxCp598pTO2FT0is?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

4. **Bloco “Obter data e hora atuais”** permite obter a data e hora atuais de acordo com as configurações do computador do usuário. Para este bloco, foi especificada uma propriedade – “Resultado” (retorna a data e hora atuais).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdN-4fj6g5t8oIGBhCfMWA2MmujLXcHLA3YvDFy2I5DFPds-co2C29Txy_CMxn-UPq2ji0nxhtNxHyYqXu1K_d1xW6n_ZmWVa0M5i9QgcHsHMMvXiZvja6ic1I-0GrKRxW5978wGtnnFZDfSF6GhaBzERE?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

5. **Bloco “Converter data e hora em texto”** permite converter uma variável do tipo “Data e hora” para o formato de texto. Para este bloco, foram especificadas as seguintes propriedades:

* Valor (data e hora que precisam ser convertidas em texto);
* Formato (formato de conversão da data e hora em texto).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcpnNukh9HdNn5HUHrJXQjmxMLxiUw-ST23C9fv53_ct70rJHZozyAVSbV4j6n0oCDArydDysGliEWlhcDqgAThw1i5rl9zFaU2sK4Zg0k0z-qUGSm_Q1h058i6o7Lm7gmrAhTEL7T_fcHqy4Pp3ha6Ij-Q?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

6. **Bloco “Obter caminho para o arquivo”** obtém o caminho completo para um arquivo com o nome especificado. Para este bloco, foi especificada uma propriedade “Nome do arquivo” (nome do arquivo junto com seu formato).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfpyGtZKiU08PgCe3qP295c6TCrmT9-GW1xC7k4qBSbU944g4VT0cU14PGqbqW4gz7sffj-9fd-bSWMVEBKKNU_ESE_WENmPBbDXzyncFFVWzRq5id4n4MEo6hyf0Q8ySjuIwzBgLyDEAxLRmLXPjA-Z6_G?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

7. **Bloco “Abrir documento”** permite abrir um documento do Word. Para este bloco, foram especificadas as seguintes propriedades:

* Usar COM (com a flag ativada, o trabalho será realizado com o Word instalado);
* Caminho para o arquivo (caminho para o arquivo do Word que precisa ser aberto).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXflShroef1cY5801_AWfxc_zksmtDy5mG_AfdFOCaM2HSXFBKNHBRVCOjUAIc9b_7RKcWom_UAAQTkBkQZB6o3GDxAKMczFBpxGvULCqRWW7Tdub_-ZSWrN-cyTqOqx1B9UVSe4Dn2Mp-PF1_Xe4jK0RYV8?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

8. **Bloco “Substituir todas as variáveis no texto”** permite substituir todas as variáveis %variable% em um documento do Word. Para este bloco, foram especificadas as seguintes propriedades:

* Referência ao Word (referência ao processo de manipulação do documento do Word. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Referência ao Word", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram utilizados anteriormente para criar ou abrir este documento);
* Referência ao documento (referência ao documento do Word aberto, no qual o trabalho está ocorrendo no momento. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Referência ao documento", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram utilizados anteriormente para criar ou abrir este documento).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdsIihEOTKv7vTCdgouAmCIrx88pjqHdj9BW6Mjn5PyioqVhFAvStXSN13PHnD6wUTceMNURfE4qtfduiB178x5Z9pKL-59IbLi353a1MLLaJxHXELk2X3nzp8mfMDjj_C5Iz9_A9MGF_s2WgXUUBukVWUH?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

9. **Bloco “Obter caminho para o arquivo”** obtém o caminho completo para um arquivo com o nome especificado. Para este bloco, foi especificada uma propriedade “Nome do arquivo” (nome do arquivo junto com seu formato).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdekXyta3MwjF99lU-6fMVJ2XQ-9VJQuWexED6iI5fylCOO1KQjNOeyWfu1C8iaL6uYRSJmbtkIwpZwW60-vLKv0DBgGKpqd9PBmaGiRrN7FuezWTyMmrjZeYmGS91pkgpXiRtB5GJ5AUvPuhcQkSlKCAhF?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

10. **Bloco “Salvar documento”** permite salvar um documento do Word. Para este bloco, foram especificadas as seguintes propriedades:

* Referência ao Word (referência ao processo de manipulação do documento do Word, o nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Referência ao Word", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram utilizados anteriormente para criar ou abrir este documento);
* Referência ao documento (referência ao documento que precisa ser salvo. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Referência ao documento", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram utilizados anteriormente para criar ou abrir este documento);
* Caminho para o arquivo (caminho para o documento do Word).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc3ELM8kXdcL7ebcLxQ1lkjgNgvGTmAIisidIBwc7O6U-IJWQY-sF-f76wlcoMiT5yGb3tNvtARHSaUZt58SuPxk21jNGXS5EFi9HVjhHWiSsE1svEioEGG_mGJY8E13XTVRroBHYsnzbqgTuBRdGAgZD10?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

11. **Bloco “Imprimir documento”** permite enviar um documento do Word para impressão. Para este bloco, foram especificadas as seguintes propriedades:

* Referência ao Word (referência ao processo de manipulação do documento do Word. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Referência ao Word", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram utilizados anteriormente para criar ou abrir este documento);
* Referência ao documento (referência ao documento do Word aberto, no qual o trabalho está ocorrendo no momento. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Referência ao documento", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram utilizados anteriormente para criar ou abrir este documento).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXczuCO4EJ51TQUyB1exjkusI-x1BiMXPMjeoyPPuEyvFEf47KcQgwt_HlIAEDSKKrh16mZuucl0pa1BvB8s5S3aRIpr6dJqqZ2k6zimBSjV7e-qoUH3hl0ScTj-jdqsJ5-2qrXauaaQx1VGJgyxofgeyQ-Q?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

12. **Bloco “Fechar documento”** permite fechar um documento do Word. Para este bloco, foram especificadas as seguintes propriedades:\* Link para Word (link para o processo de manipulação de documentos Word. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Link para Word", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram usados anteriormente para criar ou abrir este documento);

* Link para documento (link para o documento que precisa ser fechado. O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Link para documento", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram usados anteriormente para criar ou abrir este documento).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc-tnPPCln3owM-eb58MEy1fo3q6F637kJOvxgx45pwwHyQZvEa5dmmGHRJBtTeSHHD7n66ANLmDohWMKxNwNvxlitQ83y_omYbY3sU8_k18WMVAjE5KO0cpW2_mSafU6GntJ88f8fZrYc2FN7pCsVTNIzz?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

13. **Bloco “Log”** permite registrar mensagens arbitrárias e/ou valores de variáveis no log durante a execução do script do robô. Para este bloco, a propriedade “Valor” é especificada. Entre aspas, uma constante de texto é indicada, e o nome da variável começa com o símbolo $. Ou seja, este bloco registra no log do robô uma mensagem de erro.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdR4h1HXcPWf0OeSeN3nUoLEgbeQLeRZko4X4wfPNA4Kw9DOotRS9VgF0PiLPgiFUlpT2w-Sy3N7htGH7p2F2lGmfhyxBlp1ZpwnKuXc4_8zh6rvNbGrpKxBFuiuEm5KR4x_0sHr-lSLf_5xhnfYUXJ_yo8?key=jnp0R80kKn84ibHDSqYCXA" alt=""><figcaption></figcaption></figure>

14. e 15. **Bloco “Fim”** (este bloco finaliza a execução do script ou retorna o diagrama do subprocesso ao processo principal).


---

# 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/sherpa-designer/primery-robotov/enroll-certificates/create-enrollment-order.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.