Configuração do MySQL para Recursos de Ativação

O MySQL é um banco de dados relacional usado principalmente para rastreamento e relatórios de dados SCORM para recursos de capacitação. Inclui tabelas para outros recursos, como rastreamento de pausa/retomada de vídeo.

Essas instruções descrevem como se conectar ao servidor MySQL, estabelecer o banco de dados de ativação e preencher o banco de dados com dados iniciais.

Requisitos

Antes de configurar o recurso de ativação do MySQL for Communities, certifique-se de

• Instale o MySQL server Community Server versão 5.6:
  • A versão 5.7 não é compatível com SCORM.
  • Pode ser o mesmo servidor que a instância do autor AEM.
• Em todas as instâncias AEM, instale o driver JDBC oficial para MySQL.
• Instale o MySQL workbench.
• Em todas as instâncias AEM, instale o pacote SCORM.

Instalando o MySQL

O MySQL deve ser baixado e instalado de acordo com as instruções para o SO de destino.

Nomes de tabela em minúsculas

Como o SQL não diferencia maiúsculas de minúsculas, para sistemas operacionais que diferenciam maiúsculas de minúsculas, é necessário incluir uma configuração para minúsculas todos os nomes de tabela.

Por exemplo, para especificar todos os nomes de tabela de letras minúsculas em um sistema operacional Linux:

• Editar arquivo /etc/my.cnf
• Na seção [mysqld] , adicione a seguinte linha: lower_case_table_names = 1

Conjunto de caracteres UTF8

Para oferecer um melhor suporte multilíngue, é necessário usar o conjunto de caracteres UTF8.

Altere MySQL para ter UTF8 como seu conjunto de caracteres:

• mysql > DEFINIR NOMES 'utf8';

Altere o banco de dados MySQL para UTF8:

• Editar arquivo /etc/my.cnf
• Na seção [client] , adicione: default-character-set=utf8
• Na seção [mysqld] , adicione: character-set-server=utf8

Instalar o MySQL Workbench

O MySQL Workbench fornece uma interface para executar scripts SQL que instalam o esquema e os dados iniciais.

O MySQL Workbench deve ser baixado e instalado seguindo as instruções para o SO de destino.

Habilitar conexão

Quando o MySQL Workbench é iniciado pela primeira vez, a menos que já esteja em uso para outros fins, ele ainda não mostrará conexões:

Novas configurações de conexão

1. Selecione o ícone "+" à direita de MySQL Connections.
2. Na caixa de diálogo Setup New Connection, insira valores adequados para sua plataforma para fins de demonstração, com a instância de AEM do autor e o MySQL no mesmo servidor:
   • Nome da conexão: Enablement
   • Método de conexão: Standard (TCP/IP)
   • Nome do host: 127.0.0.1
   • Nome de usuário: root
   • Senha: no password by default
   • Esquema padrão: leave blank
3. Selecione Test Connection para verificar a conexão com o serviço MySQL em execução.

Notas:

• A porta padrão é 3306.
• O Connection Name escolhido é inserido como o nome datasource em Configuração JDBC OSGi.

Conexão bem-sucedida

Nova conexão de ativação

Configuração do banco de dados

Ao abrir a nova conexão de Ativação, observe que há um esquema de teste e contas de usuário padrão.

Obter Scripts SQL

Os scripts SQL são obtidos usando o CRXDE Lite na instância do autor. O pacote SCORM deve ser instalado:

1. Navegue até CRXDE Lite:
   • Por exemplo, http://localhost:4502/crx/de
2. Expanda a pasta /libs/social/config/scorm/
3. Download database_scormengine.sql
4. Baixar database_scorm_integration.sql

Um método para baixar o schema é:

• Selecione o nó jcr:content para o arquivo sql.
• Observe que o valor da propriedade jcr:data é um link de exibição.
• Selecione o link de exibição para salvar os dados em um arquivo local.

Criar Banco de Dados SCORM

O Banco de Dados SCORM de Ativação a ser criado é:

• name: ScormEngineDB
• criado a partir de scripts:
  • esquema: database_scormengine.sql
  • dados: database_scorm_integration.sql
    Siga as etapas abaixo (
    abra, execute) para instalar cada script SQL . 🔗 Atualize quando necessário para ver os resultados da execução do script.

Certifique-se de instalar o esquema antes de instalar os dados.

Etapa 1: abrir arquivo SQL

No MySQL Workbench

