Como configurar uma Fonte de Dados de Excel

Este guia ensina a configurar uma fonte de dados Excel (.xls) no 4yousee manager. Seguindo passos padronizados, você integra a planilha ao 4yousee player por meio de FTP.

TítuloConfiguração de Fonte de Dados — Excel (.xls)
Versão1.0
ResponsávelSuporte 4yousee
Última atualização05/09/2025

Sumário

  1. Objetivo
  2. Pré-requisitos
  3. Passo 1: Habilitar FTP
  4. Passo 2: FileZilla e envio do arquivo
  5. Passo 3: Criar canal
  6. Passo 4: Criar a fonte de dados
  7. Passo 5: Mapear variáveis
  8. Atualização de dados
  9. Solução de problemas
  10. Limitações
Objetivo. Este documento orienta a criação de uma Fonte de Dados Excel no 4yousee manager, com envio do arquivo via FTP e mapeamento de variáveis para uso em templates do 4yousee designer.

Pré-requisitos

  • FTP habilitado na conta.
  • FileZilla instalado para transferir o arquivo.
  • Arquivo Excel no formato .xls (obrigatório).
  • Acesso ao 4yousee manager com permissão para criar canais e fontes de dados.

    Exemplo de como é o arquivo no formato .xls.

Passo 1: Habilitar FTP

  1. Solicite a habilitação do FTP para sua conta pelo e-mail suporte@4yousee.com.br.
  2. Aguarde o recebimento das credenciais de acesso (host, usuário, senha e porta).
Importante: sem FTP habilitado, não é possível utilizar fontes de dados Excel.

Passo 2: FileZilla e envio do arquivo

2.1 Baixar e configurar o FileZilla

  1. Acesse filezilla-project.org/download.php e instale de acordo com seu sistema operacional.
  2. Abra o FileZilla e configure uma nova conexão com as credenciais recebidas do suporte.
  3. Clique em Conectar e confirme o status no painel de mensagens.

2.2 Enviar o arquivo Excel

  1. Localize no painel esquerdo (arquivos locais) a pasta que contém o seu arquivo .xls.
  2. duplo clique no arquivo para enviá-lo ao FTP (aparecerá no painel direito).
  3. Certifique-se de que o arquivo foi enviado para o diretório correto (ex.: raiz do FTP).
Atenção: o 4yousee manager reconhece apenas arquivos em .xls para esta fonte. Outros formatos, como .xlsx, não são suportados.

Passo 3: Criar canal

  1. No 4yousee manager, crie um canal (ex.: “Excel” ou “Excel — Informações de Vendas”).
  2. Referência: Como criar um canal.

Passo 4: Criar a fonte de dados

  1. Acesse Fontes de Dados e clique em Nova Fonte de Dados.


  2. Preencha:
    • Nome: identificador (ex.: “Vendas Excel”).
    • URL: caminho do arquivo no FTP, no formato:
/home/nomedousuario/ftp/Book1.xls

O nomedousuario corresponde ao usuário informado nas credenciais do FTP. Se o arquivo estiver em subpastas, inclua o caminho completo após /ftp/.

Exemplo de caminho no FTP

  1. Clique em Testar consulta


    2. Verifique se os dados do Excel são retornados.


Passo 5: Mapear variáveis

  1. Abra a fonte de dados criada e acesse Variáveis.


  2. Confira as colunas detectadas no arquivo.xls.
  3. Renomeie as variáveis para coincidir com os nomes usados no template do 4yousee designer.
    • Exemplo: coluna com valor 500 renomeada para quantidade para casar com o template.
Dica: mantenha um padrão consistente de nomenclatura entre planilha e template para facilitar a manutenção.

Atualização de dados

  • Quando alterar o Excel, reenvie o arquivo ao FTP pelo FileZilla.
  • As mudanças refletem no player automaticamente em até 1 hora.
  • Para antecipar, use Baixar Notícias no 4yousee manager.

Solução de problemas

Fonte não retorna dados

  1. Verifique o formato do arquivo (deve ser .xls).
  2. Confirme o caminho na URL da fonte (ex.:/home/nomedousuario/ftp/Book1.xls).
  3. Reenvie o arquivo e teste novamente Testar consulta.

Variáveis não aparecem

  1. Abra o arquivo Excel e verifique se as colunas têm cabeçalho (nomes claros, sem caracteres especiais excessivos).
  2. Confirme que as colunas usadas existem e contenham dados.
  3. Atualize a página da fonte no manager e verifique novamente.

Atualização não reflete no player

  1. Reenvie o arquivo.xls ao FTP (mesmo nome e caminho).
  2. Aguarde até 1 hora ou use Baixar Notícias para forçar.

Erros de conexão no FileZilla

  1. Revise host, usuário, senha e porta recebidos pelo suporte.
  2. Cheque firewall/antivírus que possam bloquear a conexão FTP.

Limitações

  • Somente arquivos .xls são suportados para esta fonte.
  • Upload via FTP é obrigatório.

Isso foi útil para você? Sim Não

Enviar feedback
Lamentamos não termos conseguido ajudá-lo(a) mais. Ajude-nos a melhorar este artigo com o seu feedback.