Informações de modelos para importar registos para o Apple School Manager
A Apple fornece seis modelos para utilizar ao adicionar dados ao seu estabelecimento:
Alunos: contém informações de conta de alunos.
Funcionários: contém informações de conta de funcionários, como, por exemplo, formadores.
Cursos: define cursos.
Turmas: contém informações de cursos e formadores (equipa).
Listas: contém informações de turmas, alunos e estabelecimentos de ensino.
Estabelecimentos: contém informações de estabelecimentos.
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 faltar uma entrada de um carregamento anterior, a conta será desativada e automaticamente apagada após 120 dias, a menos que a conta tenha comprado conteúdo em volume.
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.
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 | Estabelecimentos | 256 |
location_id | Alunos, Funcionários, Cursos, Turmas, Estabelecimentos | 256 |