Um Gateway CSV é um método para automatizar a importação de arquivos CSV para o Canvas. Os arquivos são transferidos usando o Protocolo de Transferência Segura de Arquivos (SFTP). O Gateway CSV pode ser especialmente útil se o seu sistema de informação acadêmica (SIS) não tiver uma conexão de integração de API direta com o Canvas.
Se você estiver interessado em configurar um gateway CSV/SFTP para provisionamento de dados ou exportação de notas, entre em contato com seu Gerente de Sucesso do Cliente (CSM) da Instructure.
O que você deve saber
- Os arquivos CSV devem estar alinhados às diretrizes de formatação CSV do Canvas. Mais informações sobre a formatação CSV do Canvas podem ser encontradas emnosso guia.
- Aplicam-se as regras padrão do CSV:
- A primeira linha é interpretada como cabeçalho e é obrigatória.
- Todo o texto dentro do arquivo deve estar codificado em UTF-8.
- Todos os registros de data e hora devem estar no formato ISO 8601. Por padrão, todos os registros de data e hora são em UTC, a menos que um fuso horário diferente seja especificado.
- As importações não são em tempo real. As tarefas de sincronização são agendadas. A frequência dependerá do seu conjunto de dados e pode ser discutida com mais detalhes com seu consultor da Instructure. As sincronizações agendadas mais comuns ocorrem uma ou duas vezes por dia.
- Uma opçãoRelatório de Exportação de ClassificaçãoPode ser programado para ser colocado no portal uma vez por dia.
- ADiferenciandoO diretório pode ser configurado mediante solicitação. As importações diferenciadas procurarão alterações nos arquivos entregues e tomarão medidas em relação a quaisquer registros ausentes. Se você estiver interessado em configurar isso, seu consultor da Instructure poderá fornecer informações adicionais durante a configuração.
- Após a configuração e sincronização do SFTP com o ambiente de produção, o cliente deverá entrar em contato com o suporte para solucionar problemas e/ou realizar qualquer alteração de configuração do SFTP.
Como faço para começar?
Primeiramente, o cliente deve determinar quem hospedará o servidor SFTP. Existem duas opções para hospedagem do servidor SFTP.
- A Instructure pode hospedar o servidor.
- O cliente hospeda o servidor SFTP.
O cliente é responsável por criar os arquivos CSV para seus dados, alinhados às especificações do Canvas CSV, e enviar esses arquivos para o servidor SFTP. A Instructure processará os arquivos enviados com base em tarefas agendadas.
O CSV Gateway será inicialmente conectado à instância Beta do Canvas do cliente para testes iniciais. A conexão com a instância de Produção do Canvas do cliente só será transferida após o cliente fornecer uma confirmação por escrito ao seu consultor da Instructure, atestando a conclusão dos testes.
Servidor hospedado pela Instructure
Se a Instructure hospedar o servidor SFTP, o cliente precisará gerar um par de chaves SSH. A chave pública será enviada ao seu consultor da Instructure.
A chave privada não deve ser compartilhada. Caso a chave privada seja compartilhada, a Instructure solicitará a geração de um novo par de chaves.
Ao gerar o par de chaves SSH, tenha em mente o seguinte:
- A Instructure exige um comprimento mínimo de 2048 bits na chave.
- As chaves públicas geralmente têm uma das seguintes extensões: .pub, .pem
- Alguns formatos de chave incluem a chave privada juntamente com a chave pública; envie-nos apenas a chave pública, caso contrário, o par de chaves precisará ser regenerado.
Após a chave pública ser compartilhada com o consultor da Instructure e carregada no servidor SFTP, o cliente receberá as seguintes informações:
- Servidor
- Porta
- Nome de usuário
- Diretório
- Sincronizar agenda
Servidor hospedado pelo cliente.
Caso o cliente opte por hospedar o servidor SFTP, a Instructure precisará receber as informações de conexão.
Não envie essas informações por e-mail.
Seu consultor da Instructure fornecerá um link seguro para você enviar um arquivo .txt com as seguintes informações:
- Servidor
- Porta
- Nome de usuário
- Autenticação
- Pasta/Diretório
Além de fornecer as informações solicitadas ao seu consultor da Instructure, o cliente pode precisar adicionar os endereços IP da Instructure a uma lista de permissões. Seu consultor da Instructure fornecerá as informações solicitadas. Configurações/ajustes adicionais podem ser necessários no servidor hospedado do cliente caso a Instructure não consiga se conectar ao servidor SFTP remoto.