Para criar um agendamento de carga, acesse o ícone ou "Gerenciar Ambiente", aonde temos em dois locais destacados abaixo.
Na página do projeto, selecione a aba de "Dados" e clique no botão , destacado na imagem abaixo.
Ao clicar no botão de agendamento, abrirá uma janela no qual será o controle dos agendamentos. Nele tem três botões e uma marcação:
Ativo: seu objetivo é ativar ou desativar o agendamento,caso não queira excluir o agendamento, e deseja optar por desativa-lo e não perder o histórico do agendamento.
Observação: Se for desativa-lo e for periódico, a carga não será feita até que você o ative.
Disparar imediatamente: Para efetuar a carga imediatamente, se não quiser esperar o período estipulado no agendamento.
Editar: Você pode editar o agendamento.
Nota: Cuidado quando for editar a parte do SQL, dependendo do que você irá fazer pode ocorrer erro de carga.
Excluir: Excluir o agendamento.
Ao clicar no botão "Novo Agendamento" abrirá uma janela com 4 etapas.
Na primeira etapa você vai configurar o tipo de carga que deseja ser executada. Segue descrições de cada um em anexo abaixo:
- Periódica;
- Imediato;
- API.
Periódico
- Intervalo: Você configura os dias da semana, um horário de início e fim, e um intervalo (30 em 30 minutos, exemplo);
- Diário: (Mostrado no exemplo) Você configura os dias da semana e a hora que será executado;
- Semanal: Você escolhe qual dia da semana (segunda, por exemplo) e a hora que será executado;
- Mensal: Você escolhe o dia do mês (todo dia 10, por exemplo) e a hora que será executado.
Imediato
Esse tipo de carga será inserido na fila de cargas, e será a próxima executada após a carga em andamento e das imediatas anteriormente solicitadas ser executadas. As cargas imediatas tem um histórico próprio se você decidir cancelar, clicando no botão . (Esse botão só estará habilitado se a carga ainda não foi acionada). E temos o botão de logs ao qual é armazenado as informações das cargas.
API
Fazendo uma chamada REST utilizando a URL (Exemplo: http://app.bimachine.com.br/api/origins/schedulings/"ID agendamento"/execute?key= "Chave da Api" usando a requisição POST;
- " ID agendamento ": É o código gerado do agendamento criado no BIMACHINE.
"Chave da Api": Em seu perfil existe uma opção de gerar uma "Chave", ela que você utilizará junto com o código do agendamento criado.
Importante: Esse tipo de carga é recomendável para um sistema que efetue esse disparo ou um sistema feito por nós da BIMACHINE.
Na próxima etapa você define o tipo de carga para efetuar. Existe 3 tipos de cargas:
- Carga Total: Limpa os dados existentes colocando novamente de acordo com o que o SQL carregado;
- Carga Incremental: Insere novos dados mantendo os dados existentes. Observação: para usar esta opção é necessário definir uma chave primária quando estiver criando a estrutura;
- Carga Geo Referência: Atualiza os endereços dos campos de Geo Referência.
Se você precisar modificar seu SQL para limitar os dados ou trazer de algum período específico, clique em "Habilitar edição de estrutura" e após "Validar Consulta".
Atenção: Modificar ou alterar os campos macros da estrutura, pode ocasionar problemas ao realizar a carga.
Incremental
Você terá a opção de remover dados mais antigos, no "campo de tempo" você pode usar como base Data de carga de dados ou Período, e remover dados da semana passada, mês passado e etc (por exemplo).
Na última etapa você tem o resumo do que será feito, e tem opções de como deseja receber alertas:
- Você pode receber os alertas por:
- E-mail;
- SMS;
- Portal (Notificações BIMACHINE).
- Opções de Recebimento:
- Nunca Receber;
- Nº Linhas menor que _ (informe);
- Sempre Receber;
- Somente em Erro;
- Somente em Sucesso.
Escolha as opções que mais se encaixam com a sua necessidade. Clique em "Finalizar". O agendamento será salvo e seguirá a periodicidade informada.
Nota: Como padrão, todas vem como "Nunca Receber"
Agora que temos um agendamento salvo, temos o número 01 acima do botão do agendamento. Assim você saberá quantos agendamentos esse cubo possui.
Ao passar o mouse em cima do ícone do agendamento, você terá um resumo dos agendamentos.
Ao abrir a janela de agendamento, na parte inferior veremos a lista com informações mais detalhadas sobre os agendamentos existentes, com opções para ver o SQL e excluir o agendamento.