Configuração de conectores

Para integrar dados no SAP SuccessFactors Learning, um processo específico deve ser seguido para garantir uma transferência de dados perfeita e segura. Este processo envolve:

1. Gerar um arquivo executando uma consulta no sistema de origem.
2. Carregar o arquivo para um local SFTP seguro.
3. Configurar o Learning Management System (LMS) para saber onde o arquivo está localizado e especificar as regras que devem ser aplicadas a ele.
4. Programação do LMS para recuperar automaticamente o arquivo do local do SFTP e importar os dados para seu banco de dados.

Para transferir dados do usuário do SAP SuccessFactors HCM para o Learning Management System (LMS), siga estas etapas:

1. Criar um job escalonado: em Disponibilização, configure um job escalonado que exporte dados do empregado do HCM. Este job criará um arquivo contendo os dados do usuário.
2. Salvar o arquivo: o job salvará o arquivo em um local específico.
3. Configurar o LMS: configure o LMS para recuperar regularmente o arquivo do local designado. Isso geralmente é feito todas as noites.
4. Importar os dados: o LMS importará os dados do usuário do arquivo para seu próprio banco de dados.

É importante observar que HCM e LMS têm bancos de dados separados. Um usuário no HCM pode não ser automaticamente um usuário no LMS. Seguindo este processo, você pode garantir que os dados do usuário são transferidos de HCM para LMS, conforme necessário.

Os conectores de programação na aplicação LMS requerem que a função ALL_CONNECTOR seja atribuída à conta do administrador do consultor ou parceiro que os programará. Além disso, eles devem ter a autorização Editar contida na função ALL_CONNECTOR.

O processo em si é composto por cinco etapas:

1. Configurar o arquivo de propriedade dos conectores
2. Criar o arquivo de entrada de dados
3. Carregar arquivos de dados
4. Programação
5. Validação de dados e solução de problemas

Em nosso ambiente de teste do LMS, precisamos configurar o arquivo de propriedade Conectores. Este arquivo contém configurações comuns para todos os conectores, bem como configurações específicas do conector individual.

Para começar a usar conectores, você precisa configurar o arquivo de propriedade Conectores.

1. Em Administração de aprendizagem, navegue paraSistema Administração→Configuração→Configuração do sistema e selecione o ícone Processar ao lado do arquivo de propriedade CONECTORES.
2. Copie todo o arquivo de propriedade e salve como um arquivo de texto local.

   Nota

   É uma prática recomendada copiar e colar o arquivo em seu editor de texto, como o Notepad++, e editar o arquivo em seu editor. Salve primeiro o arquivo não editado e o controle de versão.
3. Forneça as informações necessárias do sistema sobre onde encontrar o(s) arquivo(s) de dados carregado(s) e onde gerar um relatório de saída para download e e-mail. Conclua as atualizações necessárias para habilitar conectores. Abaixo está uma amostra das atualizações necessárias.
   • Local do arquivo FTP: /FEED/UPLOAD/XX/
   • Substituição de sufixo de inquilino LMS: TRAINXX
   • Ativar relatório de saída: connector.ftp.output.report.enable=true
   • Relatórios FTP para /FEED/DOWNLOAD/XX/
   • Relatórios de detalhes de e-mail: true, you@yourcompany.com

   Na captura de tela abaixo, as edições de amostra são destacadas em amarelo. Você precisará colocar o arquivo no local desejado indo para o local SFTP, para a pasta FEED, para a pasta UPLOAD e, em seguida, para a pasta correspondente com seu ID do locatário.

   
4. Insira as informações de login do SFTP para que o sistema possa acessar os arquivos de dados.

   Nota

   Essas informações de SFTP serão fornecidas aos clientes para suas próprias instâncias. Esta é uma informação de amostra (listada abaixo).
   • Porta SFTP: connector.ftp.server=sftp8.sapsf.com
   • Usuário FTP: kso-midmarket
   • Senha do FTP: krj09ufgdsf9ftg
   • Regras comerciais e mapeamento de dados específicos do conector – Recuperar da pasta de trabalho do conector.
   
5. Depois de editar o arquivo de propriedade no editor de texto, copie e cole o texto de volta na instância de treinamento e selecione Aplicar alterações para refletir as alterações.
6. Depois de salvar, a senha será criptografada quando você visualizar o arquivo de propriedade CONNECTORS no LMS.
7. Para ativar o arquivamento de arquivos de entrada, navegue até Administração do sistema→Conectores→Configurações do conector, marque o campo de seleção, insira o número de meses e selecione Aplicar alterações.

