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ítulo | Configuração de Fonte de Dados — Excel (.xls) |
|---|---|
| Versão | 1.0 |
| Responsável | Suporte 4yousee |
| Última atualização | 05/09/2025 |
Sumário
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
- Solicite a habilitação do FTP para sua conta pelo e-mail suporte@4yousee.com.br.
- 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
- Acesse filezilla-project.org/download.php e instale de acordo com seu sistema operacional.
- Abra o FileZilla e configure uma nova conexão com as credenciais recebidas do suporte.
- Clique em Conectar e confirme o status no painel de mensagens.
2.2 Enviar o arquivo Excel
- Localize no painel esquerdo (arquivos locais) a pasta que contém o seu arquivo .xls.
- Dê duplo clique no arquivo para enviá-lo ao FTP (aparecerá no painel direito).
- 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
- No 4yousee manager, crie um canal (ex.: “Excel” ou “Excel — Informações de Vendas”).
- Referência: Como criar um canal.
Passo 4: Criar a fonte de dados
- Acesse Fontes de Dados e clique em Nova Fonte de Dados.
- Preencha:
- Nome: identificador (ex.: “Vendas Excel”).
- URL: caminho do arquivo no FTP, no formato:
/home/nomedousuario/ftp/Book1.xlsO nomedousuario corresponde ao usuário informado nas credenciais do FTP. Se o arquivo estiver em subpastas, inclua o caminho completo após /ftp/.
- Clique em Testar consulta
2. Verifique se os dados do Excel são retornados.
Passo 5: Mapear variáveis
- Abra a fonte de dados criada e acesse Variáveis.
- Confira as colunas detectadas no arquivo.xls.
- 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
- Verifique o formato do arquivo (deve ser .xls).
- Confirme o caminho na URL da fonte (ex.:/home/nomedousuario/ftp/Book1.xls).
- Reenvie o arquivo e teste novamente Testar consulta.
Variáveis não aparecem
- Abra o arquivo Excel e verifique se as colunas têm cabeçalho (nomes claros, sem caracteres especiais excessivos).
- Confirme que as colunas usadas existem e contenham dados.
- Atualize a página da fonte no manager e verifique novamente.
Atualização não reflete no player
- Reenvie o arquivo.xls ao FTP (mesmo nome e caminho).
- Aguarde até 1 hora ou use Baixar Notícias para forçar.
Erros de conexão no FileZilla
- Revise host, usuário, senha e porta recebidos pelo suporte.
- 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.