Código fonte Wiki de Robôs - Comandos SQL (103)

Última modificação por FlowFast em 2024/09/04 19:32

version	line-number	content
1.2	1	Criação de robôs baseados em consultas SQL que podem iniciar processos, executar tarefas, enviar e-mails, mensagens SMS ou WhatsApp.
1.1	2
3.2	3	Independente do tipo de Robô selecionado, o envio por e-mail sempre está disponível se configurado.
2.2	4
3.2	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.
3.3	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:
3.2	13
3.3	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
3.4	16	Há retorno: Indica que deve executar uma só vez. Exemplo de utilização: Enviar e-mail os pedidos recebidos no dia.
3.3	17
3.4	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.
3.3	19	)))
3.4	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;
3.3	23
3.4	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.
3.5	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.
3.4	31	)))
	32
5.2	33	==== ====
	34
3.2	35	==== Robô do tipo: 1-Somente e-mail: ====
	36
3.3	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//
3.2	38
3.5	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
6.1	61	Colunas especiais no SQL para envio de e-mail, quando usada opção //Enviar quando = "Há retorno, aviso por linha"//
	62
3.5	63	\|=Coluna\|Descrição
3.2	64	\|xdes_email_dest\|(((
6.1	65	é possível definir o destinatário do e-mail referente a cada linha utilizando esse alias na coluna do SQL.
3.2	66	)))
6.1	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
3.2	69
5.2	70	==== Robô do tipo: 3-E-mail de tarefas: ====
3.2	71
5.2	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//
3.2	73
5.2	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
3.2	88	==== Robô do tipo: 5-WhatsApp: ====
	89
2.2	90	Quando o comando for configurado como envio de WhatsApps será solicitado o Modelo/Template configurado e cadastrado junto com a conta na Meta.
	91
2.3	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.
2.2	93
2.3	94	\|=Coluna\|=Descrição
2.6	95	\|=(% colspan="2" scope="col" %)Para quem enviar: 2 opções
	96	\|=(% colspan="2" scope="col" %)1-Conta existente
2.4	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)
2.6	98	\|=(% scope="col" %)2-Número:\|
2.3	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
2.4	105	\|(% colspan="2" %)Enviar Documento: 3 opções
2.6	106	\|(% colspan="2" %)1-Anexo do sistema
2.4	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)
2.6	109	\|(% colspan="2" %)2-Caminho físico
2.4	110	\|xcp_des_path\|Caminho completo físico do arquivo, visível pelo servidor de aplicação.
2.6	111	\|(% colspan="2" %)3-Arquivo com ID publicado
2.4	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]]
2.3	113
3.6	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
2.2	118