Ao criar os arquivos de entrada necessários para executar os conectores padrão, é responsabilidade do cliente criar um processo que consultará seu sistema de origem, produzir um arquivo e colocá-lo em um local SFTP. Às vezes, o arquivo de dados pode ser uma exportação de outro sistema, mas também podemos criar um manualmente.

Trabalhe com os gerentes de sistema para desenvolver essa exportação e automatizar o posicionamento no local do FTP. Ele precisa ser uma consulta em andamento para, em seguida, colocar esse arquivo no local do SFTP.

Para todos os arquivos de entrada do conector, os padrões do delimitador de coluna são canalizados com um delimitador de fim de linha de !##! por padrão. É possível modificá-los para outros valores, mas deve ser tomado cuidado para garantir que o tipo de valor ainda não esteja nos dados do cliente, o que causará problemas ao tentar importar o arquivo. Recomenda-se manter o padrão identificado no arquivo de propriedade do conector.

A convenção de nomes para cada arquivo de dados deve ser seguida exatamente. Por exemplo, para o Conector de usuário – SF, o nome do arquivo será user_data_train900.txt (em que train900 é o ID do locatário do cliente, conforme especificado no arquivo de propriedade CONNECTORS). É importante lembrar que a pasta de trabalho do conector é muito rígida sobre esta convenção de nomes. Se desviarmos dele e usarmos uma convenção de nomes diferente, todo o arquivo não será importado corretamente.

Para arquivos criados e exportados de outros sistemas, bem como arquivos criados manualmente, precisaremos fazer login no SFTP, navegar até a pasta UPLOAD e criar uma nova pasta com o ID do locatário. Depois de criados, outros sistemas podem precisar ser configurados para carregar seus arquivos de exportação para a pasta correta ou os arquivos de dados podem ser colocados manualmente na nova pasta.

1. Faça login no servidor SFTP navegando até o URL especificado no arquivo de propriedade CONNECTORS e usando o ID e o login fornecidos ao cliente.

   Por exemplo, abra o URL para o site SFTP em um navegador: sftp8.sapsf.com e use as informações de login de amostra, como visto na figura abaixo.

   

   Nota

   A senha aparecerá criptografada no arquivo para que você não consiga recuperá-la a partir daí.
2. Navegue para a pasta FEED e, em seguida, para a subpasta UPLOAD e adicione uma nova pasta com o ID de inquilino da empresa. Para nosso exemplo, usamos TRAIN900.
3. Em sua nova pasta, use o botão Carregar para adicionar seus arquivos de dados, como os criados para administradores e conectores de item.
4. Verifique se os arquivos têm os nomes de arquivo corretos, conforme especificado na pasta de trabalho de conectores.

   Nota

   Assim que o arquivo de dados for carregado com sucesso no site FTP e o processo de conector programado for executado, retornar à pasta da empresa Upload de FTP mostrará que o arquivo carregado foi arquivado. Se houver alterações no arquivo de dados, o administrador precisará recarregá-lo para a empresa Upload de FTP e programar a execução do arquivo do conector novamente.

Uma vez que o arquivo de propriedade CONNECTORS tenha sido configurado corretamente, um arquivo de entrada de amostra criado e colocado no local desejado dentro da estrutura de pastas SFTP, a próxima etapa é agendar os conectores. Isso acionará o conector para recuperar o arquivo do local do SFTP e importá-lo para o banco de dados LMS.

1. Navegue até Administração de aprendizagem→Administração do sistema→Conectores e localize o conector específico que você deseja programar. Neste exemplo, programaremos o conector de administrador.
2. É uma prática recomendada testar a conexão FTP antes de programar um conector pela primeira vez. Selecione o botão Testar conexão FTP. Em alguns momentos, as marcas de seleção devem aparecer ao lado de cada teste. Se um teste falhar, você pode precisar solucionar e corrigir o problema.
3. Marque o campo de seleção ao lado de Programar este processo e selecione Diariamente e uma hora do dia. Você também pode inserir um Endereço de e-mail que receberá um arquivo de log sempre que esse conector for executado.

   Normalmente, os clientes programarão conectores para serem executados à noite, mas, para este exemplo e como o conector está sendo testado pela primeira vez, ele está programado para alguns minutos a partir da hora atual. Selecione Aplicar alterações e confirme que o campo Próxima execução da tarefa mostra a data e a hora inseridas.

