O IPSIS OneRoster pode enviar os relacionamentos de usuários entre um pai/tutor legal e o filho ao Brightspace. A integração do Brightspace Parent & Guardian com o IPSIS OneRoster está disponível apenas para clientes nos EUA, Canadá, Austrália e Irlanda.
Atualmente, apenas as seguintes funções são consideradas relevantes para o relacionamento:
Todas as outras funções serão ignoradas.
Etapas para configurar o OneRoster
- Na página Administração do IPSIS, abra a guia Configuração.
- Se você tiver um sistema de origem OneRoster 1.1 – CSV, serão exibidas as credenciais do SFTP. Copie o host, o nome de usuário e a senha (o SIS precisa dessas informações para enviar arquivos CSV ao Brightspace).
- Se você tiver um sistema de origem OneRoster 1.1 – REST, será preciso selecionar o método OAuth.
- OAuth1.0a é selecionado por padrão. Insira o URL da extremidade válido, a chave e a senha do cliente e selecione o Método de assinatura OAuth.
- Se OAuth2 for selecionado, insira o Id e a senha do cliente válidos.
- Mapeie a função Pai ou Responsável do SIS para sua função do Brightspace para pais/responsáveis.
- Mapeie a função Learner do SIS para sua função do Brightspace para alunos.
- Mapeie a Escola Organizacional SIS em um tipo de unidade organizacional Brightspace.
- Revise as outras configurações e clique em Salvar.
Observação: com base no formato de troca de dados, carregue um arquivo .CSV para criar relacionamentos pai-filho, ou faça uma solicitação REST para criar relacionamentos pai/responsável-filho. Veja abaixo um exemplo de arquivo CSV e solicitação REST.
Valores de mapeamento CSV
Para criar relacionamentos pai/responsável-filho, os AgentSourceIds no arquivo users.CSV precisam ser atualizados para pais/responsáveis e alunos.
Para obter informações detalhadas sobre os valores de mapeamento CSV, visite o tópico da documentação Maper valores CSV e consulte a tabela Usuários que exibe informações sobre os valores aceitos e os valores obrigatórios.
Exemplo de arquivo CSV
sourcedId,status,dateLastModified,enabledUser,orgSourcedIds,role,username,userIds,givenName,familyName,middleName,identifier,email,sms,phone,agentSourcedIds,grades,password
{studentsourceId},active,,TRUE,{orgSourcedIds},student,{learner username},{userId},{learner given Name},{learner family name},,,{learner email},,, "{parentsourceId1}, {parentsourceId2}",,{password}
{parentsourceId1},active,,TRUE,{orgSourcedIds},parent,{parent username},{userIds},{parent given name},{parent family name},,,{parent email},,,{studentsourceId},,{ password}
{parentsourceId2},active,,TRUE,{orgSourcedIds},parent,{parent username},{userId},{parent given name},{parent family name},,,{parent email},,,{studentsourceId},,{ password}
Solicitação REST
Para criar relacionamentos pai/responsável-filho, a solicitação de criação de usuário REST deve incluir informações dos pais/responsáveis no campo do agente.
Para obter informações mais detalhadas sobre a solicitação REST, visite o tópico Valores de mapeamento REST.
Exemplo de REST JSON com relacionamentos definidos
Para alunos:
{
"users": [{
"sourcedId": "user1",
"status": "active",
"dateLastModified": "2017-06-05T22:15:00.000Z",
"username": "userone",
"givenName": "Richard",
"middleName": "",
"familyName": "Deckard",
"role": "student",
"identifier": "user1",
"enabledUser": true,
"grades": [],
"userIds": [],
"orgs": [{
"sourcedId": "District1",
"href": "https://oneroster.infinitec",
"type": "org"
},
{
"sourcedId": "School1",
"href": "https://some_url/learningdata/v1p1/schools/5C354F4D-DFD0-406D-8B83-7D5C8B64EF8B",
"type": "org"
}],
"agents": [{
"sourcedId": "Parent1",
"href": "https://some_url/learningdata/learningdata/v1p1/users/Parent1",
"type": "user"
},
{
"sourcedId": "Parent2",
"href": "https://some_url/learningdata/learningdata/v1p1/users/Parent2",
"type": "user"
}]
}]
}
Para um pai/responsável:
{
"users": [{
"sourcedId": "Parent1",
"status": "active",
"dateLastModified": "2017-06-05T22:15:00.000Z",
"username": "Parent1",
"givenName": "James",
"middleName": "",
"familyName": "Deckard",
"role": "parent",
"identifier": "Parent1",
"enabledUser": true,
"grades": [],
"userIds": [],
"orgs": [{
"sourcedId": "District1",
"href": "https://oneroster.infinitec",
"type": "org"
},
{
"sourcedId": "School1",
"href": "https://some_url/learningdata/v1p1/schools/5C354F4D-DFD0-406D-8B83-7D5C8B64EF8B",
"type": "org"
}]
}]
}