# Documento de Design de Processo (PDD)

O Documento de Design de Processo (PDD) é um modelo para documentar processos automatizados no Sherpa Designer.

O PDD é gerado ao clicar no botão "Documentar..." no menu "Projeto".

O modelo PDD é carregado automaticamente pelo Sherpa Designer no campo "Modelo PDD" e não é alterado durante o processo de geração do documento.

O PDD é destinado a descrever os processos atuais (AS IS) e os processos alvo (TO BE), parâmetros e configurações.

* AS IS no modelo contém o diagrama e a descrição do processo atual manual ou parcialmente automatizado. Registra os passos reais, aplicativos, funções dos funcionários e gargalos para análise antes da robotização.
* TO BE inclui o diagrama com o processo automatizado (blocos do Sherpa Designer, sequência de ações, número de etapas) e reflete o processo final com integrações do Sherpa Orchestrator e estatísticas dos blocos.
* Parâmetros incluem tabelas que contêm dados destinados à transferência entre blocos e esquemas JSON.
* Configurações incluem: credenciais, flags, estatísticas sobre o funcionamento dos blocos e sua interação, dados do Sherpa Orchestrator e registro.

### Estrutura do modelo

O modelo inclui seções com tabelas e imagens de diagramas:

1. Propósito do documento — a seção define o objetivo do PDD (documentação padronizada dos processos RPA do Sherpa RPA para transferência de conhecimento entre desenvolvedores, analistas e partes interessadas).
2. Controle do documento — a seção permite rastrear cada alteração no documento.

Contém informações sobre:

2.1. Histórico de alterações — tabela com colunas “Data”, “Versão”, “Descrição resumida das alterações”, “Autor”, “Função”. Registra a evolução do documento para auditoria e controle.

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

2.2. Contatos — tabela que contém uma lista de responsáveis: “Nome Completo”, “Função”, “E-mail”, o que facilita a comunicação sobre o projeto.

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

3. Glossário — tabela para registrar termos, suas abreviações e definições, que permite padronizar a terminologia dentro do projeto.

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

4. Informações gerais sobre o processo — tabela com métricas e características-chave para avaliar a eficácia da robotização.

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

5. Descrição do processo AS IS — seção que apresenta informações sobre o processo atual antes da automação.

5.1. Informações gerais — descrição do processo atual com blocos e integrações.

5.2. Diagrama de alto nível do processo AS IS — imagem (650px) que mostra o diagrama do processo atual.

5.3. Descrição das etapas do processo AS IS — tabela com a detalhamento das etapas do processo atual, ações dos usuários e software utilizado.

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

6. Descrição do processo TO BE — seção que apresenta informações sobre o processo automatizado.

6.1. Descrição geral do processo robotizado — descrição do processo otimizado com blocos e integrações.

6.2. Diagrama de alto nível do processo TO BE — imagem (650px) que mostra o diagrama do processo automatizado.

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

7. Ambiente e sistemas de TI interagentes — tabela que descreve os sistemas envolvidos no processo: nomes dos sistemas, logins e senhas para acesso do robô, além de serviços externos e os respectivos blocos do Sherpa Designer: nomes dos serviços, nomes dos blocos de automação, paletas.

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

8. Dados de entrada — tabela que descreve os parâmetros que chegam ao robô para execução de tarefas dentro do processo, bem como o local de armazenamento dos dados e um exemplo do arquivo que os contém.

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

9. Dados de saída (Relatórios de trabalho dos robôs) — tabela que descreve os parâmetros gerados como resultado do trabalho do robô e transmitidos na forma de relatórios do processo, além do local de armazenamento dos dados e um exemplo do arquivo que os contém.

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

10. Estrutura de pastas do projeto — tabela que descreve a estrutura de pastas do projeto.

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

11. Diagramas do projeto — duas tabelas, a primeira das quais descreve os diagramas-chave no processo apresentado, e a segunda descreve cada diagrama separadamente, bem como a quantidade de diferentes blocos que o compõem.

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

12. Estatísticas dos blocos — tabela que contém dados sobre o número de execuções dos blocos do Sherpa Designer envolvidos neste processo.

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

13. Bibliotecas dependentes — tabela que contém dados sobre as bibliotecas utilizadas pelo robô durante seu funcionamento, bem como seu idioma e finalidade.

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

13. Trabalho com o Orquestrador — seção que contém informações sobre a configuração de filas, ativos, agendamentos do Sherpa Orchestrator.

14.1. Lista de filas utilizadas no projeto — tabela que descreve a configuração das filas do Sherpa Orchestrator para cada bloco do robô.

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

14.2. Ativos. Variáveis do Orchestrator (Assets) — subseção que registra a vinculação dos blocos do Sherpa Designer aos ativos do Sherpa Orchestrator.

14.3. Credenciais — tabela que descreve as credenciais utilizadas pelo robô para interagir com o Sherpa Orchestrator.

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

14.4. Outras variáveis — tabela que descreve as variáveis utilizadas pelo robô no processo (ao trabalhar com o Sherpa Orchestrator).

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

15. Registro — seção na qual são documentados todos os pontos de registro do robô Sherpa RPA para monitoramento, depuração e auditoria.

15.1. Registro NLog — configuração nlog.config.xml, contendo caminhos de logs. Define a rotação e os níveis (Info, Error, Debug) do registro em arquivo.

15.2. Pontos de registro local — tabela que descreve os blocos, ao executar o robô localmente, que coletam dados sobre os diagramas e os erros que ocorrem neles.

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

15.3. Pontos de registro no Orquestrador — tabela que descreve os blocos, ao registrar no Sherpa Orchestrator, que coletam dados sobre os diagramas e os erros que ocorrem neles. Também apresenta capturas de tela e níveis de mensagens de saída.

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

16. Logins e senhas para sistemas — tabela que apresenta todos os logins e senhas necessários para acessar os sistemas e serviços utilizados no trabalho do robô.

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

17. Modo de operação do robô — tabela que descreve os agendamentos e configurações de inicialização do robô no Sherpa Orchestrator.

    <figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-75359f18384ab575e2a5c2fd4b7bfbdc41c46e21%2Funknown%20(29).png?alt=media" alt=""><figcaption></figcaption></figure>
18. Erros durante a operação do robô — nesta seção são apresentadas descrições de erros que são tratados pelo robô ou são falhas sistêmicas, o que permite entender o algoritmo de ações em diferentes incidentes.

18.1. Tratados pelos robôs (incorporados na lógica do processo) — tabela que descreve o comportamento do usuário em caso de falhas incorporadas na lógica do processo.

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

18.2. Falhas sistêmicas e outros erros — tabela que descreve o comportamento do usuário em caso de falhas sistêmicas.

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

### Geração de PDD

Informações detalhadas sobre a geração do documento estão disponíveis no link:

<https://docs.sherparpa.ru/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-instrumenty/menyu-instrumenty#dokumentirovat>


---

# 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/rabota-v-sherpa-designer/osnovnoe-menyu/panel-instrumenty/menyu-instrumenty/dokument-process-design-document-pdd.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.
