# 1C Nota Fiscal de Entrada (COM)
Vamos considerar um exemplo de robô que cria uma nota fiscal de entrada no programa 1C. Os dados de entrada para este projeto são o arquivo “Pedido ao Fornecedor”. O trabalho é baseado na utilização de uma conexão COM com o aplicativo 1C.
Este projeto demonstra o carregamento de dados de PDF ou Excel. Para ver como funciona o trabalho com PDF, você deve conectar os blocos "Iniciar Processo" e o bloco esquerdo "Obter Caminho do Arquivo".
Para verificar o funcionamento do carregamento de um arquivo Excel, você deve conectar os blocos "Iniciar Processo" e o bloco direito "Obter Caminho do Arquivo".
O projeto do robô consiste em quatro diagramas e quatro arquivos: dois txt, pdf e xlsx. No arquivo “QueryTemplate.txt” está o modelo de consulta, escrito na linguagem 1C. Para carregar dados de arquivos pdf e xlsx, há um diagrama específico.
**Diagrama Principal** se parece com isso (para conveniência, os blocos do diagrama estão numerados):
1. **Bloco “Início”** (a partir deste bloco começa qualquer diagrama).
2. **Bloco “Obter Caminho do Arquivo”** obtém o caminho completo para o arquivo com o nome especificado. Para esses blocos, as seguintes propriedades são definidas:
* Caminho da pasta (caminho da pasta onde o arquivo necessário está localizado; se a propriedade estiver vazia, será utilizada a pasta onde este projeto está localizado);
* Nome do arquivo (nome do arquivo junto com seu formato).
Neste caso, dois blocos “Obter Caminho do Arquivo” foram utilizados em paralelo: um para o arquivo no formato pdf, e o outro para o arquivo no formato xlsx.
3. **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 especificado do projeto. A execução do cenário retornará ao bloco atual e continuará no diagrama atual assim que o bloco “Fim” for alcançado no diagrama externo. Para o bloco “Processo”, a propriedade “Nome do Diagrama” é especificada (nome do arquivo do diagrama onde a execução do cenário continuará).
Neste caso, assim como acima, dois blocos “Processo” foram utilizados em paralelo: um para carregar dados do arquivo pdf e o outro para carregar dados do arquivo xlsx.
4. **Bloco “Processo”** localizado abaixo permite criar mais um cenário, que é comum para os dois cenários descritos acima. Este processo é responsável por adicionar a nota fiscal no 1C. Para o bloco “Processo”, aqui também é especificada a propriedade “Nome do Diagrama” (nome do arquivo do diagrama onde a execução do cenário continuará).
**Diagrama "CarregarDadosDoPDF"**
1. **Bloco “Início”** (a partir deste bloco começa qualquer diagrama).
2. **Bloco “Log”** permite registrar mensagens arbitrárias e/ou valores de variáveis durante a execução do cenário do robô. Para este bloco, a propriedade “Valor” é especificada. Entre aspas, está uma constante de texto, e o nome da variável começa com o símbolo $. Ou seja, este bloco registra no log do robô uma mensagem sobre o carregamento do arquivo selecionado, especificado por meio da variável.
3. **Bloco “Executar Expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, são utilizadas duas expressões.
4. **Bloco “Extrair Tabela”** permite extrair a tabela especificada de um arquivo pdf. Para este bloco, as seguintes propriedades são definidas:
* Nome do arquivo;
* Número da página (número da página a partir da qual o texto será extraído da tabela);
* Número da tabela na página (número da tabela na página, da qual o texto deve ser extraído).
5. **Bloco “Loop Para Cada”** itera sobre todas as linhas da tabela de dados.
6. **Bloco “Obter Texto da Página”** permite ler o texto da página especificada do arquivo pdf. Para este bloco, as seguintes propriedades são definidas:
* Nome do arquivo;
* Número da página (número da página a partir da qual o texto será extraído);
* Resultado (retorna o texto extraído da página).
7. **Bloco “Encontrar Substring Entre Duas Substrings”** permite encontrar no texto uma substring que está entre duas outras substrings. Deve haver tantos blocos quanto substrings forem necessárias encontrar. Neste caso, são utilizados dois blocos “Encontrar Substring Entre Duas Substrings”: para a substring “Executor” e para a substring “Pedido”. Nas propriedades dos blocos estão especificados:
* Texto (string de entrada);
* Parte Esquerda (substring buscada à esquerda);
* Parte Direita (substring buscada à direita).
8. **Bloco “Condição”** verifica a condição especificada para ver se é verdadeira, após o que a execução do script continua na direção da saída “Sim” (se a condição for atendida) ou na direção da saída “Não” (se a condição não for atendida).
A condição é escrita no formato: “variável” é igual a (==)/ maior que (>)/ menor que (<) “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 é: $Row \[0] == $index, ou seja, se o valor da célula 0 for igual à variável $index, então a saída é “Sim”, caso contrário – a saída é “Não”.
9. **Bloco “Adicionar linha”** permite adicionar uma linha à tabela de dados. Neste caso, as seguintes propriedades são especificadas:
* Tabela (tabela de dados à qual a linha é adicionada);
* Número da linha (retorna o número da linha adicionada, a numeração começa em 0).
10. **Bloco “Gravar valor na célula”** permite gravar um valor em uma célula da tabela de dados. Neste caso, três desses blocos são usados para diferentes variáveis: $Row\[2], $Row\[3] e $Row\[5].
11. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, uma expressão é usada.
12. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, uma expressão é usada.
13. **Bloco “Fim”** (este bloco encerra a execução do script ou retorna o diagrama do subprocesso ao processo principal).
**Diagrama “CarregarDadosDeXLSX”**
1. **Bloco “Início”** (a partir deste bloco começa qualquer diagrama).
2. **Bloco “Log”** permite registrar mensagens 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 sobre o carregamento do arquivo selecionado, indicado pela variável.
3. **Bloco “Abrir documento”** permite abrir um documento Excel. Para este bloco, as seguintes propriedades são especificadas:
* Caminho do arquivo (caminho para o documento Excel que precisa ser aberto);
* Referência ao Excel (retorna uma referência ao processo de manipulação do documento Excel);
* Referência ao documento (retorna uma referência ao documento Excel aberto, no qual o trabalho está ocorrendo no momento).
4. **Bloco “Obter valor da célula”** permite ler o valor de uma célula do documento Excel. Neste caso, dois blocos “Obter valor da célula” são usados para diferentes linhas e colunas. Para este bloco, as seguintes propriedades são especificadas:
* Referência ao documento (retorna uma referência ao documento Excel aberto, no qual o trabalho está ocorrendo no momento);
* Folha (número sequencial ou nome da folha onde a célula requerida está localizada);
* Linha (número da linha onde a célula requerida está localizada);
* Coluna (número da coluna onde a célula requerida está localizada);
* Resultado (retorna o conteúdo da célula do mesmo tipo de dados que no documento Excel).
5. **Bloco “Encontrar substring entre duas substrings”** permite encontrar em um texto uma substring que está entre duas outras substrings. Deve haver tantos blocos quanto substrings precisam ser encontradas. Neste caso, dois blocos “Encontrar substring entre duas substrings” são usados: para a substring “Executor” e a substring “Pedido”. Nas propriedades dos blocos estão especificados:
* Texto (string de entrada);
* Parte esquerda (substring buscada à esquerda);\* Parte direita (subcadeia desejada à direita).
6. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, uma expressão é utilizada.
7. **Bloco “Obter valor da célula”** permite ler o valor de uma célula de um documento Excel. Para este bloco, as seguintes propriedades são especificadas:
* Link para o documento (retorna o link para o documento Excel aberto, no qual o trabalho está sendo realizado no momento);
* Planilha (número sequencial ou nome da planilha onde a célula desejada está localizada);
* Linha (número da linha onde a célula desejada está localizada);
* Coluna (número da coluna onde a célula desejada está localizada);
* Resultado (retorna o conteúdo da célula do mesmo tipo de dados que no documento Excel).
8. **Bloco “Condição”** verifica a condição especificada para ver se é verdadeira, após o que a execução do script continua na direção da saída “Sim” (se a condição for atendida) ou na direção da 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”.
9. **Bloco “Fechar documento”** permite fechar o documento Excel. Para este bloco, as seguintes propriedades são especificadas:
* Link para o Excel (retorna o link para o processo de manipulação do documento Excel);
* Link para o documento (retorna o link para o documento Excel aberto, no qual o trabalho está sendo realizado no momento).
10. **Blocos “Obter valor da célula”** permitem ler o valor de uma célula de um documento Excel. Neste caso, são utilizados dois blocos “Obter valor da célula” para diferentes linhas e colunas. Para este bloco, as seguintes propriedades são especificadas:
* Link para o documento (retorna o link para o documento Excel aberto, no qual o trabalho está sendo realizado no momento);
* Planilha (número sequencial ou nome da planilha onde a célula desejada está localizada);
* Linha (número da linha onde a célula desejada está localizada);
* Coluna (número da coluna onde a célula desejada está localizada);
* Resultado (retorna o conteúdo da célula do mesmo tipo de dados que no documento Excel).
11. **Bloco “Adicionar linha”** permite adicionar uma linha à tabela de dados. Para este bloco, as seguintes propriedades são especificadas:
* Tabela (tabela de dados à qual a linha é adicionada);
* Número da linha (retorna o número da linha adicionada).
12. **Bloco “Gravar valor na célula”** permite gravar um valor na célula da tabela de dados. Neste caso, são utilizados três blocos desse tipo para diferentes colunas e valores. Para este bloco, as seguintes propriedades são especificadas:
* Tabela (tabela de dados na qual o valor deve ser gravado);
* Linha (número da linha);
* Coluna (número da coluna, a numeração começa em 0);
* Valor (valor que deve ser gravado).
13. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, uma expressão é utilizada.
14. **Bloco “Fim”** (este bloco finaliza a execução do script ou retorna o diagrama do subprocesso ao processo principal).
**Diagrama “AdicionarNotaFiscal”**
1. **Bloco “Início”** (a partir deste bloco, qualquer diagrama começa).
2. **Bloco “Log”** permite registrar mensagens arbitrárias e/ou valores de variáveis durante a execução do script do robô. Para este bloco, a propriedade “Valor” é especificada. Aqui, este bloco registra no log do robô a mensagem “Adicionando nota fiscal”.
3. **Bloco “Ler arquivo”** permite ler o conteúdo de um arquivo de texto em uma variável. Para este bloco, as seguintes propriedades são especificadas:
* Nome do arquivo (nome do arquivo de texto cujo conteúdo deve ser lido);
* Codificação (codificação do arquivo);
* Resultado (retorna o conteúdo do arquivo).
4. **Bloco “Substituir substring”** permite substituir em um texto uma substring por outra. Neste caso, são utilizados dois blocos “Substituir substring”: para “Cliente” e para “Fornecedor”. Para esses blocos, as seguintes propriedades são especificadas:
* Texto (string de entrada);
* Substring procurada (string que deve ser substituída);
* Substring a ser inserida (string para substituir todas as ocorrências da substring procurada);
* Resultado (nova string na qual todas as ocorrências da string especificada são substituídas por outra string especificada).
5. **Bloco “Loop para cada”** itera sobre todas as linhas da tabela de dados.
6. **Bloco “Concatenar texto”** permite unir todos os elementos de strings, colocando entre eles um delimitador especificado. Para este bloco, as seguintes propriedades são especificadas:
* Lista de partes do texto (lista de strings que devem ser unidas em uma string de texto);
* Delimitador (texto usado como delimitador);
* Nova linha (flag que ativa a função onde uma nova linha será usada como delimitador);
* Resultado (string resultante).
7. **Bloco “Substituir substring”** permite substituir em um texto uma substring por outra. Para este bloco, as seguintes propriedades são especificadas:
* Texto (string de entrada);
* Substring procurada (string que deve ser substituída);
* Substring a ser inserida (string para substituir todas as ocorrências da substring procurada);
* Resultado (nova string na qual todas as ocorrências da string especificada são substituídas por outra string especificada).
8. **Bloco “Conectar”** permite criar uma conexão. Para este bloco, as seguintes propriedades são especificadas:
* String de conexão (string de conexão ao 1C);
* Usuário (nome do usuário para autenticação);
* Senha (senha para autenticação);
* Visibilidade (flag que ativa a visibilidade da janela do 1C para o usuário);
* Conexão (retorna o objeto de conexão ao 1C).
9. **Bloco “Executar código”** permite executar código no servidor. Para este bloco, as seguintes propriedades são especificadas:
* Conexão (objeto de conexão ao 1C);
* Consulta (consulta executada na linguagem 1C).
10. **Bloco “Fechar conexão”** permite fechar a conexão com o servidor 1C. Para este bloco, a propriedade “Conexão” (objeto de conexão ao 1C) é especificada.
11. **Bloco “Log”** permite registrar mensagens e/ou valores de variáveis arbitrárias no log durante a execução do script do robô. Para este bloco, a propriedade “Valor": $ErrorMassage é especificada. Ou seja, uma mensagem de erro é registrada no log do robô.
12. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, duas expressões são utilizadas.
13. **Bloco “Adicionar elemento à lista”** permite adicionar um elemento especificado ao final da lista. Para este bloco, as seguintes propriedades são especificadas:
* Lista (lista à qual o novo elemento deve ser adicionado);
* Elemento (constante, variável ou resultado de cálculos que deve ser adicionado à lista).
14. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, duas expressões são utilizadas.
15. **Bloco “Adicionar elemento à lista”** permite adicionar um elemento especificado ao final da lista. Para este bloco, as seguintes propriedades são especificadas:
* Lista (lista à qual o novo elemento deve ser adicionado);
* Elemento (constante, variável ou resultado de cálculos que deve ser adicionado à lista).
16. **Bloco “Executar expressão”** inicia a execução de uma ou mais expressões em uma linguagem compatível com PowerShell. Neste caso, são utilizadas duas expressões.
17. **Bloco “Adicionar elemento à lista”** permite adicionar o elemento especificado ao final da lista. Para este bloco, as seguintes propriedades são especificadas:
* Lista (a lista à qual o novo elemento deve ser adicionado);
* Elemento (constante, variável ou resultado de cálculos que deve ser adicionado à lista).
18. e 19. **Bloco “Fim”** (este bloco encerra 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/1s-prikhodnaya-nakladnaya-com.md?ask=
```
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.
