Skip to main content

Configurar LTIs

Configuração de propriedades globais para novos domínios

Esta configuração global se aplica somente à LTI 1.1. Se você quiser personalizar as configurações individuais, poderá fazê-lo adicionando um novo Provedor de ferramentas.

  1. No Painel do Administrador, em Integração, clique em Provedores de ferramentas de LTI.

  2. Clique em Gerenciar propriedades globais.

  3. Em Disponibilidade de recursos, clique na Geração de links de provedores de ferramentas de sua preferência:

    • Permitir o uso de links para qualquer provedor de ferramentas que não esteja explicitamente excluídopermite que os instrutores adicionem links de LTI a qualquer domínio que o administrador não tenha bloqueado especificamente ao gerenciar provedores de ferramentas de LTI.

    • Permitir links para qualquer provedor de ferramentas, mas exigir aprovação para cada novo provedor permite que os instrutores adicionem links de LTI mas, se for um novo domínio, ele terá de ser aprovado pelo administrador.

    • Permitir links somente para provedores de ferramentas aprovados não permitirá que os instrutores adicionem links de LTI, a menos que o administrador já tenha aprovado o domínio.

  4. Clique para definir se vai permitir que qualquer provedor de ferramentas publique notas no Centro de Notas. Esta configuração global se aplica somente à LTI 1.1. Na LTI 1.3, a avaliação é feita conforme a base da ferramenta.

    • Quando essa configuração global estiver habilitada, as notas publicadas por provedores de ferramentas LTI serão aceitas, Blackboard mas somente em colunas do Centro de Notas criadas por colocações de provedores de ferramentas em cursos.

    • Para que um Provedor de ferramentas aproveite essa configuração, ela deve ser configurada com uma colocação que permita a avaliação.

  5. Na seção de Configuração padrão, defina as opções globais para os dados do usuário e a mensagem de confirmação do usuário.

    • Por motivos de segurança, recomendamos fortemente a opção de Enviar dados do usuário somente por SSL. Esta configuração é exclusiva da LTI 1.1. Na LTI 1.3, é necessária uma conexão SSL (TLS 2).

    • Se você clicar em Nunca, todas as opções de Campos de usuário para envio serão desmarcadas.

    • Se você clicar em Enviar dados do usuário somente por SSL ou Enviar dados do usuário por qualquer conexão, os Campos do usuário a serem enviados terão três campos pré-selecionados que você pode personalizar com base nas políticas de privacidade da sua instituição: Função no curso, Nome e Endereço de e-mail.

    • Ao clicar em Sim na seção Permitir acesso ao serviço para membros, a ferramenta pode solicitar todos ou qualquer subconjunto de usuários em um curso (instrutores e alunos). Se você clicar em Não, a ferramenta não poderá acessar essas informações e a opção Mostrar mensagem de confirmação do usuário estará disponível. Se clicar em Sim nessa opção, você pode mostrar uma mensagem personalizada para os usuários, por exemplo: "Você está prestes a abrir uma ferramenta LTI de terceiros".

    • Clique em Enviar para definir as propriedades globais.

Versões de LTIs

Existem duas versões da LTI: v1.1 e v1.3. Cada versão requer etapas de configuração diferentes. Antes de adicionar uma ferramenta LTI, certifique-se de que sabe a versão à qual ela pertence.

A LTI v1.0 é muito semelhante à também obsoleta LTI v1.1, mas sem o recurso de retornar as informações das avaliações. Se você estiver adicionando um recurso LTI v1.0, registre-o como LTI v1.1.

A versão atual é LTI v1.3. A maior diferença em relação às versões anteriores é o modelo de segurança atualizado baseado em tokens da web OAuth2, OpenID Connect e JSON. Há também a LTI Advantage, um pacote de novos serviços de extensões criados na parte superior da LTI v1.3 que evoluem fora da especificação da LTI.

