Script

O Script representa um cenário de teste no Probato. Ele descreve o que será executado em um determinado fluxo, sem conter lógica de execução direta. No modelo mental do Probato, o Script ocupa o nível intermediário da hierarquia, conectando a Suite às Procedures e permitindo que cenários sejam descritos de forma clara, isolada e reutilizável.

Cada Script representa uma execução independente, mesmo quando pertence à mesma Suite.

Papel do Script no Probato

O Script é responsável por:

• Definir um cenário específico dentro de uma funcionalidade
• Declarar quais dados serão utilizados na execução
• Orquestrar a execução de uma ou mais Procedures
• Definir pré e pós-condições específicas do cenário

O Script não executa lógica de negócio.

O Script descreve qual cenário será executado, não como executá-lo.

Onde o Script se encaixa no modelo mental

No fluxo conceitual do Probato, o Script está contido na Suite e atua como o elo entre intenção e execução.

Modelo conceitual

Suite
 ├── SQL (estado global / pré-condições da funcionalidade)
 ├── NoSQL (estado global / pré-condições da funcionalidade)
 └── Script
      ├── Dataset (dados de execução)
      ├── SQL (estado específico do cenário)
      ├── NoSQL (estado específico do cenário)
      ├── Precondition
      │     └── Page Object
      │           ├── Action
      │           └── Param
      ├── Procedure
      │     └── Page Object
      │           ├── Action
      │           └── Param
      └── Postcondition
            └── Page Object
                  ├── Action
                  └── Param

Cada Script representa uma execução independente dentro da Suite, podendo variar dados, estado e comportamento sem afetar outros cenários.

Responsabilidades do Script

Definição do cenário

O Script representa um cenário claro, isolado e intencional.

Exemplos de Scripts:

• Login com credenciais válidas
• Login com senha inválida
• Login com usuário bloqueado

Cada Script deve representar uma única intenção de validação, evitando múltiplos comportamentos no mesmo cenário.

Declaração de dados (Dataset)

O Script é o ponto onde os dados de teste são declarados.

Ao associar um Dataset a um Script:

• O cenário passa a ser executado múltiplas vezes
• Cada conjunto de dados gera uma execução independente
• A lógica da Procedure permanece inalterada

Isso permite execução data-driven de forma nativa, previsível e transparente.

Definição de estado específico (Database)

O Script pode declarar estado específico de banco de dados, quando necessário.

Esse estado:

• É aplicado apenas ao cenário
• Não afeta outros Scripts da mesma Suite
• Deve conter apenas dados necessários para o cenário em questão

Estados globais continuam sendo responsabilidade da Suite.

Orquestração de Procedures

O Script define quais Procedures serão executadas, bem como a ordem de execução.

Ele não conhece detalhes internos da lógica, apenas:

• Quais Procedures participam do cenário
• Em qual sequência elas devem ser executadas

Essa abordagem mantém o Script declarativo e desacoplado da implementação.

O que NÃO deve estar em um Script

Para manter a separação de responsabilidades, um Script não deve:

• Conter lógica de execução
• Interagir diretamente com Page Objects
• Acessar dados de banco manualmente
• Realizar validações complexas

Essas responsabilidades pertencem às Procedures.

Relação entre Script e Procedure

O Script funciona como um orquestrador declarativo.

Enquanto o Script:

• Descreve o cenário
• Organiza a execução

A Procedure:

• Executa a lógica
• Interage com a aplicação
• Realiza validações

Essa separação garante:

• Maior reutilização de Procedures
• Menor acoplamento entre cenários
• Scripts mais legíveis e expressivos

Boas práticas

• Crie Scripts pequenos e focados
• Evite misturar múltiplas intenções no mesmo Script
• Utilize Dataset para variação de dados, não lógica condicional
• Prefira múltiplos Scripts simples a um Script complexo

Próximo passo

Após compreender o papel do Script, o próximo conceito a ser estudado é a Procedure, responsável pela execução da lógica do cenário.

➡️ Continue em Procedure.