Formato de ficheiro CSV SDS V1
Importante
CLIENTES DE TRANSIÇÃO SDS (Clássico): nem todos os campos são suportados para trazer dados para a nova experiência do SDS com base no formato v1. Irá encontrá-los indicados no Formato de Ficheiro CSV SDS v1 na coluna Necessário? como dados não suportados.
Importante
Além disso, os valores de Classificação e os valores do Requerente do Curso transmitidos têm de estar alinhados com os códigos de Lista de Valores (ENUM) correspondentes. Se necessário, utilize Gerir Lista de Valores para expandir valores de Nota e Disciplina de Curso para suportar valores de código não suportados por predefinição.
Pode utilizar ficheiros CSV (valores separados por vírgulas) no formato SDS V1 para sincronizar o seu Sistema de Informação Escolar (SIS) com Office 365. Utilizar o formato de ficheiro CSV SDS V1 para ingerir as categorias de dados abaixo permite-lhe iluminar as principais capacidades de SDS para aprovisionamento. Também o ajuda a melhorar as experiências dos produtos e funcionalidades do Microsoft 365.
Se estiver a utilizar o formato SDS V1, os ficheiros têm de estar devidamente formatados. Carregue os ficheiros, com o nome exatamente como detalhado abaixo. Os cabeçalhos de coluna são sensíveis às maiúsculas e minúsculas. Os ficheiros CSV têm de estar no formato UTF-8 e em conformidade com RFC. Além disso, não aceitamos quebras de linha nos dados recebidos. Para rever e transferir o conjunto de exemplos de ficheiros CSV do SDS V1, veja o Repositório do GitHub do SDS.
Importante
Após o carregamento inicial durante a criação do fluxo de entrada, terá de fornecer sempre o mesmo conjunto de ficheiros para carregamentos subsequentes, independentemente das alterações de dados efetuadas nos ficheiros opcionais ou não. Se não o fizer, o sistema determinará que os registos já não estão ativos e os marcará como tal.
Obrigatório: os três ficheiros listados abaixo têm de estar selecionados antes de poder progredir. Se estiver apenas a gerir utilizadores e não classes, só precisa de fornecer estes ficheiros.
school.csv
student.csv
teacher.csv
Opcional/Obrigatório: não é necessário se estiver apenas a gerir utilizadores. Se também estiver a gerir turmas e inscrições nas aulas, terá de fornecer os três ficheiros listados abaixo, juntamente com os três ficheiros acima. Se não estiver, não selecione quaisquer ficheiros com estes nomes.
section.csv
studentenrollment.csv
teacherroster.csv
Opcional: estes não são necessários para continuar, mas podem melhorar as experiências. Se um dos ficheiros abaixo estiver selecionado, o outro também tem de estar selecionado para continuar.
user.csv
guardianrelationship.csv (Requer que o registo de utilizadores e estudantes crie uma associação de contactos.)
Cada ficheiro CSV tem de conter dados para os campos indicados "Sim" em "Obrigatório", os campos indicados "Não" são dados "Opcionais". Os cabeçalhos de campo marcados como "Obrigatório" têm de existir nos ficheiros fornecidos ou não serão aceites. Os cabeçalhos de campo marcados como "Opcional" não têm de estar presentes nos ficheiros se não forem transmitidos os dados opcionais correspondentes.
Os campos com valores enumerados definidos como marcados na coluna "Tipos de Dados" têm um conjunto específico de valores que suportam. O conjunto suportado de valores predefinidos para campos Enumeração , veja Lista Predefinida de Valores.
school.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 456789 | ID Exclusivo |
| Nome | Sim | Escola Secundária da Contoso | Cadeia de caracteres |
| ID do NCES da escola | Não | 456789 | Cadeia de caracteres |
| Número da Escola | dados não suportados | ||
| Nota Baixa | dados não suportados | ||
| Nota Alta | dados não suportados | ||
| ID do Estado | dados não suportados | ||
| ID do SIS do Diretor | dados não suportados | ||
| Nome do Diretor | dados não suportados | ||
| Email Secundário do Diretor | dados não suportados | ||
| Endereço | dados não suportados | ||
| Cidade | dados não suportados | ||
| Estado | dados não suportados | ||
| CEP | dados não suportados | ||
| País/Região | dados não suportados | ||
| Telefone | dados não suportados | ||
| Zona | dados não suportados |
- Todas as organizações listadas serão definidas para o tipo de organização "escola".
student.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 123456 | ID Exclusivo |
| ID do SIS da Escola | Sim | 456789 | ID Exclusivo |
| Nome de usuário | Sim | jsmith@contoso.edu | Cadeia de caracteres |
| Nome | Sim (apenas se criar utilizadores) | Davi | Cadeia de caracteres |
| Sobrenome | Sim (apenas se criar utilizadores) | Smith | Cadeia de caracteres |
| Nome do meio | Não | Guilherme | Cadeia de caracteres |
| Email Secundário | Não | jsmith@contoso.edu | |
| Número do Aluno | Não | 123456 | Cadeia de caracteres |
| Nota | Não | 8 | Enum |
| Data de Nascimento | Não | 2009-12-19 | Data |
| Status | dados não suportados | ||
| Senha | dados não suportados | ||
| Ano de Formatura | dados não suportados | ||
| ID do Estado | dados não suportados |
- Requer uma referência à escola associada através do campo "School SIS ID" (ID do SIS Escolar). Isto produz uma dependência no ficheiro school.csv.
- Todos os utilizadores listados serão definidos para o tipo de função "estudante".
- Espere que os valores de data sejam fornecidos no formato ISO8601.
- Zeros à esquerda "0" em falta no valor de entrada para Enumeração de Nível de Grau, por exemplo "1", corresponderão à Lista de Valores definida (ENUM) "01" e serão armazenados como "01".
teacher.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 654321 | ID Exclusivo |
| ID do SIS da Escola | Sim | 456789 | ID Exclusivo |
| Nome de usuário | Sim | jcook@contoso.edu | Cadeia de caracteres |
| Nome | Sim (apenas se criar utilizadores) | Joana | Cadeia de caracteres |
| Sobrenome | Sim (apenas se criar utilizadores) | Cozinhar | Cadeia de caracteres |
| Nome do meio | Não | Meredith | Cadeia de caracteres |
| Número do professor | Não | 654321 | Cadeia de caracteres |
| Nota | Não | 8 | Enum |
| Email Secundário | Não | jcook@contoso.edu | |
| Status | dados não suportados | ||
| Senha | dados não suportados | ||
| Título | dados não suportados | ||
| ID do Estado | dados não suportados | ||
| Qualificação | dados não suportados |
- Requer uma referência à escola associada através do campo "School SIS ID" (ID do SIS Escolar). Isto produz uma dependência no ficheiro school.csv.
- Todos os utilizadores listados serão definidos para o tipo de função "professor".
- Zeros à esquerda "0" em falta no valor de entrada para Enumeração de Nível de Grau, por exemplo "1", corresponderão à Lista de Valores definida (ENUM) "01" e serão armazenados como "01".
section.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 334455 | ID Exclusivo |
| ID do SIS da Escola | Sim | 456789 | ID Exclusivo |
| Nome da Secção | Sim | Período 1 - História mundial | Cadeia de caracteres |
| Número da seção | Não | 334466 | Cadeia de caracteres |
| ID do SIS do Curso | Não | 123456789 | ID Exclusivo |
| Nome do curso | Não | História Mundial 10 | Cadeia de caracteres |
| Número do curso | Não | 123456789 | Cadeia de caracteres |
| Descrição do curso | Não | História do Mundo | Cadeia de caracteres |
| Assunto do curso | Não | 54999 | Enum |
| ID do SIS do Termo | dados não suportados | ||
| Nome do termo | dados não suportados | ||
| StartDate do termo | dados não suportados | ||
| EndDate do termo | dados não suportados | ||
| Status | dados não suportados | ||
| Periods | dados não suportados |
- Requer uma referência à escola associada através do campo "School SIS ID" (ID do SIS Escolar). Isto produz uma dependência no ficheiro school.csv.
- Se forem necessárias informações sobre o Termo, recomendamos mover para o formato CSV SDS v2.1 e também fornecer academicSessions.csv ficheiro.
studentenrollment.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| ID do SIS da Secção | Sim | 334455 | ID Exclusivo |
| SIS ID | Sim | 123456 | ID Exclusivo |
- Isto requer uma referência à secção associada através do campo "ID do SIS da Secção". Isto produz uma dependência no ficheiro section.csv.
- Isto requer uma referência ao utilizador associado através do campo "ID do SIS". Isto produz uma dependência no ficheiro student.csv.
teacherroster.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| ID do SIS da Secção | Sim | 334455 | ID Exclusivo |
| SIS ID | Sim | 654321 | ID Exclusivo |
- Isto requer uma referência à secção associada através do campo "ID do SIS da Secção". Isto produz uma dependência no ficheiro section.csv.
- Isto requer uma referência ao utilizador associado através do campo "ID do SIS". Isto produz uma dependência no ficheiro teacher.csv.
user.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| Sim | jsmith@outlook.com | ||
| Nome | Sim | Davi | Cadeia de caracteres |
| Sobrenome | Sim | Smith | Cadeia de caracteres |
| Telefone | Não | +1234567890 | Telefone |
| SIS ID | Não | P_123456 | ID Exclusivo |
- Se também estiver a sincronizar Relações de Contacto (tutores), tem de incluir um registo para os mesmos no user.csv.
- Espere que o campo de telefone seja formatado com base na norma E.164 onde o caráter de adição é utilizado e com êxito pelo número de telefone ou, em vez disso, pelo caráter de adição seguido de código de país, código de área, prefixo de telefone e número de linha.
guardianrelationship.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 123456 | ID Exclusivo |
| Sim | jsmith@outlook.com | ||
| Função | Não | Pai | Enum |
- Se também estiver a sincronizar Relações de Contacto (tutores), tem de incluir um registo para os mesmos no user.csv.
- Isto requer uma referência ao utilizador associado através do campo "Email". Isto produz uma dependência no ficheiro user.csv.
- Isto requer uma referência ao utilizador associado através do campo "ID do SIS". Isto produz uma dependência no ficheiro student.csv.
- Se o Valor da função não for fornecido, o valor da relação é predefinido como "userContact".