Informações sobre os modelos para importação de dados no Apple School Manager
Para adicionar dados ao Apple School Manager, você pode usar arquivos de modelo .csv formatados pela Apple ou pelo OneRoster.
Nomes de modelos .csv da Apple: Estudantes, funcionários, cursos, turmas, listas, locais
Nomes de modelos .csv do OneRoster: Usuários, cursos, turmas, inscrições, organizações
Nome de arquivo da Apple | Nome de arquivo do OneRoster | Conteúdos | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: contém informações sobre contas de aluno. OneRoster: contém informações de contas de estudantes, instrutores e funcionários. | |||||||||||
N/A | Contém informações sobre contas de funcionários, tais como instrutores. | ||||||||||
Contém informações do curso. | |||||||||||
Contém informações sobre turmas e instrutores (funcionários). | |||||||||||
Contém informações sobre turmas, estudantes e locais (lista). | |||||||||||
Contém informações de localização (instituição de ensino ou departamento). | |||||||||||
Modelos e Contas Apple gerenciadas
Se um campo opcional, como person_number ou sis_username, for parte do formato do sua Conta Apple gerenciada, ele se tornará um campo obrigatório. Se você deixá-lo em branco, o upload do SFTP falhará com o erro MANAGED_ID_GENERATION_FAILED.
Preparar modelos
Ao preparar um modelo, os seguintes critérios devem ser atendidos:
Nos modelos students.csv e staff.csv, o person_id precisa ser exclusivo para cada local.
Importante: se usar o SFTP para fazer upload de um novo usuário e o person_id que você atribuir já estiver atribuído a outro usuário, o novo usuário substituirá o usuário existente no Apple School Manager. Depois que a substituição for concluída, será possível atualizar aquele usuário somente por meio do SFTP.
Se você editar os modelos, substitua os dados de exemplo por seus próprios dados. Não altere o conteúdo da linha do cabeçalho de nenhum arquivo. Não crie colunas duplicadas em nenhum arquivo. É possível adicionar colunas a modelos específicos.
Em todos os modelos, cada linha deve representar um valor único. Por exemplo: dentro do arquivo students.csv, cada linha deve corresponder a um único aluno. Alguns valores do aluno podem estar vazios. Os valores literais (por exemplo, uma quebra de linha ou aspas dentro de um nome) precisam ser identificados como caracteres de escape com uma barra invertida (\). Eis um exemplo: \". Qualquer identificador inserido deve ser alfanumérico e pode incluir um hífen (-).
Se seu valor contiver um espaço ( ) ou uma vírgula (,), use aspas duplas retas (") em volta dele. Se seu valor não tiver nenhum desses caracteres especiais, não use aspas. Se você não usar aspas onde elas forem necessárias ou se usar aspas curvas, o processo de carregamento resultará em erros.
Os valores em seus arquivos precisam ser separados por vírgula (,) ou ponto e vírgula (;), independentemente da forma como você criou o arquivo. Não use espaços ou tabulações entre uma vírgula ou um ponto e vírgula e o próximo valor. Todos os arquivos devem ser codificados em UTF-8. Para representar o fim da linha, use a codificação de nova linha do UNIX: \n.
Se uma entrada de um upload anterior estiver faltando, a conta do usuário será desativada e apagada automaticamente após 120 dias, a menos que:
O usuário tem uma função que comprou apps ou livros em grande volume
O usuário é apagado manualmente antes do limite de 120 dias
Os nomes dos arquivos CSV devem corresponder exatamente ao nome do arquivo original.
Todos os arquivos precisam ser compactados em um arquivo .zip para que sejam carregados.
Nenhum arquivo poderá ser colocado dentro de uma pasta no arquivo compactado.
Todas as referências de chave estrangeira a outros arquivos .csv devem ser definidas no arquivo referenciado.
Limites de caracteres nos modelos .csv
Alguns campos nos modelos .csv têm limites no número de caracteres permitidos.
Nome do atributo | Modelos | Limite de caracteres |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Estudantes, funcionários OneRoster: Usuários | 32 |
Apple: middle_name OneRoster: middleName | Apple: Estudantes, funcionários OneRoster: Usuários | 32 |
Apple: last_name OneRoster: familyName | Apple: Estudantes, funcionários OneRoster: Usuários | 64 |
Apple: grade_level OneRoster: notas | Apple: Estudantes OneRoster: Usuários | 64 |
Apple: email_address OneRoster: e-mail | Apple: Estudantes OneRoster: Usuários | 256 |
Apple: person_number OneRoster: identificador | Apple: Estudantes, funcionários OneRoster: Usuários | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Estudantes, funcionários, turmas, listas OneRoster: Usuários, turmas, inscrições | 256 |
Apple: sis_username OneRoster: nome de usuário | Apple: Estudantes, funcionários OneRoster: Usuários | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Turmas, listas OneRoster: Turmas, inscrições | 256 |
Apple: class_number OneRoster: classCode | Apple: Estudantes, turmas OneRoster: Turmas | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Cursos, turmas OneRoster: Cursos, turmas | 256 |
Apple: course_name OneRoster: título | Apple: Cursos OneRoster: Cursos | 128 |
Apple: course_number OneRoster: courseCode | Apple: Cursos OneRoster: Cursos | 64 |
Apple: location_name OneRoster: nome | Apple: Locais OneRoster: Organizações | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Estudantes, funcionários, cursos, turmas, locais OneRoster: Usuários, cursos, turmas, organizações | 256 |