Informações de modelos para importar dados para o Apple School Manager
Para adicionar dados ao Apple School Manager, pode utilizar os ficheiros de modelo .csv formatados pela Apple ou pelo OneRoster.
Nomes do modelo .csv da Apple: alunos, funcionários, cursos, turmas, listas, estabelecimentos
Nomes do modelo .csv do OneRoster: utilizadores, cursos, turmas, inscrições, organizações
Nome de ficheiro Apple | Nome de ficheiro OneRoster | Conteúdos | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: contém informações de conta dos alunos. OneRoster: contém informações de conta dos alunos, formadores e funcionários. | |||||||||||
N/D | Contém informações de contas de funcionários, como, por exemplo, formadores. | ||||||||||
Contém informações do curso. | |||||||||||
Contém informações sobre as turmas e formadores (funcionários). | |||||||||||
Contém informações de turmas, alunos e estabelecimentos (listas) de ensino. | |||||||||||
Contém informações de estabelecimentos (instituição de ensino ou departamento). | |||||||||||
Modelos e ID Apple geridos
Se um campo opcional, tal como person_number ou sis_username, fizer parte do formato do seu ID Apple gerido, passa a ser um campo de preenchimento obrigatório. Se o deixar em branco, o carregamento SFTP falha com a apresentação do erro MANAGED_ID_GENERATION_FAILED.
Preparar modelos
Ao preparar um modelo, têm de ser cumpridos os seguintes critérios:
Para os modelos students.csv e staff.csv, o person_id tem de ser único para todos os estabelecimentos.
Importante: Se utilizar SFTP para carregar um novo utilizador e o person_id que atribuir já tiver sido atribuído a outro utilizador, o novo utilizador substitui o utilizador existente no Apple School Manager. Depois de concluída a substituição, só pode atualizar esse utilizador através de SFTP.
Se editar os modelos, substitua os dados de exemplo pelos seus próprios dados. Não altere o conteúdo da linha de cabeçalho em cada ficheiro. Não crie colunas duplicadas em nenhum dos ficheiros. Pode adicionar colunas a modelos específicos.
Em cada modelo, cada linha tem de representar um valor único. Por exemplo, no ficheiro students.csv, cada linha tem de corresponder a um único aluno. Determinados valores para esse(a) aluno(a) podem estar vazios. Valores literais, como por exemplo, uma quebra de linha ou um ponto de interrogação num nome, têm de ser delimitados com uma barra invertida (\). Eis um exemplo: \". Quaisquer identificadores introduzidos têm de ser alfanuméricos e podem incluir um hífen (‑).
Se o seu valor contiver um espaço ( ) ou uma vírgula (,), utilize aspas direitas (") para o delimitar. Se o seu valor não tiver nenhum destes caracteres especiais, não utilize aspas. Se não utilizar aspas quando for necessário, ou se utilizar aspas curvas, surgirão erros no processo de carregamento.
Os valores nos seus ficheiros têm de ser separados por vírgulas (,) ou ponto e vírgula (;), independentemente da forma como criou o ficheiro. Não utilize espaços ou tabulações entre uma vírgula ou um ponto e vírgula e o valor seguinte. Cada ficheiro tem de ser codificado como UTF‑8. Para representar o fim de linha, utilize a codificação de quebras de linha UNIX \n.
Se existir uma entrada de um carregamento anterior em falta, a conta de utilizador é desativada e apagada automaticamente após 120 dias, a menos que:
O(a) utilizador(a) tenha uma função que comprou apps ou livros em volume.
O(a) utilizador(a) seja apagado(a) manualmente antes do limite de 120 dias.
Os nomes dos ficheiros .csv devem corresponder exatamente aos nomes dos ficheiros originais.
Todos os ficheiros têm de ser comprimidos num ficheiro de arquivo (.zip) para poder carregá‑los.
Nenhum ficheiro pode ser colocado dentro de uma pasta no ficheiro de arquivo comprimido.
Todas as referências de chave externa a outros ficheiros .csv têm de ser definidas no ficheiro referenciado.
Limites de caracteres nos modelos .csv
Alguns campos nos modelos .csv têm limites quanto ao número máximo de caracteres permitidos.
Nome do atributo | Modelos | Limite de caracteres |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: alunos, funcionários OneRoster: utilizadores | 32 |
Apple: middle_name OneRoster: middleName | Apple: alunos, funcionários OneRoster: utilizadores | 32 |
Apple: last_name OneRoster: familyName | Apple: alunos, funcionários OneRoster: utilizadores | 64 |
Apple: grade_level OneRoster: grades | Apple: alunos OneRoster: utilizadores | 64 |
Apple: email_address OneRoster: email | Apple: alunos OneRoster: utilizadores | 256 |
Apple: person_number OneRoster: identifier | Apple: alunos, funcionários OneRoster: utilizadores | 64 |
Apple: person_id OneRoster: sourcedId | Apple: alunos, funcionários, turmas, listas OneRoster: utilizadores, turmas, inscrições | 256 |
Apple: sis_username OneRoster: username | Apple: alunos, funcionários OneRoster: utilizadores | 256 |
Apple: class_id OneRoster: sourcedID | Apple: turmas, listas OneRoster: turmas, inscrições | 256 |
Apple: class_number OneRoster: classCode | Apple: alunos, turmas OneRoster: turmas | 64 |
Apple: course_id OneRoster: sourcedID | Apple: cursos, turmas OneRoster: cursos, turmas | 256 |
Apple: course_name OneRoster: title | Apple: cursos OneRoster: cursos | 128 |
Apple: course_number OneRoster: courseCode | Apple: cursos OneRoster: cursos | 64 |
Apple: location_name OneRoster: name | Apple: estabelecimentos OneRoster: organizações | 256 |
Apple: location_id OneRoster: sourcedID | Apple: alunos, funcionários, cursos, turmas, estabelecimentos OneRoster: utilizadores, cursos, turmas, organizações | 256 |