Adicione um provedor de ferramentas de LTI 1.1

  1. No Painel do Administrador, em Integrações, clique em Provedores de ferramentas de LTI.

  2. Clique em Registrar provedor de LTI 1.1.

  3. Digite o Domínio do provedor, p. ex. www.example.com.

  4. Clique no Status do domínio do provedor – Aprovado ou Excluído.Aprovado é a configuração padrão. Clicar em Excluído impede que os usuários adicionem links de LTI de um provedor de ferramentas.

  5. Como opção, informe quaisquer Nomes de hosts secundários para o provedor. O provedor pode fornecer essa informação.

  6. Verifique com o provedor se ele permite a configuração em todo o site ou cada link e clique na Configuração padrão apropriada. Para Definir globalmente, digite a Chave do provedor de ferramentas e o Segredo do provedor de ferramentas. Deixar a Configuração padrão como Definir separadamente para cada link requer que os usuários digitem a Chave e o Segredo ao criar cada link. Qualquer escolha que você fizer para o provedor individual substituirá as Propriedades globais.

  7. Adicione os parâmetros personalizados exigidos pelo provedor de ferramentas na caixa de texto Parâmetros personalizados do provedor da ferramenta.

    • Cada parâmetro deve estar na própria linha.

    • Eles devem ser formatados como um par "nome=valor".

    • Eles podem ser variáveis de substituição. Por exemplo:

      userNameLTI=$User.username

      useridLTI=$User.id

      userEmailLTI=$Person.e-mail.primary

    • Eles também podem ser variáveis de modelo. Essas variáveis são resolvidas utilizando dados do Blackboard em seu formato de parâmetro @x@user.full_name@x@. Por exemplo:

      crsRoleLrn=@X@membership.role@X@

      course_pl=@X@course.pk_string@X@

  8. A seção de Políticas da instituição obtém as preferências das Propriedades globais. Aqui você pode gerenciar as configurações individuais.

    • Por motivos de segurança, recomendamos fortemente a opção de Enviar dados do usuário somente por SSL.

    • Se você clicar em Nunca, todas as opções de Campos de usuário para envio serão desmarcadas.

    • Se você clicar em Enviar dados do usuário somente por SSL ou Enviar dados do usuário por qualquer conexão, os Campos de usuário para enviar exibirão três campos pré-selecionados que você pode personalizar com base nas políticas de privacidade da sua instituição:

      Função no curso, Nome e Endereço de e-mail.

    • Ao clicar em Sim na seção Permitir acesso ao serviço para membros, a ferramenta pode solicitar todos ou qualquer subconjunto de usuários em um curso (instrutores e alunos). Se você clicar em Não, a ferramenta não poderá acessar essas informações e a opção Mostrar mensagem de confirmação do usuário estará disponível. Se clicar em Sim nessa opção, você pode mostrar uma mensagem personalizada para os usuários, por exemplo: "Você está prestes a abrir uma ferramenta LTI de terceiros".

  9. Clique em Enviar para adicionar a ferramenta LTI 1.1.

Adicionar uma ferramenta LTI 1.3/Advantage

  1. No Painel do Administrador, em Integrações, clique em Provedores de ferramentas de LTI.

  2. Clique em Registrar a ferramenta LTI 1.3/Advantage.

  3. Digite o código do cliente ou o código do aplicativo informado pelo fornecedor da ferramenta. Se estiver desenvolvendo seu próprio aplicativo, você pode se registrar no Portal do desenvolvedor e registrar o aplicativo para obter o código do cliente.

    • Algumas ferramentas de LTI trabalham com o serviço de Registro dinâmico para simplificar o processo de registro, se os administradores precisarem registrar a ferramenta por conta própria. Se uma ferramenta usar o Registro dinâmico, clique em Registro dinâmico na página Meus aplicativos. Digite a URL de registro informada pelo provedor da ferramenta e siga as etapas exigidas pelo provedor da ferramenta.

  4. Clique em Enviar. As definições de configuração do aplicativo no Portal do desenvolvedor serão exibidas na página.

  5. Os campos são somente leitura, mas você pode definir o status da ferramenta como Aprovada ou Excluída.

  6. A seção de Políticas da instituição obtém as preferências das Propriedades globais. Aqui você pode gerenciar as configurações do provedor individual ativando ou desativando as caixas de seleção Campos de usuário a serem enviados: Função no curso, Nome e Endereço de e-mail. Você também pode permitir ou não permitir o acesso ao serviço de notas por ferramenta.

  7. Ao clicar em Sim na seção Permitir acesso ao serviço para membros, a ferramenta pode solicitar todos ou qualquer subconjunto de usuários em um curso (instrutores e alunos). Se você clicar em Não, a ferramenta não poderá acessar essas informações e a opção Mostrar mensagem de confirmação do usuário estará disponível. Ao clicar em Sim nessa opção, você pode mostrar uma mensagem personalizada aos usuários, por exemplo: "Você está prestes a abrir uma ferramenta LTI de terceiros".

  8. Qualquer escolha que você fizer para o provedor individual substituirá as Propriedades globais.

  9. Clique em Enviar para adicionar a ferramenta LTI 1.3/Advantage.

Configuração de colocações: onde as ferramentas LTI são exibidas

Depois de adicionar um Provedor de ferramentas LTI, você pode configurar uma Colocação para facilitar a localização e o uso da ferramenta na interface do usuário do Blackboard. Um fornecedor de ferramentas pode definir todas as colocações para ferramentas de LTI 1.3.

Se a Colocação não estiver configurada, os alunos e instrutores deverão saber a URL ou a chave secreta se quiserem usar a ferramenta nos cursos, conforme descrito em Ferramentas de ensino via conexão de LTI .Adicionar conteúdo de fontes externas

