Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Índice:
Objetivo:
Este documento tem por objetivo especificar a atividade “Gerar Auto“Executar Web-Incremento” Service” disponível na Fórmula Visual.
Especificação:
A atividade “Gerar Auto-Incremento” realiza o auto incremento de um campo presente na tabela GAUTOINC (Tabela responsável por controlar os códigos de auto incremento das tabelas do sistema).
atividade “Executar Web Service” permite que um Web Service (TBC ou Externo) seja consumido. Seu retorno pode ser utilizado em diversas atividades disponíveis na fórmula visual.
Image Added
Para começarmos a utilizar a atividade, temos que conhecer os parâmetros que ela recebe.
Image Added
N° | Nome do Parâmetro | Descrição do Parâmetro | Obrigatoriedade | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
1 | Method (Método) | Método do Serviço que será chamado. |
| ||||||||
2 | Pré Autenticar* | Alguns Web Services necessitam de Pré-Autenticação, nesses casos o valor deve ser "True". Obs.: A partir da 12.1.19, os WebServices do RM precisam de Pré Autenticação. |
| ||||||||
3 | Senha | Senha que será usada na requisição ao Web Service. |
| ||||||||
4 | Usuário | Usuário que será usado na requisição ao Web Service. |
| ||||||||
5 | Wsdl | Descritor do serviço de Web Service. |
|
Informações | ||
---|---|---|
| ||
Quando o Pré Autenticar é marcado como verdadeiro o cabeçalho WWW-authenticate é enviado às requisições sub-sequentes. |
Aviso | ||
---|---|---|
| ||
É importante frisar que, caso o contrato WSDL possua qualquer serviço que possua hífen em seu nome ( - ), este será substituído por travessão/underline ( _ ) em tempo de execução. Faça as validações, tenha atenção e se possível, evite nomes de serviços com hífen, para evitar inconsistências. |
Vamos Configurar o Web Service:
1) Clique com o botão direito na atividade.
Image Added
2) Defina o descritor do Web Service (WSDL) que será utilizado e clique em OK.
Será apresentado o XML do descritor à sua esquerda, e será apresentado os métodos disponíveis à sua direita.
Image Added
3) Escolha o método que será utilizado.
Image Added
4) Após escolher o método à ser utilizado na Fórmula Visual, as propriedades Method e Wsdl já estarão preenchidas, você deverá preencher então o usuário e senha (caso houver necessidade) e o Pré Autenticar (também se houver necessidade)
Image Added
5) Após o preenchimento do Grupo Diversos, deve-se preencher o Grupo Parâmetros.
A quantidade de parâmetros do Grupo Parâmetros é variável, no caso demonstrado, são dois, mas pode ser qualquer valor maior ou igual a 0. (x >= 0)
Image Added
N° | Nome do Parâmetro | Descrição do Parâmetro | Obrigatoriedade | ||||||
---|---|---|---|---|---|---|---|---|---|
1 | CityName | Nome da Cidade à qual será retornado à informação de Clima. |
| ||||||
2 | CountryName | Nome do Páis à qual será retornado à informação de Clima. |
|
6) Após o preenchimento do Grupo Parâmetros deve-se preencher o Grupo Retorno
Image Added
7) Clique no Ícone Amarelo ao lado da Propriedade Retorno, ou no botão [...] que aparece ao lado da mesma propriedade, a tela abaixo irá aparecer.
Image Added
8) Clique na Aba Associar a um novo membro e defina uma nova Propriedade com o nome que desejar.
Image Added
9) Após criar a nova propriedade vinculada ao Retorno, verifique se o nome dela aparece na árvore de Membros.
Image Added
10) Caso a Propriedade (rmsWebServiceActivity1_Retorno1 ou outro nome definido pelo usuário) tenha sido criada, ela será vinculada à Propriedade Retorno da Atividade.
Image Added
Como foi dito antes, esse retorno pode ser utilizado por várias atividades, um exemplo fácil é vinculá-lo a uma atividade de Gerar Exceção.
Image Added
Após acrescentar a atividade de Gerar Exceção, temos que configurá-la, preenchendo a Propriedade Mensagem de Erro.
Image Added
Devemos vincular a Propriedade (rmsWebServiceActivity1_Retorno1 ou outro nome definido pelo usuário) à Propriedade Mensagem de Erro da atividade Gerar Exceção.
Image Added
Depois de preenchido a Propriedade Mensagem de Erro, verificar se o valor vinculado está correto.
Image Added
Após isso, salvar e executar a fórmula, que uma exceção será gerada com o valor de retorno do Método do Web Service escolhido.
Image Added
Image Added
Informações | ||
---|---|---|
| ||
Ao utilizar essa atividade com HTTPS é necessário que o certificado ofereça uma conexão segura. |
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|