Nova configuração de fontes de dados de indicador do tipo Excel com SQL que permite o envio de arquivos pelo Channel e por API.

Fontes de dados de indicador do tipo Excel com SQL 

  1. No cadastro de fonte de dados, ao selecionar a opção Excel com SQL, será exibido o campo Tipo de arquivo com as opções Caminho do arquivo e Upload arquivo.

    1. Caminho do arquivo (comportamento anterior): usuário deve informar o caminho do arquivo que deve estar no diretório configurado na propriedade LOCAL_ARQUIVO_INDICADOR_DS informada no jexp.ini

    2. Upload do arquivo: usuário envia o arquivo via interface, este arquivo será guardado na diretório informado na propriedade LOCAL_ARQUIVO_INDICADOR_DS do jexp.ini
      Nesta opção também será possível baixar o arquivo - Link Ver arquivo.

  2. Será possível alternar entre as opções acima, sem perder a configuração e o arquivo.

  3. Caso a propriedade LOCAL_ARQUIVO_INDICADOR_DS não for informada no jexp.ini, os campos ficam bloqueado e será exibido mensagem de erro com orientação para configurar:

  1. Ao alterar o diretório na propriedade LOCAL_ARQUIVO_INDICADOR_DS, usuário deve mover os arquivos das fontes de dados para o novo diretório manualmente


API para envio de arquivos para fonte de dados de indicadores

  1. Criado API para envio de arquivos para o Fonte de dados de indicadores http://[URL]/channel/v2/api/v1/datasource/{ID_FONTE_DADOS}/uploadFile

  2. Na URL deve conter o ID da fonte de dados, o body deve ser do tipo form-data com o atributo file
    Exemplo para obter o TOKEN de autenticação (deve-se informar o e-mail do usuário) (alterar para URL do ambiente):
    curl --request POST \
      --url https://channel.jexperts.com.br/channel/v2/auth2 \
      --header 'Content-Type: application/json' \
      --cookie 'cloud-environment=production' \
      --data '{
        "email": "jexperts@jexperts.com.br",
        "password": "123456"
    }'

    Exemplo de envio do arquivo:
    curl --location 'https://channel.jexperts.com.br/channel/v2/api/v1/datasource/1/uploadFile' \
    --header 'Authorization: Bearer TOKEN' \
    --form 'file=@"/home/user/testeds.xlsx"'

  3. Esta API retorna as seguintes mensagens de validação com status 400:

    1. Nenhum arquivo foi enviado - quando não é informado o atributo file no form ou o arquivo enviado é vazio (0 bytes).

    2. Arquivo deve ter extenção XLSX

    3. ID da fonte de dados não informado

    4. Esta faltando propriedade LOCAL_ARQUIVO_INDICADOR_DS=/usr/java/channel_files no jexp.ini

    5. Fonte de dados não encontrada

    6. Esta fonte de dados não é SGBD > Excel com SQL

  4. Retorno da API: Arquivo salvo com sucesso (Status 200)

  5. Se ocorrer algum erro, será retornado status 500 junto da mensagem de erro

  6. Caso token inválido será retornado status 401 - Não autorizado

Observações:

  1. A primeira linha do arquivo é considerada cabeçalho e não será lida

  2. O arquivo não pode utilizar fórmulas (colunas com fórmula serão lidas como texto, não permitindo realizar cálculos)

  3. Exemplo de consulta: SELECT SUM(coluna_d) as valor, now() as data FROM excel WHERE coluna_a = 'Tomate'

© 2023 JExperts  Todos os direitos reservados. Conheça a política de privacidade do Channel.