Customizando os parâmetros do Salescope Integrador

O Salescope Integrador permite programar a rotina de integração de forma automática pelo próprio sistema, porém você pode criar suas rotinas manualmente para atender a cenários específicos.

Ao abrir o Integrador seguido de um ou mais parâmetros, o mesmo é iniciado no Modo Automático, em que não abre uma interface para o usuário, apenas executa comandos enviados a ele. O Integrador suporte 3 tipos de comandos:

• Importar arquivo
• Importar query
• Excluir período

Observações

Nos tópicos a seguir você encontrará a documentação dos comandos do integrador. Algumas observações sobre eles:

• Os parâmetros podem ser escritos em qualquer ordem, contanto que cada parâmetro seja seguido por seus respectivos comandos;
• Os sinais < > representam a descrição de um dado que deve ser inserido de acordo com seu ambiente;
• Os sinais [ ] representam um trecho opcional do comando.

Importar arquivo

Esta automatização é iniciada pelo comando “importar-arquivo”, e inclui no banco de dados do Salescope vendas a partir de um arquivo físico. Os arquivos suportados são CSV, XLSX, XLS e TXT.

Comando

Integrador.exe importar-arquivo -banco <caminho do banco do Salescope> -vendas <caminho do arquivo de vendas> [-apagar] [-adiciona-data-existente] [-cloud] [-email-log <email a ser alertado em caso de falha>]

Comando	Tipo	Descrição
-banco	Obrigatório	Caminho do banco de dados Salescope de extensão .db.
-vendas	Obrigatório	Caminho do arquivo com as vendas que serão incluídas no banco Salescope.
-apagar	Opcional	Apaga todas as vendas existentes no banco antes da importação, preservando as geolocalizações anteriores. Utilize esse comando para arquivos que contenham todas as vendas.
-adiciona-data-existente	Opcional	Permite adicionar vendas em dias que já possuem vendas importadas. Utilize esse parâmetro com cautela, para evitar vendas duplicadas no mesmo dia.
-cloud	Opcional	Indica que o banco deve ser enviado à nuvem Salescope após a integração.
-email-log	Opcional	Email para receber alertas em caso de falha na integração.

Exemplo

Integrador.exe importar-arquivo -banco "c:\Salescope\banco.db" -vendas "c:\ERP\arquivo-de-vendas.csv"
-cloud

Importar query

Esta automatização é iniciada pelo comando “importar-query”, e inclui no banco de dados do Salescope vendas a partir de um comando T-SQL. Além de um arquivo contendo a query, devem ser passadas informações de conexão ao banco de dados.

Comando

Integrador.exe importar-query -banco <caminho do banco do Salescope> -query <caminho do arquivo contendo a query de leitura> -string-conexao <string de conexão com o banco de dados> -tipo-banco <código do banco de dados> [-apagar] [-adiciona-data-existente] [-cloud] [-email-log <email a ser alertado em caso de falha>]

Comando	Tipo	Descrição
-banco	Obrigatório	Caminho do banco de dados Salescope de extensão .db.
-query	Obrigatório	Caminho de um arquivo com extensão “.sql” contendo um único comando de leitura (SELECT).
-string-conexao	Obrigatório	String de conexão com seu banco de dados. O site connectionstrings.com possui modelos para os principais bancos de dados do mercado.
-tipo-banco	Obrigatório	Código numérico do seu banco de dados (SQLServer = 0, Sqlite = 1, Firebird = 2, Oracle = 3, MySql = 4, Access = 5, DB2 = 6, PostgreSql = 7)
-apagar	Opcional	Apaga todas as vendas existentes no banco antes da importação, preservando as geolocalizações anteriores. Utilize esse comando para arquivos que contenham todas as vendas.
-adiciona-data-existente	Opcional	Permite adicionar vendas em dias que já possuem vendas importadas. Utilize esse parâmetro com cautela, para evitar vendas duplicadas no mesmo dia.
-cloud	Opcional	Indica que o banco deve ser enviado à nuvem Salescope após a integração.
-email-log	Opcional	Email para receber alertas em caso de falha na integração.

Exemplo

Integrador.exe importar-query -banco "c:\Salescope\banco.db" -query "C:\Salescope\query.sql"
 -string-conexao "Data Source=c:\ERP\Vendas.db;Password=12345" -tipo-banco 2 -email-log "suporte@empresa.com.br" -apagar

Excluir período

Este comando permite excluir um período específico do banco de dados Salescope de forma automática

Comando

Integrador.exe excluir -banco <caminho do banco do Salescope> -data-inicial <formato dd/mm/aaaa> -data-final <formato dd/mm/aaaa> [-email-log <email a ser alertado em caso de falha>]

Comando	Tipo	Descrição
-banco	Obrigatório	Caminho do banco de dados Salescope de extensão .db.
-data-inicial	Obrigatório	Todas as vendas a partir dessa data serão excluídas do banco Salescope. A data deve ser no formato dd/mm/aaaa, por exemplo 01/10/2020.
-data-final	Obrigatório	Todas as vendas até essa data serão excluídas do banco Salescope. A data deve ser no formato dd/mm/aaaa, por exemplo 31/12/2020.
-email-log	Opcional	Email para receber alertas em caso de falha na integração.

Exemplo

Integrador.exe excluir -banco "c:\Salescope\banco.db" -data-inicial "01/01/2020" -data-final "10/06/2020"