• No menu suspenso Arquivo
• Selecionar Open SQL Script ...
• Nesta ordem, selecione um dos seguintes:
  1. database_scormengine.sql
  2. database_scorm_integration.sql

Etapa 2: executar script SQL

Na janela do Workbench para o arquivo aberto na Etapa 1, selecione o lightening (flash) icon para executar o script.

Observe que a execução do script database_scormengine.sql para criar o banco de dados SCORM pode levar um minuto para ser concluída.

Atualizar

Depois que os scripts são executados, é necessário atualizar a seção SCHEMAS do Navigator para visualizar o novo banco de dados. Use o ícone de atualização à direita de 'SCHEMAS':

Resultado: scormenginedb

Após instalar e atualizar o SCHEMAS, o scormenginedb estará visível.

Configurar conexões JDBC

A configuração OSGi para Day Commons JDBC Connections Pool configura o driver JDBC do MySQL.

Todas as instâncias de publicação e criação de AEM devem apontar para o mesmo servidor MySQL.

Quando o MySQL é executado em um servidor diferente de AEM, o nome do host do servidor deve ser especificado no lugar de 'localhost' no conector JDBC (que preenche a configuração ScormEngine).

• Em cada autor e publicar AEM instância

• Conectado com privilégios de administrador

• Acesse o console da Web

  • Por exemplo, http://localhost:4502/system/console/configMgr

• Localize o Day Commons JDBC Connections Pool

• Selecione o ícone + para criar uma nova configuração

  

• Insira os seguintes valores:

  • Classe de driver JDBC: com.mysql.jdbc.Driver
  • URIJ de conexão DBC: jdbc:mysql://localhost:3306/aem63reporting especifique o servidor no lugar de localhost se o servidor MySQL não for o mesmo que 'this' AEM server.
  • Nome de usuário: Raiz ou insira o nome de usuário configurado para o servidor MySQL, se não for 'root'.
  • Senha: Limpe este campo se não houver senha definida para o MySQL, caso contrário, insira a senha configurada para o Nome de Usuário do MySQL.
  • Nome da fonte de dados: Nome inserido para a conexão MySQL, por exemplo, "ativação".

• Selecione Salvar.

Configurar Scorm

Serviço do AEM Communities ScormEngine

A configuração do OSGi para AEM Communities ScormEngine Service configura o SCORM para o uso do servidor MySQL pela comunidade de ativação.

Essa configuração está presente quando o pacote SCORM está instalado.

Todas as instâncias de publicação e criação apontam para o mesmo servidor MySQL.

Quando o MySQL é executado em um servidor diferente de AEM, o nome do host do servidor deve ser especificado no lugar de 'localhost' no Serviço ScormEngine, que normalmente é preenchido a partir da configuração JDBC Connection.

• Em cada autor e publicar AEM instância

• Conectado com privilégios de administrador

• Acesse o console da Web

  • Por exemplo, http://localhost:4502/system/console/configMgr

• Localize o AEM Communities ScormEngine Service

• Selecione o ícone de edição

  

• Verifique se os seguintes valores de parâmetro estão consistentes com a configuração JDBC Connection:

  • URI de conexão JDBC: jdbc:mysql://localhost:3306/ScormEngineDB ** ScormEngineDBé o nome padrão do banco de dados nos scripts SQL
  • Nome de usuário: Raiz ou insira o nome de usuário configurado para o servidor MySQL, se não for 'root'
  • Senha: Limpar este campo se não houver senha definida para o MySQL, caso contrário, introduzir a senha configurada para o nome de utilizador do MySQL

• Em relação ao seguinte parâmetro:

  • Senha do usuário do Scorm: NÃO EDITAR

    Apenas para uso interno: É para um usuário de serviço especial usado pelo AEM Communities para se comunicar com o mecanismo de pontuação.

• Selecione Salvar

Filtro CSRF do Adobe Granite

Para garantir que os cursos de ativação funcionem corretamente em todos os navegadores, é necessário adicionar o Mozilla como Agente de usuário que não é verificado pelo filtro CSRF.

• Faça logon na instância de publicação do AEM com privilégios de administrador.

• Acesse o console da Web

  • Por exemplo, http://localhost:4503/system/console/configMgr

• Localize Adobe Granite CSRF Filter.

• Selecione o ícone de edição.

  

• Selecione o ícone [+] para adicionar um Agente de Usuário Seguro.

• Insira Mozilla/*.

• Selecione Salvar.