4. Programe o conector de item da mesma forma.

Ao testar os conectores que foram programados, é uma prática recomendada examinar os resultados para determinar se ocorreram exceções. Para os conectores Administrador e Itens, é importante garantir que todas as entidades foram adicionadas como resultado dos conectores.

Para isso, você pode confirmar:

1. A própria tarefa do conector foi executada com sucesso no momento em que foi programado.
2. Não existem erros. Selecione Visualizar erros para revisá-los.
3. As entidades foram adicionadas com sucesso a partir do arquivo. Selecione Visualizar resultados.

   Na lista de resultados, clique no ícone Exibir detalhes para ver quais registros (se houver) foram adicionados. Um relatório será gerado para mostrar exatamente quantos registros (entidades) foram processados com êxito.

   

   O Relatório detalhado notificará o administrador sobre o sucesso ou falha da importação. Existem vários motivos potenciais para a falha de importação e o relatório oferecerá análises sobre esses motivos. No exemplo acima, você pode identificar claramente que a importação falhou porque um campo obrigatório foi deixado em branco (valor nulo) no arquivo de importação de dados na Linha 3.

   Às vezes, se existir um problema com a forma como o arquivo foi nomeado ou com os campos de dados que não correspondem aos campos de cabeçalho no arquivo de dados, o número de Registros processados será zero e pode haver um número na coluna Exceções.

   É importante confirmar que as entidades foram adicionadas corretamente. Para os administradores, navegue até Sistema Administração→Segurança e procure os dois administradores. Para os Itens, navegue até Itens→de Atividades de Aprendizado e pesquise por eles. Para o item online, deve poder ver o novo objeto de conteúdo a partir do separador Conteúdo online do item.

   Se apenas alguns deles tiverem sido adicionados ou nenhum tiver sido adicionado, verifique as pastas Upload e Download do locatário (instância) para solucionar o problema.

Além das etapas necessárias para os outros conectores, o Conector de usuário – SF (para dados do funcionário) procurará arquivos de dados do usuário que foram colocados na pasta SFTP como resultado da exportação de funcionário. É importante que os clientes que têm usuários de empregados no HCM configurem os dois sistemas corretamente para que os usuários do HCM sejam adicionados ao SAP SuccessFactors Learning.

Campos importantes a serem considerados para incluir:

• NOTACTIVE – mapeia para STATUS e é um campo obrigatório
• STUD_ID - mapeia para USERID em HXM e é um campo obrigatório
• DMN_ID - crítico para o modelo de segurança no LMS
• SUPER - mapeia para MANAGER em HXM
• ORG_ID – mapeia para DEPARTMENT
• REGION_ID - mapeia para DIVISION
• CNTRY – mapeia para COUNTRY (mas o conector rejeitará o usuário se o valor para CNTRY ainda não existir no LMS)
• EMAIL_ADDR – mapeia para EMAIL
• HIRE-DTE – mapeia para HIREDATE, mas deve estar em um formato específico: MON-DD-AAAA HH24:MI:SS

Programe uma tarefa de exportação de funcionário recorrente em Provisionamento e certifique-se de que as informações do SFTP estejam corretas para que a exportação adicione o arquivo de dados do usuário à pasta apropriada em FEED/UPLOAD (por exemplo, TRAIN900 ou o ID de inquilino da empresa).

Programe o Conector de usuário – SF para ser executado regularmente. Normalmente, isso é definido para um horário fora de pico, geralmente todas as noites.

Ao testar isso no ambiente de teste ou staging do cliente, verifique se os usuários foram adicionados ao SAP SuccessFactors Learning a partir do HCM.

• Siga um processo seguro para integrar dados do SAP SuccessFactors HCM ao SAP SuccessFactors Learning via SFTP e conectores.
• Configure tarefas agendadas no HCM para exportar dados, salvar arquivos e configurar o SAP SuccessFactors Learning para recuperá-los e importá-los.
• Configure, carregue e programe conectores no SAP SuccessFactors Learning usando o arquivo de propriedades de conectores para automatizar a transferência de dados.
• Certifique-se de que os arquivos de entrada cumprem convenções de nomes, delimitadores e formatação rígidos para evitar erros de importação.
• Valide e solucione problemas de importações verificando logs, resultados e relatórios de erros nas pastas do SAP SuccessFactors Learning e SFTP.