Exemplos de cursos de arquivo simples do Snapshot
Os exemplos a seguir demonstram a composição dos feeds de dados do curso que atendem a uma variedade de casos de uso. Esses exemplos usam o feed de dados mais simples possível que atende ao caso de uso. Há muitos outros cabeçalhos de feed do CURSO para uso na criação de registros do curso – a análise dos requisitos e planejamento do sistema de informações e do registrador da sua instituição ajudará a determinar a profundidade dos dados necessários para preencher corretamente o Blackboard, atendendo às suas metas de ciclo de vida dos dados e do curso.
Nota
Os exemplos são baseados nas configurações padrão do Blackboard visíveis na interface do usuário de configuração de integração. Alterar esses elementos de configuração resultará em alterações nos resultados de exemplo. Explicações sobre essas configurações estão disponíveis em Visão geral da estrutura do Sistema de informações do aluno (SIA) e Configuração de integração de arquivo simples do Snapshot. Além disso, supõe-se que, a menos que observado de outra forma, a integração esteja configurada para usar a mesma fonte de dados para todos os dados de entrada.
Cursos
Os dados do curso são o principal conjunto de informações que descreve um curso no Blackboard. No contexto de dados do SIA, os objetos do curso geralmente são chamados de "SEÇÕES" e isso é refletido nos padrões existentes. Anterior a muitos desses padrões, o arquivo simples do Snapshot do Blackboard usa "COURSE" para se referir a registros relacionados ao curso com base no contexto.
Operações
Os dados podem ser fornecidos à Blackboard e, posteriormente, atualizados, excluídos ou alterados, portanto, você pode começar com o conjunto de dados mais simples e aumentar à medida que os requisitos de dados da sua instituição mudam.
Nota
O único campo código imutável é código – esse campo não pode ser alterado depois que um registro é criado e o registro deve ser desabilitado e excluído se o código precisar ser alterado. Isso tem ramificações que impactam os registros de atividade. Portanto, é altamente recomendável que você use um elemento de dados que provavelmente não mudará durante o ciclo de vida do curso.
Gerenciamento de dados do arquivo simples do Snapshot
Atenção
Observe que o envio de um arquivo pequeno corretivo com a operação Atualização completa ou Atualização completa por fonte de dados pode causar inadvertidamente a exclusão ou desabilitação em massa de dados. Para evitar isso, desencorajamos o uso manual dos tipos de operação Atualização Completa ou Atualização Completa por Fonte de Dados. Por padrão, essas opções não estão disponíveis na página Carregar arquivo de feed. No entanto, se você habilitar ambas as opções, marque a caixa de seleção Habilitar opções avançadas em Tipo de operação.
A estrutura do Sistema de informações do aluno (SIA) oferece suporte a uploads de feed de dados de arquivo simples do Snapshot por meio de um upload de feed de interface do usuário e por meio de um conjunto de URLs fornecidos pelo sistema Blackboard.
Acesse as informações de HTTP e carregue o arquivo de feed por meio do menu de integração na UI de integração de sistemas de informações do aluno para integração de dados de administração do sistema.
Em ambos os casos, o comportamento da operação de dados é orientado pela configuração da integração e pelo tipo de operação selecionado. O tipo de operação de dados selecionado controla como os dados no feed são "interpretados" e cada URL fornecerá diferentes resultados para atender às metas desejadas da sua integração.
Operação | Descrição |
|---|---|
Armazenamento | Ao usar esse tipo de operação, os dados contidos no arquivo de feed são armazenados ou atualizados (por definições de configuração) em todas as fontes de dados que pertencem à integração. (consulte Visão geral do framework SIA para ver a "propriedades" dos dados e a origem deles) |
Atualização completa | Essa operação armazena ou atualiza os dados contidos no feed de dados e, ao mesmo tempo, desabilita os dados que não estão contidos no feed de dados associado à integração em todas as fontes de dados. Você deve clicar emHabilitar opções avançadas para disponibilizar essa opção ao carregar um arquivo manualmente. |
Excluir | Esta operação desabilita, por configurações de integração, os registros contidos no feed de dados associado à integração em todas as fontes de dados. |
Atualização completa pela fonte de dados | Essa operação executa uma atualização completa dos dados associados SOMENTE à fonte de dados configurada pela integração. Esta operação emula mais de perto o processo de captura de tela da linha de comando para atualizar dados. Você deve clicar emHabilitar opções avançadas para disponibilizar essa opção ao carregar um arquivo manualmente. |
Os objetos associados às operações do curso são:
Atenção
Observe que o envio de um arquivo pequeno corretivo com a operação Atualização completa ou Atualização completa por fonte de dados pode causar inadvertidamente a exclusão ou desabilitação em massa de dados. Para evitar isso, desencorajamos o uso manual dos tipos de operação Atualização Completa ou Atualização Completa por Fonte de Dados. Por padrão, essas opções não estão disponíveis na página Carregar arquivo de feed. No entanto, se você habilitar ambas as opções, marque a caixa de seleção Habilitar opções avançadas em Tipo de operação.
Objeto | Operações |
|---|---|
Curso | Armazenamento, atualização completa, exclusão, atualização completa pela fonte de dados |
Associação de curso | Armazenamento, atualização completa, exclusão, atualização completa pela fonte de dados |
Associação padrão de curso | Armazenamento, atualização completa, exclusão, atualização completa pela fonte de dados |
Os exemplos de associação de curso podem ser encontrados na seção Exemplo de hierarquia.
Os exemplos fornecidos são demonstrados usando o recurso de arquivo de feed de upload da IU da estrutura do Snapshot. Para saber mais sobre como automatizar ou usar outras linhas de comando/operações de programação, consulte Automação de arquivo simples do Snapshot.
Um lembrete sobre chaves de fonte de dados
Todos os objetos de dados suportam a capacidade de alterar a chave da fonte de dados para o agrupamento desse conjunto de dados e podem ser usados para alterar a fonte de dados associada – Observação: este não é um campo obrigatório em feeds de dados baseados em Framework e, a menos que indicado, os exemplos a seguir pressupõem que a integração está configurada para usar uma única fonte de dados.
Consulte Gerenciamento da chave da fonte de dados e a seção sobre como alterar a fonte de dados de um registro do curso.
Uma observação sobre mapeamento de campo
O mapeamento de campo fornece a capacidade de alterar os dados recebidos antes de serem armazenados no Blackboard. Isso permite que você tenha controle total sobre os dados armazenados e atenda às regras específicas do Blackboard quando os dados do Sistema de informações do aluno (SIA) fornecidos são insuficientes, por exemplo: a criação de uma entrada de nome de curso adequada. Quando aplicado a um campo de objeto COURSE, o script associado é executado por registro de curso, alterando ou fornecendo os dados antes de serem armazenados no Blackboard. Para saber mais sobre o mapeamento de campo, consulte Mapeamento de campo personalizado de arquivo simples do Snapshot.
Exemplos de operação do curso
Em um nível alto, você pode identificar três padrões de feed de dados de integração do SIA que podem ser aplicados a todas as operações de dados do curso, e a seleção do padrão depende dos dados que você pode fornecer.
Usando um único arquivo de feed, você pode armazenar e atualizar registros (armazenar) utilizando um processo separado para desabilitar (excluir) registros
Usando um único arquivo de feed, você pode armazenar, atualizar e desabilitar registros (atualização completa)
Usando uma combinação de arquivos, você pode armazenar com um, desabilitar com um segundo.
Por fim, e este não é um padrão de feed do Sistema de informações do aluno (SIA), mas vale a pena mencionar, você também pode desabilitar e excluir com base apenas no DSK utilizando a ferramenta de gerenciamento de fonte dados disponível na interface do usuário. Você deve ser muito discreto ao gerenciar os dados fornecidos pelo SIA dessa maneira. Isto é extremamente útil para eliminar dados que nunca foram ou deixaram de ser fornecidos através do Sistema de informações do aluno (SIA) ou o resultado de operações de teste.
Apenas o básico: Cursos
Todas as contas do curso requerem um conjunto básico de informações para estabelecer uma conta. Para saber mais, consulte Formato de dados do arquivo simples do Snapshot e Descrições do cabeçalho do arquivo simples do Snapshot.
Nota
Se você estiver usando as ferramentas de lote da IU alternando para o uso da estrutura do SIA e usando os dados mínimos do curso e os recursos de upload da IU da estrutura do SIA, você terá mais registros e relatórios de uploads de dados sem alterar seus processos de coleta de dados.
Dados em resumo
O conjunto de dados ou cabeçalhos mínimos necessários para criar uma conta de curso no Blackboard consiste em:
EXTERNAL_COURSE_KEY: um identificador exclusivo para este registro de curso.
DATA_SOURCE_KEY – Um identificador exclusivo para o conjunto de dados deste registro. Observação: isso é fornecido no feed ou por meio da configuração de integração)
COURSE_ID: o código do curso. Ele é usado como um identificador de exibição exclusivo para o curso. COURSE_NAME: o título do curso.
A estrutura do SIA, conforme uma configuração de integração, fornece valores padrão para campos não obrigatórios ou os ignora. Dois campos úteis que não são obrigatórios para um feed do curso são AVAILABLE_IND e ROW_STATUS. Eles serão abordados no seguinte caso de uso.
Nota
Cada um desses cabeçalhos é descrito completamente em Descrições do cabeçalho do arquivo simples do Snapshot.
Adicionando informações do curso
Existem dois casos para adicionar informações sobre o curso. O primeiro é armazenar informações sobre o curso de maneira aditiva, resultando na adição ou atualização de registros, conforme apresentado no feed de dados. A segunda é ATUALIZAR as informações do CURSO já presentes no Blackboard, resultando na adição de novos registros ou na atualização de registros existentes, conforme apresentado no arquivo de dados, ao mesmo tempo em que desativa os registros existentes do Blackboard que não estão presentes no arquivo de dados do CURSO.
Exemplos da operação de armazenamento
Exemplo #1: Criar cursos
Você deseja adicionar cursos ao BLACKBOARD sem afetar as contas existentes. Você tem sua integração configurada para usar a mesma fonte de dados para todos os dados de entrada.
Pré-requisito
Nenhum.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Solução
Crie um arquivo de dados COURSES.txt que contenha os cabeçalhos exigidos e os dados associados por curso que você queira adicionar ao sistema. Por exemplo:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1
testCourse2|Course.2.1.SP2013|Test Course 2
testCourse3|Course.3.1.FA2013|Test Course 3
Use a IU para carregar este arquivo conforme o tipo de dados PESSOAIS, mediante operação de ARMAZENAMENTO. As contas do curso serão criadas e você poderá descobri-las por meio das ferramentas do curso do administrador do sistema.
Condição a posteriori
Os registros do CURSO para Course.1.1.SP2013, Course.2.1.SP2013 e Course.3.1.FA2014 são criados.
Exemplo #2: Atualizar cursos
Você criou as contas do curso e precisa alterá-las. Por exemplo.: o exemplo acima não continha o termo no nome do curso.
Pré-requisito
Nenhum – os cursos existentes serão atualizados, todos os novos dados do curso no feed criarão novos cursos.
Solução
Crie um arquivo de dados COURSES.txt que contenha os cabeçalhos exigidos e os dados associados por curso que você queira atualizar no sistema. Por exemplo:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Nota
Como o STORE opera apenas nos dados contidos no arquivo, o registro Course.3.1.FA2013 enviado anteriormente não é afetado.
Use a IU para carregar este arquivo conforme o tipo de dados PESSOAIS, mediante operação de ARMAZENAMENTO. Os registros do curso no arquivo serão atualizados.
Condição a posteriori
O registro do CURSO para Curso.1.1.SP2013 e Curso.2.1.SP2013 é atualizado para incluir o termo no COURSE_NAME
O registro do CURSO para Course.3.1.FA2014 não é afetado.
Curso: Conclua a operação do curso de atualização
Atenção
Observe que o envio de um arquivo pequeno corretivo com a operação Atualização completa ou Atualização completa por fonte de dados pode causar inadvertidamente a exclusão ou desabilitação em massa de dados. Para evitar isso, desencorajamos o uso manual dos tipos de operação Atualização Completa ou Atualização Completa por Fonte de Dados. Por padrão, essas opções não estão disponíveis na página Carregar arquivo de feed. No entanto, se você habilitar ambas as opções, marque a caixa de seleção Habilitar opções avançadas em Tipo de operação.
COMPLETE REFRESH opera de maneira diferente de STORE. A atualização completa executa duas operações que se aplicam a uma comparação dos dados no arquivo de feed e dos registros do LEARN de propriedade da integração – armazenamento de novos registros, atualização de registros existentes ou desabilitação de registros no LEARN que não estão no arquivo de dados.
Exemplo: Atualização completa
Os dados fornecidos pelo Sistema de informações do aluno (SIA) contêm uma captura de tela completa dos CURSOS que devem existir no BLACKBOARD. Esses dados contêm registros do CURSO a serem adicionados, registros do CURSO a serem atualizados e registros que foram excluídos desde as operações anteriores de ATUALIZAÇÃO COMPLETA que devem ser tratados adequadamente por configuração (desabilitar ou excluir).
Pré-requisito
Nenhum.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Solução
Começando com os dados de nossa primeira operação de armazenamento do COURSE e adicionando Course.1.2.SP2013 ao feed de dados e excluindo Course.3.1.FA2013:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Observe que, se outros registros do CURSO forem gerenciados por essa integração, eles serão desabilitados ou excluídos devido à sua ausência no feed de dados acima.
Condição a posteriori
O registro COURSE para Course.1.1.SP2013 é reter e atualizado para incluir a seção no COURSE_NAME
O registro COURSE para Course.1.2.SP2013 é adicionado ao Blackboard
O registro COURSE para Course.2.1.SP2013 é reter e não é afetado.
O registro COURSE para Course.3.1.FA2013, por estar ausente do feed de dados, é marcado como desabilitado ou pronto para exclusão de acordo com a configuração de integração.
Curso: Atualização completa por fonte de dados
Atenção
Observe que o envio de um arquivo pequeno corretivo com a operação Atualização completa ou Atualização completa por fonte de dados pode causar inadvertidamente a exclusão ou desabilitação em massa de dados. Para evitar isso, desencorajamos o uso manual dos tipos de operação Atualização Completa ou Atualização Completa por Fonte de Dados. Por padrão, essas opções não estão disponíveis na página Carregar arquivo de feed. No entanto, se você habilitar ambas as opções, marque a caixa de seleção Habilitar opções avançadas em Tipo de operação.
A ATUALIZAÇÃO COMPLETA PELA FONTA DE DADOS realiza uma operação de ATUALIZAÇÃO COMPLETA, porém, restringe os dados afetados apenas aos que estiverem associados à fonte de dados da integração.
Exemplo: atualização completa por fonte de dados
Os dados fornecidos pelo Sistema de informações do aluno (SIA) contêm uma captura de tela completa dos CURSOS que devem existir no BLACKBOARD. Esses dados contêm registros do CURSO a serem adicionados, registros do CURSO a serem atualizados e registros que foram excluídos desde as operações anteriores de ATUALIZAÇÃO COMPLETA que devem ser tratados adequadamente por configuração (desabilitar ou excluir). Além disso, todos os dados nessa atualização são direcionados usando a mesma fonte de dados definida na integração e SOMENTE os dados relacionados a essa chave da fonte de dados serão afetados.
Pré-requisito
Nenhum.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Solução
Uso dos dados da nossa última operação de armazenamento e exclusão do Course.2.1.SP2013 do feed de dados:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
Condição a posteriori
Os registros do CURSO para Course.1.1.SP2013 e Course.1.2.SP2013 são reter e não são afetados.
O registro COURSE para Course.2.1.SP2013 é marcado como desabilitado ou pronto para exclusão de acordo com a configuração de integração.
Se outros registros do CURSO forem gerenciados por essa integração, eles NÃO serão desabilitados ou excluídos devido à sua ausência no feed de dados acima, a menos que tenham a mesma fonte de dados especificada pela integração.
Disponibilidade do curso
Atenção
Observe que o envio de um arquivo pequeno corretivo com a operação Atualização completa ou Atualização completa por fonte de dados pode causar inadvertidamente a exclusão ou desabilitação em massa de dados. Para evitar isso, desencorajamos o uso manual dos tipos de operação Atualização Completa ou Atualização Completa por Fonte de Dados. Por padrão, essas opções não estão disponíveis na página Carregar arquivo de feed. No entanto, se você habilitar ambas as opções, marque a caixa de seleção Habilitar opções avançadas em Tipo de operação.
A configuração de disponibilidade do curso permite que uma conta do LEARN fique visível aos alunos (disponível) ou não visível (não disponível). Observe que isso não é o mesmo que desabilitar um curso, o que não apenas torna o curso indisponível para Alunos e instrutores, mas também significa que ele não está disponível para operações adicionais, como gerenciamento de membros. A adição desse cabeçalho do feed de dados não afeta o uso acima demonstrado de armazenamento, atualização completa, atualização completa pela fonte de dados para criar registros do curso.
Observe as configurações de integração padrão quando uma configuração de disponibilidade não é fornecida para que o objeto seja disponibilizado em operações de criação/atualização.
Exemplo: Disponibilidade da conta do curso
Seu Sistema de informações do aluno (SIA) controla a disponibilidade de acesso do LEARN e o feed de dados indica a configuração de disponibilidade dos usuários para controlar quando eles têm acesso ao Blackboard e você deseja controlar essa configuração de acesso na criação/atualização de PESSOA.
Pré-requisito
Nenhum.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
AVAILABILITY_IND
Solução
Adicione o cabeçalho AVAILABLE_IND ao seu feed de dados e forneça o caractere único de Y para disponível e N para indisponível.
Condição a posteriori
Armazenamento
Somente os registros do CURSO para Curso.1.1.SP2013 e Curso.1.2.SP2013 são atualizados (eles foram criados anteriormente) e Curso.5.1.FA2013 é criado.
Atualização completa
Os registros do CURSO para Curso.1.1.SP2013 e Curso.1.2.SP2013 são atualizados (eles foram criados anteriormente) e Curso.5.1.FA2013 é criado. Todos os outros registros serão desabilitados ou marcados para exclusão devido à sua ausência no feed de dados acima.
Atualização completa pela fonte de dados
Os registros do CURSO para Course.1.1.SP2013 e Course.1.2.SP2013 são atualizados (eles foram criados anteriormente) e Course.5.1.FA2013 é criado com disponibilidade explicitamente definida como Y disponibilizando os cursos.
Se outros registros do CURSO forem gerenciados por essa integração, eles NÃO serão desabilitados ou excluídos devido à sua ausência no feed de dados acima, a menos que tenham a mesma fonte de dados especificada pela integração. A atualização completa pela fonte de dados opera apenas nos registros da fonte de dados da integração.
Desativando registros de curso
A desabilitação de um registro CURSO no Blackboard o torna inacessível a todos os usuários (o status desabilitado substitui a configuração de disponibilidade) e também torna o registro inacessível para operações de interface do usuário – por exemplo: você não pode gerenciar a maioria das propriedades de um CURSO desabilitado por meio da interface do usuário. Os administradores do sistema podem visualizar e rehabilitar um curso desabilitado no painel do administrador do sistema, caso contrário: geralmente é "invisível". Além disso, para excluir um registro do Blackboard, esse registro deve primeiro ser desabilitado.
Nota
A desabilitação de um registro e a exclusão subsequente excluim todas as referências a esse registro do Blackboard – é recomendável que a exclusão de registros desabilitados ocorra somente após um período de tempo, conforme determinado por sua empresa e/ou práticas legais que, de outra forma, poderiam exigir um registro de atividade. Além disso: como um curso desabilitado não pode ser acessado, se as pessoas ainda precisarem de acesso, elas consultarão seu suporte técnico e a necessidade contínua será notada antes que seja tarde demais.
A desabilitação de registros pode seguir dois modelos: desabilitada pela exclusão de dados do feed em operações de ATUALIZAÇÃO e desabilitada pelo uso do ROW_STATUS do cabeçalho do feed.
Importante
As operações COURSE acima usando operações REFRESH demonstram a desabilitação 'implícita' por meio da exclusão, o caso e o exemplo a seguir demonstram isso por meio do uso de ROW_STATUS.
Exemplo: Desativando registros de curso
A política determina que você exclua totalmente os cursos do Blackboard após um período de 5 anos. Para se preparar para isso, você pode planejar desabilitar explicitamente o curso por um tempo usando o cabeçalho ROW_STATUS. Isso garante que ninguém ainda esteja contando com o curso, porque não poderá mais acessá-lo.
Pré-requisito
O curso existe ou será criado e row_status será definido conforme indicado no feed de dados.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
ROW_STATUS
Solução
Adicione o cabeçalho ROW_STATUS ao feed de dados e forneça ENABLED para habilitado e DISABLED para disabled.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|ROW_STATUS
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|enabled
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|enabled
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|disabled
Condição a posteriori
Armazenamento
Somente os registros do CURSO para Course.1.1.SP2013, Course.1.2.SP2013 e Course.5.1.FA2013 são criados ou atualizados com o ROW_STATUS explicitamente atualizado.
Atualização completa
Os registros do CURSO para Course.1.1.SP2013, Course.1.2.SP2013 e Course.5.1.FA2013 são criados ou atualizados com o ROW_STATUS explicitamente atualizado. Todos os outros registros de curso pertencentes a esta integração serão desabilitados ou marcados para exclusão devido à sua ausência no feed de dados acima.
Atualização completa pela fonte de dados
Os registros do CURSO para Course.1.1.SP2013, Course.1.2.SP2013 e Course.5.1.FA2013 são criados ou atualizados, com o ROW_STATUS explicitamente atualizado.
Se outros registros do CURSO forem gerenciados por essa integração, eles NÃO serão desabilitados ou excluídos devido à sua ausência no feed de dados acima, a menos que tenham a mesma fonte de dados especificada pela integração. A atualização completa pela fonte de dados opera apenas nos registros da fonte de dados da integração.
Mesclagem de cursos
A Mesclagem de cursos oferece a capacidade de apresentar várias seções de um curso como um único curso no Blackboard. Isso é realizado ao mesclar os cursos em relações principal-secundário. O principal é apresentado aos usuários como o curso no qual eles são participantes e as seções/cursos secundários assumem as associações, etc. Os instrutores só precisam fornecer conteúdo para um único curso e o sistema Blackboard mantém um emparelhamento com o Sistema de informações do aluno (SIA) em relação aos identificadores do curso, coordenando a comunicação de informações relacionadas ao curso entre o Blackboard e o Sistema de informações do aluno (SIA).
Exemplo: Mesclagem de curso
O departamento de inglês tem quatro cursos de nível de entrada que exigem várias seções cada para acomodar a proporção desejada de alunos ao instrutor. Eles desejam fornecer um único curso para que os instrutores façam o gerenciamento.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
MASTER_COURSE_KEY
Solução
Adicione o cabeçalho ROW_STATUS ao feed de dados e forneça ENABLED para habilitado e DISABLED para disabled.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|MASTER_COURSE_KEY
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|testCourse1
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Deixar MASTER_COURSE_KEY vazio significa que não há um "pai" para o curso ou colocar outra forma de o curso não ser mesclado com um curso principal.
Condição a posteriori
Armazenamento
Somente os registros do CURSO para Curso.1.1.SP2013, Curso.1.2.SP2013 e Curso.5.1.FA2013 são criados ou atualizados, estabelecendo uma relação pai-filho entre Curso.1.1.SP2013 (pai) e Curso.1.2.SP2013.
Atualização completa
Os registros do CURSO para Course.1.1.SP2013, Course.1.2.SP2013 e Course.5.1.FA2013 são criados ou atualizados, estabelecendo uma relação pai-filho entre Course.1.1.SP2013 (pai) e Course.1.2.SP2013. Todos os outros registros de curso pertencentes a esta integração serão desabilitados ou marcados para exclusão devido à sua ausência no feed de dados acima.
Atualização completa pela fonte de dados
Os registros do CURSO para Course.1.1.SP2013, Course.1.2.SP2013 e Course.5.1.FA2013 são criados ou atualizados, estabelecendo uma relação pai-filho entre Course.1.1.SP2013 (pai) e Course.1.2.SP2013.
Se outros registros do CURSO forem gerenciados por essa integração, eles NÃO serão desabilitados ou excluídos devido à sua ausência no feed de dados acima, a menos que tenham a mesma fonte de dados especificada pela integração. A atualização completa pela fonte de dados opera apenas nos registros da fonte de dados da integração.
Modelo de curso
Os modelos de cursos são usados no momento em que o curso é criado para fornecer consistência na aparência, nos boletins de notas, na estrutura de conteúdo, etc. Um curso criado usando um modelo é um espelho desse modelo com exceção das configurações específicas do curso, conforme apresentado no feed de dados. Você pode usar qualquer curso para essa finalidade.
Importante
Os modelos são usados apenas quando um curso é criado. Para criar um curso e fornecer um modelo por meio de um feed de atualização, você pode fazer isso definindo Administração do sistema → Sistema de informações do aluno (SIA) → (sua integração) ⧩ → Configuração avançada → cursos ⧩ → Mapeamento de campo → Chave de cópia do curso de origem e marcando a caixa de seleção Alterar na atualização (que não está marcada por padrão).
Exemplo: Modelo de curso
Atenção
Observe que o envio de um arquivo pequeno corretivo com a operação Atualização completa ou Atualização completa por fonte de dados pode causar inadvertidamente a exclusão ou desabilitação em massa de dados. Para evitar isso, desencorajamos o uso manual dos tipos de operação Atualização Completa ou Atualização Completa por Fonte de Dados. Por padrão, essas opções não estão disponíveis na página Carregar arquivo de feed. No entanto, se você habilitar ambas as opções, marque a caixa de seleção Habilitar opções avançadas em Tipo de operação.
O Departamento de Matemática exige que todos os cursos de matemática tenham uma aparência semelhante, com um layout de conteúdo semelhante e preenchidos com algum conteúdo principal.
Pré-requisito
Foi criado um ambiente de curso para testes que contém o conteúdo, o layout e as configurações necessárias.
Requisitos mínimos do feed de dados
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
TEMPLATE_COURSE_KEY
Solução
Adicione o cabeçalho TEMPLATE_COURSE_KEY ao seu feed de dados e forneça a external_course_key do curso que representa o modelo.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|TEMPLATE_COURSE_KEY
testCourse1|Course.6.1.SP2013|Test Course 1.1 (SP2013)|testCourseTemplate.SP2013
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Deixar TEMPLATE_COURSE_KEY vazio significa que o curso não exige um modelo.
Condição a posteriori
Armazenamento
Somente o registro COURSE para Course.6.1.SP2013 e Course.5.1.FA2013 é criado ou atualizado, com Course.6.1.SP2013 sendo criado usando o modelo testCourseTemplate.SP2013.
Atualização completa
Somente o registro COURSE para Course.6.1.SP2013 e Course.5.1.FA2013 é criado ou atualizado, com Course.6.1.SP2013 sendo criado usando o modelo testCourseTemplate.SP2013. Todos os outros registros serão desabilitados ou marcados para exclusão devido à sua ausência no feed de dados acima.
Atualização completa pela fonte de dados
Somente o registro COURSE para Course.6.1.SP2013 e Course.5.1.FA2013 é criado ou atualizado, com Course.6.1.SP2013 sendo criado usando o modelo testCourseTemplate.SP2013.
Se outros registros do CURSO forem gerenciados por essa integração, eles NÃO serão desabilitados devido à sua ausência no feed de dados acima, a menos que tenham a mesma fonte de dados especificada pela integração. A atualização completa pela fonte de dados opera apenas nos registros da fonte de dados da integração.
Exemplo completo
Combinando os cabeçalhos acima em um único arquivo, podemos abordar a maioria dos casos de uso de uma só vez.
Pré-requisito
Para que a operação de cópia do modelo seja bem-sucedida, testCourse8 não deve ter sido criado anteriormente.
Nota
Para manter a velocidade do servidor e evitar a carga desnecessária do banco de dados, há um limite no número de tarefas de cópia controladas pelo Sistema de informações do aluno (SIA) que podem ser executadas simultaneamente no grupo. Você pode exibir o status dessas tarefas em Registros de → de Administração do Sistema → Status da Tarefa do Sistema
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|AVAILABLE_IND|ROW_STATUS|MASTER_COURSE_KEY|TEMPLATE_COURSE_KEY
testCourse8|Course.8.SP2013|Test Course 8 (SP2013)|Y|ENABLED||testCourseTemplate.SP2013
testCourse8.1|Course.8.1.SP2013|Test Course 8.1 (SP2013)|Y|ENABLED|testCourse8|
testCourse8.1|Course.8.1.SP2013|Test Course 8.1 (SP2013)|Y|ENABLED|testCourse8|
testCourse9.1|Course.9.1.FA2013|Test Course 5.2 (FA2013)|Y|DISABLED||
Condição a posteriori
Armazenamento
Somente os registros do CURSO para Course.1.1.SP2013, Course.1.2.SP2013 e Course.5.1.FA2013 são criados ou atualizados com os seguintes resultados:
Todos os cursos têm disponibilidade definida como Y, indicando que os cursos estão disponíveis.
Course.1.1.SP2013 e Course.1.2.SP2013 são definidos como ENABLED, enquanto Course.5.1.FA2013 é DISABLED.
Estabeleça uma relação pai-filho entre Curso.1.1.SP2013 (pai) e Curso.8.1.SP2013 e Curso.8.2.SP2013.
Ao criar Course.8.SP2013, o conteúdo e as configurações do modelo testCourseTemplate.SP2013 são copiados para Course.8.SP2013.
Atualização completa
Os mesmos resultados da operação de armazenamento com a adição de que todos os outros registros serão desabilitados ou marcados para exclusão devido à sua ausência no feed de dados.
Atualização completa pela fonte de dados
Os mesmos resultados da operação de armazenamento com a adição de que, se outros registros COURSE forem gerenciados por essa integração, eles NÃO serão desabilitados devido à sua ausência no feed de dados acima, a menos que tenham a mesma fonte de dados especificada pela integração. A atualização completa pela fonte de dados opera apenas nos registros da fonte de dados da integração.