Formato de arquivo CSV do SDS V1
Importante
CLIENTES DE TRANSIÇÃO SDS (Clássicos): nem todos os campos têm suporte para trazer dados para a nova experiência do SDS com base no formato v1. Você os encontrará anotados no Formato de Arquivo CSV do SDS v1 em coluna Obrigatório? como dados não compatíveis.
Importante
Além disso, valores de grau e valores de Disciplina de Curso passados devem se alinhar aos códigos ENUM (Lista de Valores) correspondentes. Se necessário, utilize a Lista de Valores de Gerenciamento para expandir valores de grau e Sujeito de Curso para dar suporte a valores de código não compatíveis por padrão.
Você pode usar arquivos CSV (valor separado por vírgula) no formato SDS V1 para sincronizar seu SIS (Sistema de Informações Escolares) com Office 365. Usar o formato de arquivo CSV do SDS V1 para ingerir as categorias de dados abaixo permite que você ilumine os principais recursos do SDS para provisionamento. Ele também ajuda você a aprimorar experiências para os produtos e recursos do Microsoft 365.
Se você estiver usando o formato SDS V1, os arquivos devem ser formatados adequadamente. Carregue os arquivos, nomeados exatamente como detalhados abaixo. Os cabeçalhos de coluna são sensíveis a maiúsculas de minúsculas. Os arquivos CSV devem estar em formato UTF-8 e em conformidade com RFC. Além disso, não aceitamos quebras de linha nos dados de entrada. Para examinar e baixar o conjunto de exemplos de arquivos CSV do SDS V1, consulte o Repositório github do SDS.
Importante
Após o upload inicial durante a criação do fluxo de entrada, você precisará sempre fornecer o mesmo conjunto de arquivos para uploads subsequentes, independentemente das alterações de dados feitas nos arquivos opcionais ou não. Se você não fizer isso, o sistema determinará que os registros não estão mais ativos e os marcarão como tal.
Necessário: os três arquivos listados abaixo devem ser selecionados antes que você possa progredir. Se você estiver apenas gerenciando usuários e não classes, você só precisará fornecer esses arquivos.
school.csv
student.csv
teacher.csv
Opcional/Obrigatório: não é necessário se você estiver apenas gerenciando usuários. Se você também estiver gerenciando classes e registros de classe, precisará fornecer os três arquivos listados abaixo, juntamente com os três arquivos acima. Se você não estiver, não selecione nenhum arquivo com esses nomes.
section.csv
studentenrollment.csv
teacherroster.csv
Opcional: eles não são necessários para prosseguir, mas podem aprimorar experiências. Se um dos arquivos abaixo for selecionado, o outro também deverá ser selecionado para prosseguir.
user.csv
guardianrelationship.csv (requer registro de usuário e aluno para criar associação de contatos.)
Cada arquivo CSV deve conter dados para os campos anotados como 'Sim' em 'Obrigatório', os campos observados 'Não' são dados 'Opcional'. Os cabeçalhos de campo marcados como 'Obrigatórios' devem existir nos arquivos fornecidos ou não serão aceitos. Os cabeçalhos de campo marcados como "Opcional" não devem estar presentes nos arquivos se não passarem 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 compatíveis. O conjunto com suporte de valores padrão para campos Enum vê Lista padrão de valores.
school.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 456789 | ID exclusiva |
| Nome | Sim | Contoso High School | Cadeia de caracteres |
| ID do NCES da escola | Não | 456789 | Cadeia de caracteres |
| Número da Escola | não há suporte para dados | ||
| Nota Baixa | não há suporte para dados | ||
| Nota Alta | não há suporte para dados | ||
| ID do Estado | não há suporte para dados | ||
| ID do SIS do Diretor | não há suporte para dados | ||
| Nome do Diretor | não há suporte para dados | ||
| Email Secundário do Diretor | não há suporte para dados | ||
| Endereço | não há suporte para dados | ||
| Cidade | não há suporte para dados | ||
| Estado | não há suporte para dados | ||
| CEP | não há suporte para dados | ||
| País/Região | não há suporte para dados | ||
| Telefone | não há suporte para dados | ||
| Zona | não há suporte para dados |
- Todas as organizações listadas serão definidas como o tipo de organização "escola".
student.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 123456 | ID exclusiva |
| ID do SIS da escola | Sim | 456789 | ID exclusiva |
| Nome de usuário | Sim | jsmith@contoso.edu | Cadeia de caracteres |
| Nome | Sim (somente se criar usuários) | Davi | Cadeia de caracteres |
| Sobrenome | Sim (somente se criar usuários) | Smith | Cadeia de caracteres |
| Nome do meio | Não | William | 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 | não há suporte para dados | ||
| Senha | não há suporte para dados | ||
| Ano de Formatura | não há suporte para dados | ||
| ID do Estado | não há suporte para dados |
- Requer uma referência à escola associada usando o campo "ID do SIS escolar". Isso produz uma dependência do arquivo school.csv.
- Todos os usuários listados serão definidos como o tipo de função 'student'.
- Espere que os valores de data sejam fornecidos no formato ISO8601.
teacher.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 654321 | ID exclusiva |
| ID do SIS da escola | Sim | 456789 | ID exclusiva |
| Nome de usuário | Sim | jcook@contoso.edu | Cadeia de caracteres |
| Nome | Sim (somente se criar usuários) | Jane | Cadeia de caracteres |
| Sobrenome | Sim (somente se criar usuários) | 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 | não há suporte para dados | ||
| Senha | não há suporte para dados | ||
| Título | não há suporte para dados | ||
| ID do Estado | não há suporte para dados | ||
| Qualificação | não há suporte para dados |
- Requer uma referência à escola associada usando o campo "ID do SIS escolar". Isso produz uma dependência do arquivo school.csv.
- Todos os usuários listados serão definidos como o tipo de função "professor".
section.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 334455 | ID exclusiva |
| ID do SIS da escola | Sim | 456789 | ID exclusiva |
| Nome da seçã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 exclusiva |
| 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 | não há suporte para dados | ||
| Nome do termo | não há suporte para dados | ||
| StartDate do termo | não há suporte para dados | ||
| EndDate do termo | não há suporte para dados | ||
| Status | não há suporte para dados | ||
| Periods | não há suporte para dados |
- Requer uma referência à escola associada usando o campo "ID do SIS escolar". Isso produz uma dependência do arquivo school.csv.
- Se as informações de termo forem necessárias, é recomendável migrar para o formato CSV do SDS v2.1 e também fornecer academicSessions.csv arquivo.
studentenrollment.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| ID do SIS da seção | Sim | 334455 | ID exclusiva |
| SIS ID | Sim | 123456 | ID exclusiva |
- Isso requer uma referência à seção associada usando o campo "ID do SIS da Seção". Isso produz uma dependência do arquivo section.csv.
- Isso requer uma referência ao usuário associado usando o campo 'ID do SIS'. Isso produz uma dependência do arquivo student.csv.
teacherroster.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| ID do SIS da seção | Sim | 334455 | ID exclusiva |
| SIS ID | Sim | 654321 | ID exclusiva |
- Isso requer uma referência à seção associada usando o campo "ID do SIS da Seção". Isso produz uma dependência do arquivo section.csv.
- Isso requer uma referência ao usuário associado usando o campo 'ID do SIS'. Isso produz uma dependência do arquivo 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 exclusiva |
- Se você também estiver sincronizando Relações de Contato (guardiões), deverá incluir um registro para eles no user.csv.
- Espere que o campo de telefone seja formatado com base no padrão E.164 em que o caractere plus é usado e bem-sucedido pelo número de telefone, ou melhor, o caractere de adição seguido pelo código do país, código de área, prefixo telefônico e número de linha.
guardianrelationship.csv
| Campo | Obrigatório? | Exemplo | Tipo de dados |
|---|---|---|---|
| SIS ID | Sim | 123456 | ID exclusiva |
| Sim | jsmith@outlook.com | ||
| Função | Não | Pai | Enum |
- Se você também estiver sincronizando Relações de Contato (guardiões), deverá incluir um registro para eles no user.csv.
- Isso requer uma referência ao usuário associado usando o campo 'Email'. Isso produz uma dependência do arquivo user.csv.
- Isso requer uma referência ao usuário associado usando o campo 'ID do SIS'. Isso produz uma dependência do arquivo student.csv.
- Se o valor de função não for fornecido, o valor da relação será padrão para 'userContact'.