Como fazer uma Colocação

  1. Em Provedores de ferramentas LTI em Ferramentas do administrador, acesse o provedor de ferramentas que quiser configurar e clique na opção de menu exibida ao lado do domínio. Acesse Gerenciar colocações.

  2. Clique em Fazer colocação.

  3. Digite um Rótulo. Esse é o nome exibido para os usuários em um curso.

  4. Adicione uma descrição se a ferramenta for exibida para os alunos no respectivo menu de Ferramentas. As descrições não são exibidas para os instrutores.

  5. Digite um Identificador. Ele deve ser exclusivo e só pode conter caracteres alfanuméricos, sublinhado ou travessão.

  6. Para disponibilizar ou indisponibilizar a colocação, clique em Sim ou Não.

  7. Selecione um Tipo:

    Nota

    Não é possível alterar o tipo de colocação de uma colocação existente. É preciso fazer uma nova colocação para alterar o tipo.

    • Ferramenta de conteúdo de links profundos: Permita que instrutores e desenvolvedores de cursos abrirem a ferramenta LTI e adicionem conteúdo do provedor da ferramenta, em vez de adicionar conteúdo por meio da Blackboard interface. Se o provedor de ferramentas estiver configurado de modo que o instrutor possa selecionar várias partes do conteúdo em uma única importação, essa ferramenta poderá poupar tempo e simplificar o fluxo de trabalho.

      • Permitir acesso do aluno: dê permissão aos alunos para também adicionarem conteúdo do provedor da ferramenta.

    • Ferramenta de conteúdo do curso: Permita que os instrutores adicionem a ferramenta à página de conteúdo do curso. Depois de adicionar por meio da seção Content Market, a ferramenta se torna parte do conteúdo programático.

      • Permitir a avaliação: Permita que os instrutores adicionem recursos de avaliação, como a data de entrega e os pontos possíveis, à ferramenta.

    • Ferramenta do curso: A ferramenta é exibida para instrutores e desenvolvedores de cursos na seção de gerenciamento do curso de um curso Original e no menu de Livros e ferramentas de um curso Ultra.

      • Permitir acesso do aluno: Quando selecionado, o aluno pode acessar a ferramenta no menu Ferramentas do aluno. Adicione uma descrição para ajudar o aluno a entender o que é a ferramenta e o que ela faz.

    • Uma Ferramenta de sistema pode ser aberta sem ter de acessar um curso. Na experiência Original, a ferramenta é exibida no menu Ferramentas da guia Minha instituição. Na experiência Ultra, a ferramenta é exibida na seção de Ferramentas da navegação de base. Você também pode colocar uma Ferramenta de sistema em um módulo da Página da instituição.

    • Uma ferramenta de Administrador permite que administradores adicionem a ferramenta ao menu Ferramentas e utilitários no Painel do Administrador.

    • As colocações de Extensão do Ultra são para determinadas integrações. Use essa colocação somente quando orientado pelo provedor de integração. Não use essa colocação se não for exigida pela integração.

    • A Ferramenta de monitoramento, a Ferramenta de navegação de base e a Ferramenta de navegação do curso são exclusivas da LTI 1.3/Advantage, definidas pelo provedor de ferramentas, que você pode acessar, mas não pode modificar.

  8. Marque a caixa de seleção se quiser que a ferramenta seja aberta em uma nova janela em vez de um iframe.

  9. Adicione um ícone para a ferramenta clicando em Navegação e envie um arquivo de imagem de 50 x 50 pixels. Se essa colocação de LTI estiver em um curso com a visualização Original do curso, o ícone será exibido com o link na lista de Ferramentas. Na visualização Ultra do curso, o ícone é exibido com o link no Content Market, mas não na página de Conteúdo do curso.

  10. Digite as informações do provedor da ferramenta. Na maioria dos casos, são as mesmas informações que você adicionou quando criou a ferramenta, a menos que esteja criando várias colocações para o mesmo provedor registrado.

  11. Clique em Enviar.

Atenção

A exclusão de um domínio ou a colocação da LTI corromperá todos os links de LTI existentes. Se o mesmo domínio ou colocação de LTI forem adicionados novamente, os links corrompidos não serão reparados. Não exclua uma colocação ou domínio de LTI a menos que tenha certeza de que nunca mais o utilizará.

Para migrar uma ferramenta LTI 1.1 para a LTI 1.3, crie a nova ferramenta LTI com o mesmo domínio e aceite o aviso para migrar para a LTI 1.3. Assim as questões de segurança dos links existentes serão solucionadas.

Gerenciamento do acesso e da visibilidade da ferramenta

Os cursos da visualização Original do curso continuam permitindo que os instrutores substituam o status de disponibilidade das ferramentas, se for permitido. A disponibilidade da ferramenta nos cursos da visualização Ultra do curso é sempre gerenciada pelo administrador.

  1. No Painel do Administrador, em Ferramentas e utilitários, clique em Ferramentas.

  2. Pesquise a ferramenta que quiser ativar ou desativar. Você encontrará uma lista de ferramentas internas, ferramentas de Building Block e ferramentas de LTI que podem ser filtradas por tipo.

  3. Em Disponibilidade, clique em ATIVO ou INATIVO.

  4. Você também pode aplicar as alterações aos Cursos novos do Original e a todos os cursos do Ultra ou aos Cursos novos e existentes.

  5. Clique em Enviar.