Mudanças do documento Robôs - Comandos SQL (103)

Última modificação por FlowFast em 2024/09/04 19:32
Da versão 5.2
editado por FlowFast
em 2023/12/08 17:25
Comentário da mudança: Não existe comentário para essa versão
Para versão 2.5
editado por FlowFast
em 2023/11/16 14:51
Comentário da mudança: Não existe comentário para essa versão

Resumo

Detalhes

Propriedades da página
Conteúdo
... ... @@ -1,98 +1,15 @@
1 1  Criação de robôs baseados em consultas SQL que podem iniciar processos, executar tarefas, enviar e-mails, mensagens SMS ou WhatsApp.
2 2  
3 -Independente do tipo de Robô selecionado, o envio por e-mail sempre está disponível se configurado.
3 +==== WhatsApp ====
4 4  
5 -
6 -Os campos abaixo são úteis para todos os tipos de Robôs:
7 -
8 -|**Campo:**|**Descrição:**
9 -|Comando SQL|Nesse campo é possível definir o comando SQL que trará as informações necessárias para montagem do corpo do texto, campos do template do WhatsApp ou para abertura de processos ou execução de tarefas.
10 -|Banco de dados|Útil somente para os casos que o SQL irá ler banco de dados que não tinham vínculo com o banco do FlowFast.
11 -|Enviar quando|(((
12 -Define a forma de execução:
13 -
14 -**Não há retorno:** Indica que o envio para as pessoas da seção **//Destinatário //**quando o comando SQL não retornar linhas.
15 -
16 -**Há retorno:** Indica que deve executar uma só vez. Exemplo de utilização: Enviar e-mail os pedidos recebidos no dia.
17 -
18 -**Há retorno, aviso por linha:** Indica que executará a definição para cada linha retornada no SQL. Exemplo de utilização: WhatsApp, e-mail ou SMS para as pessoas informando uma promoção.
19 -)))
20 -|Classe especial|Deve ser contratado o desenvolvimento especial para utilização dessa funcionalidade. Exemplo de utilização: Envio de e-mail com PDF anexo variável por linha retornada.
21 -|Marcar linhas lidas|(((
22 -Nos casos em que o Robô executa ciclicamente é de responsabilidade de com constrói o controle de não executar múltiplas vezes para a mesma linha, sendo controles adicionais para evitar esse problema;
23 -
24 -**Não: **Indica que não há necessidade de controles adicionais o próprio SQL ou o período de execução garantem que não há execução repetida.
25 -
26 -**Sim: **Somente pode ser utilizado em tabelas que tenham o campo **DTH_ENVIO **na tabela ela deverá ser um campo Date se for Oracle e Timestamp se for PostGreSql
27 -
28 -**Sim, com comando:** nesse caso para cada linha processada chamará o comando colocado no campo **SQL executar p/ linha**, uma possibilidade seria inserir linhas em uma tabela de controle e no comando SQL testar a existência para evitar ler duas vezes a mesma informação.
29 -
30 -O campo **Banco de dados linha** indicará em qual banco de dados o comando deverá ser executado, caso não informado assume que utilizará o banco de dados do próprio FlowFast.
31 -)))
32 -
33 -(% class="wikigeneratedid" %)
34 -==== ====
35 -
36 -==== Robô do tipo: 1-Somente e-mail: ====
37 -
38 -Essa opção permite o envio de e-mail por linha com destinatário definido no SQL ou com destinatários fixos definidos na seção **//Destinatário//**
39 -
40 -|**Campo:**|**Descrição:**
41 -|Texto do cabeçalho|(((
42 -O texto definido nesse campo será utilizado uma só vez para cada execução.
43 -
44 -Não é utilizado a cada linha.
45 -
46 -Pode ser utilizado para o cabeçalho da mensagem e pode conter o cabeçalho de uma tabela.
47 -)))
48 -|Texto das linhas|(((
49 -O texto definido nesse campo somará ao cabeçalho cada linha do SQL.
50 -
51 -Pode ser utilizado para montar as linhas de uma tabela.
52 -)))
53 -|Texto do rodapé|(((
54 -O texto definido nesse campo será utilizado uma só vez para cada execução.
55 -
56 -Não é utilizado a cada linha.
57 -
58 -Pode ser utilizado para finalização da mensagem e fechamento de uma tabela.
59 -)))
60 -
61 -
62 -|=Coluna|**Descrição**
63 -|xdes_email_dest|(((
64 -Para envio de e-mail para cada linha essa variável deverá existir no comando SQL
65 -)))
66 -
67 -==== Robô do tipo: 3-E-mail de tarefas: ====
68 -
69 -Essa opção permite o envio de e-mail por linha com destinatário definido no SQL ou com destinatários fixos definidos na seção **//Destinatário//**
70 -
71 -
72 -[[image:1702066735798-552.png]]
73 -
74 -
75 -Exemplo de texto:
76 -
77 -[[image:1702066977867-739.png]]
78 -
79 -
80 -|=Coluna|**Descrição**
81 -|xseq_tarefa|(((
82 -Coluna obrigatória no SQL para envia e-mail das tarefas.
83 -)))
84 -
85 -==== Robô do tipo: 5-WhatsApp: ====
86 -
87 87  Quando o comando for configurado como envio de WhatsApps será solicitado o Modelo/Template configurado e cadastrado junto com a conta na Meta.
88 88  
89 89  Para cada linha retornada no SELECT, configurado no comando, será enviado uma mensagem WhatsApp. Para definir para quem, variáveis de substituições e arquivo enviado no template(caso possua) o Select deve possuir as colunas os Alias abaixo.
90 90  
91 91  |=Coluna|=Descrição
92 -|=(% colspan="2" scope="col" %)Para  quem enviar: 2 opções
93 -|=(% colspan="2" scope="col" %)1-Conta existente
10 +|=(% colspan="2" scope="col" %)Para  quem enviar:
94 94  |xcp_seq_conta_whatsapp|Código da conta já existente (se possuir valor nessa coluna não há necessidade de retornar a xcp_num_fone)
95 -|=(% scope="col" %)2-Número:|
12 +|=(% scope="col" %)Número|
96 96  |xcp_num_pais|(((
97 97  Código do número do país do telefone (se não for informado usará 55-Brasil)
98 98  )))
... ... @@ -100,17 +100,12 @@
100 100  |xcp_num_fone|Número do telefone
101 101  |xcp_cod_pessoa|Código da pessoa para vincular a conta criada associada ao número do telefone
102 102  |(% colspan="2" %)**Enviar Documento: 3 opções**
103 -|(% colspan="2" %)**1-Anexo do sistema**
20 +|(% colspan="2" %)**Anexo do sistema**
104 104  |xcp_seq_anexo|Código do anexo no sistema (ADM_ANEXO_ARQ.SEQ_ANEXO)
105 105  |xcp_seq_arquivo|Sequencia do arquivo no anexo (ADM_ANEXO_ARQ.SEQ_ARQ) (caso não informado pegará o primeiro que encontrar dentro do SEQ_ANEXO)
106 -|(% colspan="2" %)**2-Caminho físico**
23 +|(% colspan="2" %)**Caminho físico**
107 107  |xcp_des_path|Caminho completo físico do arquivo, visível pelo servidor de aplicação.
108 -|(% colspan="2" %)**3-Arquivo com ID publicado**
25 +|(% colspan="2" %)**Arquivo com ID publicado**
109 109  |xcp_uuid_arq|ID para utilização externa do arquivo publicado através da pagina  [[Repositório de arquivos (1251)>>doc:Main.help.adm.pagina.1251.WebHome]]
110 110  
111 -
112 -==== Agenda: ====
113 -
114 -Nos campos dessa área é definida a periodicidade da execução do comando. O campo **Inativação** define a última vez que o comando será executado.
115 -
116 116  
1702066735798-552.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.flowfast
Tamanho
... ... @@ -1,1 +1,0 @@
1 -102.7 KB
Conteúdo
1702066977867-739.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.flowfast
Tamanho
... ... @@ -1,1 +1,0 @@
1 -43.3 KB
Conteúdo