Aviso |
---|
|
Os aplicativos Pages Beta, Forms Beta e Tasks Beta foram descontinuados e o suporte padrão e oficial da TOTVS será mantido apenas até Junho de 2023. Depois desse período, clientes que ativaram e estão usando os aplicativos continuarão tendo acesso a eles, porém, sem direito ao suporte. O exemplo demonstrado nessa página utilizou os recursos Forms e Pages do menu Soluções que vinham junto com a plataforma Fluig na atualização 1.6.5 Liquid. Esta página foi revisada para considerar as configurações da atualização 1.6.5 (Liquid). |
Índice
Índice |
---|
outline | true |
---|
exclude | Índice |
---|
style | none |
---|
|
Este guia tem o propósito de mostrar como iniciar uma solicitação de processo a partir de uma página pública por meio de um formulário público. Vamos apresentar um exemplo e detalhar todos os passos da integração.
![](/download/attachments/458754182/Esquemas.png?version=2&modificationDate=1550178301753&api=v2)
O caso de uso selecionado é o de recrutamento de novos colaboradores. Você pode conferir mais informações sobre essa aplicação por meio desse webinar.
Confira a seguir os passos necessários para realizar essa configuração.
...
O primeiro passo é definir qual o processo que deve ser iniciado. Você pode utilizar um processo já existente ou configurar um novo, caso necessário.
...
Nota |
---|
|
Não se esqueça de configurar o formulário do seu processo! E fique atento ao nome dos campos do formulário, iremos precisar dele mais pra frentenos próximos passos. |
![](/download/attachments/458754182/formul%C3%A1rio.png?version=2&modificationDate=1550174892940&api=v2)
...
Configuração do serviço
O próximo segundo passo para iniciar uma solicitação é por meio do cadastro do serviço REST de processos. Lembrando que se deseja fazer integração de um formulário com outro serviço é possível, basta cadastrar o serviço desejado.
...
Painel |
---|
Deck of Cards |
---|
| Card |
---|
| Para recuperar a informação do arquivo Swagger, siga os passo abaixo: Acesse a URl do seu ambiente fluig TOTVS Fluig Plataforma e adicionar /api-rest. Ex: http://suaempresa.fluig.com/api-rest Selecione o serviço que deseja, nesse caso utilizamos o de Process Management. Ver imagem abaixo:
![](https://lh5.googleusercontent.com/i01qOUIXTE-NTzpm3cCdXH2TxD4QcVAW0M1HwSWmUK7boJwiC0iY79i_7VX0bBaqtiqFryKb4zKHQHi15pkzdD8fTykgYfJ9bClD9HUTN6bT3PRXNHktMn7gvYXA0fxi-kt-jfeB)
|
Card |
---|
| No campo Domínio você adicionará a URL da fluig do Fluig Plataforma da sua empresa junto com a Base URL que você pode recuperar na página do serviço (Process Management). ![](https://lh4.googleusercontent.com/qQMScwsEn5ZlHlHDmXyNZrXYRtfrJXWdGZGpSohqjsew7nnW9SuhfKq00naE6YeEFV2d7tms2cKdpBZRzz6MgfQ7SLHBIG4RUa-fLEuCzXVU3r03DE-DJuImGANdWmKMLRL41J2D)
|
Card |
---|
id | 04 |
---|
label | Tipo de autenticação |
---|
| Nosso exemplo utiliza o tipo de autenticação Rest oAuth 1, porém nessa documentação são apresentados os detalhes de cada autenticação para atender a sua necessidade. Ao selecionar autenticação do tipo Rest oAuth 1 é preciso preencher algumas informações (Consumer Key, Consumer Secret, Token de acesso e Token Secret). Card |
---|
label | URL de teste de serviço |
---|
| A URL de teste de serviço não é uma informação obrigatória, porém serve para testar se as configurações do serviço estão corretas. A única particularidade é que precisa ser um método GET. ![](https://lh5.googleusercontent.com/m0e0R3gnNKZbCp-4BdOZz4NOvIp9RXokekW6XmmVAsdBolNthoq-k6arBXmMQ_1cN9WO3xMgNehpYrZ7joKVXtaxw49hIp88YmNAYw9wQWT8fvSa0_VfYyMzg7hCMHIF_Zohfd_-)
|
|
|
|
...
Configuração da operação
Nesse No terceiro passo é realizada a inclusão da operação que será necessária para integrar com o formulário.
...
Painel |
---|
Deck of Cards |
---|
| Card |
---|
| ![](https://lh4.googleusercontent.com/993Foo8GDptLeFIURRXrfORT4XLvIHD7YWvyGMjgrW8zf1mt9KgtJR1OXOKtCT0AvHXgviJTzis7gKqZ-63FoUD0Q5co4H6BN5mH5mY8O2ruQEAWzzB7FP-GFQ0Dzqu4vvcCar3J)
|
Card |
---|
id | 02 |
---|
label | Operação do serviço |
---|
| As operações são os métodos retornados da documentação Swagger da API, cadastrado no serviço selecionado. No caso será escolhida a operação start, que é o método de inicialização de uma solicitação de processo. |
Card |
---|
id | 03 |
---|
label | Parâmetros de entrada e saída |
---|
| Os parâmetros também são recuperados da documentação Swagger e o campo Label permite que sejam definidos nome mais amigáveis, que irão aparecer na integração do formulário, facilitando assim o entendimento de usuários das áreas de negócio. |
|
|
...
Configuração do formulário
Nesse 4º passo será apresentada a configuração do formulário, que inclui torná-lo público e integrado com a operação de iniciar a solicitação.
...
Painel |
---|
Deck of Cards |
---|
| Card |
---|
| ![](https://lh4.googleusercontent.com/FVILTRR8P-x37SJs9qXGrG8qV6j6v-0Ug0mTsPF78vOEmlFT5aCDYx8_U4nGH-jOvb45ZG37b5cF7Sbeis7YNVoi4GyyGPGQlDF2X7iRdoCoC1O65laAyTWu2VyZQHCyWEoK6XcU)
|
Card |
---|
id | 02 |
---|
label | Marcar como público |
---|
| Como o formulário será adicionado a uma página pública, é necessário realizar a configuração para torná-lo formulário público. Basta acessar as configurações de segurança do formulário e defini-lo como público. ![](https://lh3.googleusercontent.com/7sdIzWozkHss5tcNnUg7yewltMrW_LThtKtmnItezL9ityes82NvSER9LBnkeXMfB2ho8vanHSB3jyyoUSz0oJ2pBIV7mp5GwKsAvg96EN_EuaN-mqYRVAfzk6NaeRU3IxVNj9D-) |
Card |
---|
id | 03 |
---|
label | Vincular a operação |
---|
| Nessa mesma aba de configurações é realizada a inclusão da operação a ser integrada, basta selecionar a operação desejada (no caso, aquela de start) e configurar os campos para a integração. Serão preenchidos apenas os campos necessários para a integração, que são o codigoProcesso com o valor do código de processo a ser iniciado (nesse caso o código de processo é o do processo criado no passo 1) e os , o parâmetro targetState (código da atividade que se encontra após a atividade inicio), o parâmetro targetAssignee (pessoa responsável pela atividade) e os campos que serão preenchidos no formulário público e enviados para o formulário do processo. ![](/download/attachments/458754182/Image%20001.png?version=1&modificationDate=1550239690767&api=v2) ![](/download/attachments/458754182/Image%20002.png?version=1&modificationDate=1550239690887&api=v2)
Após configurar os campos é possível definir as mensagens relacionadas a integração. |
|
|
...
O último passo é configurar a página pública, arrastando os componentes e personalizando o layout de acordo com a identidade da empresa.
...
Painel |
---|
Deck of Cards |
---|
| Card |
---|
| Arraste um componente de Conteúdo externo para a página. ![](https://lh6.googleusercontent.com/-X7NaVjrTkJUowbn1XN8-SO9eN5Gv1U-FTb8pmVWDqytBIb1J_LtxIcAr3-5D6dVhCS2Ds3vD4BLQCJF3niSGQdKViwYKEEEXFw8tLIlFLWtwozLwsHoBgPY7ckF7snBayAtnwqz)
|
Card |
---|
| Acesse o seu formulário e acione a opção Compartilhar URL, para copiar a URL do formulário para a área de transferência. ![](https://lh3.googleusercontent.com/elwUq38CVXs8xO6SFZNe4dAoNQeddBDz3HMZu25fwukwpBZrWYQ5zYl9W6_yrMaxXAKwn-1jJJpAwj2xLdmwnHsg5fGcqTTOmxmrXJ_H_xPJRRjKFJjbKGsRMyhSt51LdgUdDVVG)
|
Card |
---|
| Volte na tela de configuração da página e insira a URL do formulário na configuração do componente de Conteúdo externo. ![](https://lh5.googleusercontent.com/p5zGkzRkb1g6R7SE-CSxeoXjf2VoPq6PqEamrJwUGiZWJRRB2oiwwguewHNcsMX4SUrPNiBYAHJ5QRr-gBBjPRrGQevm0CgO84tm-U8axWwIsdSJkG3WFbz1IjsbYhZtj5d4ZBAG)
|
|
|
Conheça mais: Webinar
Assista ao webinar gravado pelo time fluigda plataforma Fluig, para obter mais detalhes sobre como funciona esse procedimento.o funcionamento deste procedimento:
Conector de Widget |
---|
width | 800 |
---|
url | https://www.youtube.com/watch?v=KW2HK8H32YQ&feature=youtu.be |
---|
height | 450 |
---|
|
...