Informações sobre os modelos para importação de registros no Apple School Manager
A Apple fornece seis modelos para usar ao adicionar dados ao seu local de ensino:
Alunos: contém informações sobre contas de aluno.
Funcionários: contém informações sobre contas de funcionários, tais como instrutores.
Cursos: define os cursos.
Turmas: contém informações sobre os cursos, os instrutores (funcionários).
Listas: contém informações sobre turmas, alunos e locais.
Local: contém informações sobre locais.
Modelos e IDs Apple gerenciados
Se um campo opcional, como person_number ou sis_username, for parte do formato do seu ID Apple gerenciado, 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 será desativa e apagada automaticamente após 120 dias, exceto se a conta tiver conteúdo adquirido em volume.
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.
Campo | Modelos | Limite de caracteres |
---|---|---|
first_name | Alunos, Funcionários | 32 |
middle_name | Alunos, Funcionários | 32 |
last_name | Alunos, Funcionários | 64 |
grade_level | Alunos | 64 |
email_address | Alunos | 256 |
person_number | Alunos, Funcionários | 64 |
person_id | Alunos, Funcionários, Turmas, Listas | 256 |
sis_username | Alunos, Funcionários | 256 |
class_id | Turmas, Listas | 256 |
class_number | Turmas | 64 |
course_id | Cursos, Turmas | 256 |
course_name | Cursos | 128 |
course_number | Cursos | 64 |
location_name | Locais | 256 |
location_id | Alunos, Funcionários, Cursos, Turmas, Locais | 256 |