Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

O que é?

É uma atividade que facilita a criação de um Alias dentro do ambiente RM, facilitando o compartilhamento de informações da conexão entre as atividades ao longo do projeto através do recurso de Alias que são apelidos personalizados para a conexão.

Para que serve?

Essa atividade é útil para criar um Alias que atua como um identificador de conexão para diversos bancos de dados, simplificando o gerenciamento de múltiplos ambientes e conexões dentro de um projeto.

Exemplo de Uso 

Deck of Cards
idCria alias RM
Card
labelParâmetros da atividade

Parâmetros de Atividade

Cria alias RM: É considerada uma atividade fixa dentro do TestFlow. Atividades fixas não são passíveis de serem cadastradas, podemos apenas usá-las dentro de um projeto de teste, isso facilita a utilização dessa atividade pois não hà um versionamento ligado ao projeto de teste e a utilização dessa atividade é sobre demanda.

Pré-requisito: Para realizar a passagem de parâmetros para uma atividade 'Cria alias RM' é necessário já ter inserido esta atividade em um Projeto de Teste.


Expandir
titleSchema JSON
Bloco de código
languagejs
themeRDark
titleMetadados JSON - Cria alias RM
linenumberstrue
Alias:  { type: string, required: true, description: Nome do alias a ser criado }

DbProvider: { type: "SqlClient" | "OracleClient", required: true }

DbType: { type: "SqlServer" | "Oracle", required: true }

DbName: { type: string, required: true }

DbServer: { type: string, required: true }

Username: { type: string, required: true }

Password: { type: string, required: true }
Expandir
titleJSON de exemplo
Bloco de código
languagejs
themeRDark
titleExemplo de JSON a ser passado por parâmetro
linenumberstrue
{
  • Descrição:

A atividade "Cria Alias RM" realiza uma configuração no RM, a fim de adicionar uma conexão de banco de dados e nomeando-a. Com isto um recurso de alias é gerado, e pode ser utilizado no projeto. 

  • Parâmetros (JSON): 

Alias:  { type: string, required: true }

DbProvider: { type: "SqlClient" | "OracleClient", required: true }

DbType: { type: "SqlServer" | "Oracle", required: true }

DbName: { type: string, required: true }

DbServer: { type: string, required: true }

Username: { type: string, required: true }

Password: { type: string, required: true }

Note: Estes parâmetros podem ser substituídos por um "Recurso de conexão a banco", geralmente são oferecidos por atividades do tipo "Restauração de banco de dados relacional".

  • Recursos:

Necessita: Recurso de Banco (Não obrigatório)

Oferece: Recurso de Alias

  • Validações:

Parâmetros ou Recursos não informados. Seta status da atividade como erro.

Trata no caso de cancelamento pelo usuário. Seta status da atividade como erro.

Levanta exceção se por algum motivo o Alias não puder ser criado. Diretório do ambiente não existente por exemplo. Seta status da atividade como erro.

No caso de criar o Alias grava o status da atividade como sucesso e incrementa os passos de execução do projeto.

  • Exemplo:
Bloco de código
{

	"Alias": "CorporeRM",

	"DbProvider": "SqlClient",

	"DbType": "SqlServer",

	"DbName": "
NOME_DATABASE
EXEMPLO1212502",

	"DbServer": "
HOST_DATABASE
SERVER-SQL-BH",

	"Username": "
NOME_DO_USUARIO
user",

	"Password": "
SENHA_SECRETA" }
sua-senha"
}
Card
labelRecursos

Para acessar os recursos dessa atividade acesse a documentação a seguir: Recurso Cria alias RM

Card
labelExemplo prático

Exemplo Prático

Imagine que você faz parte da equipe de Fiscal e precisa realizar um teste para o cadastro de uma nova moeda no sistema. Para garantir que o processo foi realizado corretamente, é necessário ter uma base restaurada ou restaurar no projeto de teste, criar um alias RM e verificar se o registro da nova moeda foi inserido na base restaurada após o teste automatizado, isso garantirá que a base, o alias foram criados e os recursos foram compartilhados com sucesso. 

Expandir
titleCriação da atividade

Image Added

...

Saiba mais

Dica

A atividade pode aceitar um recurso de conexão de banco de dados existente, caso contrário, será gerado um nome aleatório para o Alias. Ela valida a criação do Alias, garantindo que, caso ocorra algum erro (como a falta de diretórios do ambiente ou parâmetros inválidos), a atividade será marcada como falha.

Dica

Você pode utilizar esta atividade em conjunto com recursos de conexão a banco, como aqueles fornecidos por atividades de restauração de banco de dados, para evitar repetição de parâmetros.

Dica

É importante garantir que os parâmetros obrigatórios sejam sempre fornecidos corretamente. Caso contrário, a atividade não será executada com sucesso.

Dica

Ao criar o Alias, monitore o status da atividade. Se houver erros, como a não existência de diretórios ou problemas de conexão, a atividade será marcada como erro e o fluxo será interrompido.

FAQ

Informações

P: O que acontece se o Alias não puder ser criado?
R: Caso o Alias não possa ser criado, por exemplo, por falta de diretórios ou problemas de conexão, a atividade será marcada como erro e o fluxo de execução será interrompido.

P: Posso usar recursos de conexão de banco de dados ao invés de definir todos os parâmetros manualmente?
R: Sim, você pode usar um recurso de conexão de banco ao invés de definir manualmente os parâmetros de banco de dados. Isso é geralmente recomendado para maior facilidade de manutenção e flexibilidade.