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

Última modificação por FlowFast em 2024/09/04 19:32
Da versão 2.2
editado por FlowFast
em 2023/11/16 14:10
Comentário da mudança: Não existe comentário para essa versão
Para versão 6.1
editado por FlowFast
em 2024/09/04 19:32
Comentário da mudança: Não existe comentário para essa versão

Resumo

Detalhes

Propriedades da página
Conteúdo
... ... @@ -1,9 +1,118 @@
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 -==== WhatsApp ====
3 +Independente do tipo de Robô selecionado, o envio por e-mail sempre está disponível se configurado.
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 +==== ====
34 +
35 +==== Robô do tipo: 1-Somente e-mail: ====
36 +
37 +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//**
38 +
39 +|**Campo:**|**Descrição:**
40 +|Texto do cabeçalho|(((
41 +O texto definido nesse campo será utilizado uma só vez para cada execução.
42 +
43 +Não é utilizado a cada linha.
44 +
45 +Pode ser utilizado para o cabeçalho da mensagem e pode conter o cabeçalho de uma tabela.
46 +)))
47 +|Texto das linhas|(((
48 +O texto definido nesse campo somará ao cabeçalho cada linha do SQL.
49 +
50 +Pode ser utilizado para montar as linhas de uma tabela.
51 +)))
52 +|Texto do rodapé|(((
53 +O texto definido nesse campo será utilizado uma só vez para cada execução.
54 +
55 +Não é utilizado a cada linha.
56 +
57 +Pode ser utilizado para finalização da mensagem e fechamento de uma tabela.
58 +)))
59 +
60 +
61 +Colunas especiais no SQL para envio de e-mail, quando usada opção //Enviar quando = "Há retorno, aviso por linha"//
62 +
63 +|=Coluna|**Descrição**
64 +|xdes_email_dest|(((
65 +é possível definir o destinatário do e-mail referente a cada linha utilizando esse alias na coluna do SQL.
66 +)))
67 +|xdes_assunto|Define o assunto do e-mail referente a cada linha
68 +|xdes_email_replyto|Define a opção "Responder para" do e-mail referente a cada linha
69 +
70 +==== Robô do tipo: 3-E-mail de tarefas: ====
71 +
72 +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//**
73 +
74 +
75 +[[image:1702066735798-552.png]]
76 +
77 +
78 +Exemplo de texto:
79 +
80 +[[image:1702066977867-739.png]]
81 +
82 +
83 +|=Coluna|**Descrição**
84 +|xseq_tarefa|(((
85 +Coluna obrigatória no SQL para envia e-mail das tarefas.
86 +)))
87 +
88 +==== Robô do tipo: 5-WhatsApp: ====
89 +
5 5  Quando o comando for configurado como envio de WhatsApps será solicitado o Modelo/Template configurado e cadastrado junto com a conta na Meta.
6 6  
7 -Colunas que devem estar do SELECT para envio do modelo/template
92 +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.
8 8  
94 +|=Coluna|=Descrição
95 +|=(% colspan="2" scope="col" %)Para  quem enviar: 2 opções
96 +|=(% colspan="2" scope="col" %)1-Conta existente
97 +|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)
98 +|=(% scope="col" %)2-Número:|
99 +|xcp_num_pais|(((
100 +Código do número do país do telefone (se não for informado usará 55-Brasil)
101 +)))
102 +|xcp_num_ddd|Código do DDD do estado
103 +|xcp_num_fone|Número do telefone
104 +|xcp_cod_pessoa|Código da pessoa para vincular a conta criada associada ao número do telefone
105 +|(% colspan="2" %)**Enviar Documento: 3 opções**
106 +|(% colspan="2" %)**1-Anexo do sistema**
107 +|xcp_seq_anexo|Código do anexo no sistema (ADM_ANEXO_ARQ.SEQ_ANEXO)
108 +|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)
109 +|(% colspan="2" %)**2-Caminho físico**
110 +|xcp_des_path|Caminho completo físico do arquivo, visível pelo servidor de aplicação.
111 +|(% colspan="2" %)**3-Arquivo com ID publicado**
112 +|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]]
113 +
114 +==== Agenda: ====
115 +
116 +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.
117 +
9 9  
1702066735798-552.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.flowfast
Tamanho
... ... @@ -1,0 +1,1 @@
1 +102.7 KB
Conteúdo
1702066977867-739.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.flowfast
Tamanho
... ... @@ -1,0 +1,1 @@
1 +43.3 KB
Conteúdo