Criação de uma fonte de dados

Objective

After completing this lesson, you will be able to crie uma fonte de dados nos relatórios de história do SAP SuccessFactors.

Termos comuns usados no relatório de história

Aqui estão alguns termos comuns que serão usados em toda a unidade.

Termos comuns

Relatório de históriaUma história é um documento de apresentação que usa gráficos, visualizações, textos e imagens para descrever dados e é organizada em páginas. É uma unidade de execução (execução), design e gerenciamento.
PáginaUma página é um subcomponente de um relatório de história. A página é onde configuramos a visualização dos dados recuperados em uma fonte de dados.
ConsultaUma consulta é uma pergunta que você define e envia ao modelo de dados para recuperar os dados desejados.
Fonte de dadosUma fonte de dados é uma consulta salva utilizada em um relatório de história.
EsquemaEm histórias, um esquema define as tabelas, os campos em cada tabela e as relações entre campos e tabelas para uma área específica no SuccessFactors.
Query DesignerO Query Designer é a ferramenta gráfica que permite criar a consulta, visualizá-la e salvá-la.

Também podemos analisar esses itens de uma abordagem bottom-up. No Query Designer, selecionamos tabelas e campos de um esquema para incluir em nossa consulta. Quando estiver satisfeito com os dados retornados da consulta, salve-os como uma Fonte de dados. A fonte de dados é usada por componentes em páginas. Uma ou mais páginas estão organizadas em um Relatório de história. O relatório de história é executado, gerenciado e editado como uma unidade lógica.

Visão geral do Query Designer

O Query Designer permite que você selecione os campos que deseja usar para criar relatórios usando a história. As consultas que você cria usando o Query Designer são armazenadas nas histórias e não podem ser acessadas fora da história. Elas são salvas como fontes de dados para sua história.

A página do Query Designer é exibida.

Trabalhando com tutorial em vídeo de campos

Início do Query Designer

O Query Designer será iniciado automaticamente quando você criar uma história. Depois de criar uma consulta, você pode editá-la editando o Relatório de história.

Abrir o Query Designer com um novo relatório

Para abrir o Query Designer com um novo relatório, conclua as seguintes etapas:

  1. Navegue até a Central de relatórios.
  2. Clique em Criar e selecione História.

Resultado: o Query Designer será exibido.

Abrir o Query Designer em um relatório de história existente

Você pode já ter salvo sua fonte de dados em uma história, mas precisa aprimorar ou ajustar essa fonte de dados existente. Nessa circunstância, navegue de volta para o Query Designer.

Para abrir o Query Designer em um relatório de história existente, conclua as seguintes etapas:

  1. Navegue até a Central de relatórios.
  2. Selecione processar um relatório existente.
  3. Na seção Dados, selecione Adicionar, editar ou excluir fontes de dados→Editar fonte de dados→nome da fonte de dados.

A administração de campos em uma consulta

Agora que você acessou o Query Designer, está pronto para criar a consulta a ser utilizada como uma Fonte de dados no relatório.

Pense no Query Designer como o storyboard para os dados que você incluirá na história. O Query Designer permite que você selecione e personalize a saída de dados, também chamada de query. Depois de ter a consulta exatamente como você gosta, salve-a como uma Fonte de dados para ser usada posteriormente na história.

Para criar uma consulta, você desloca elementos de dados da área Dados disponíveis para as áreas Dados selecionados e Filtros.

Comece expandindo o esquema e localizando a tabela apropriada. Quando você determina a tabela, pode expandir a tabela para exibir os campos da tabela.

Se você não tiver certeza de onde estão os dados necessários, pode procurar esquemas, tabelas e campos com a caixa de pesquisa na área Dados disponíveis.

Você pode adicionar uma tabela ou campo à consulta arrastando o item para a área de dados selecionada.

Gerenciamento de campos no Query Designer, como descrito no texto anterior.

Ferramentas do Query Designer

O Query Designer tem uma barra de ferramentas com uma seção Arquivo e uma Seção de dados. As ferramentas nesta barra de ferramentas afetam toda a consulta. As quatro ferramentas disponíveis são as seguintes:

  • Salvar – Salve o relatório de história.
  • Criar filtro - Visualizar/ocultar a barra de filtros de consulta, abrangida em uma seção posterior.
  • Criar coluna calculada – Inicie a caixa de diálogo Visão geral da coluna usada para gerenciar colunas selecionadas e colunas calculadas.
  • Criar parâmetro de entrada – Inicie a caixa de diálogo Parâmetro de entrada usada para criar parâmetros de entrada para a consulta.
  • Validação – Forneça avisos para relatórios transferidos cuja fonte de dados não passe nas verificações de validação.

Depois de adicionar uma tabela à tela, uma tabela pode ser selecionada para exibir o menu de ações da tabela. As ferramentas do menu de ações disponíveis são as seguintes:

  • Copiar: copie uma tabela relacionada.
  • Mostrar tabelas relacionadas: mostra as tabelas unidas à tabela selecionada
  • Selecionar colunas: permite selecionar colunas para a consulta
  • Adicionar filtros: permite que você adicione filtros à seleção de colunas
  • Remover tabela: remove a tabela selecionada da tela do Query Designer

O uso dessas ferramentas será abordado em seções posteriores.

Ferramentas Seleção de dados e Menu de ações, conforme descrito no texto anterior.

Adições de campo

Depois de adicionar uma tabela, selecione os campos individuais marcando as caixas apropriadas ao lado dos campos a serem incluídos.

Para adicionar campos de uma única tabela, conclua as seguintes etapas:

  1. Expanda o esquema que você está usando no relatório.
  2. Localize a tabela apropriada.
  3. Arraste a tabela para a tela.
  4. Selecione a tabela na área de dados selecionada. Um menu de ações será exibido.
  5. Selecione o botão Selecionar colunas.
  6. Selecione os campos que deseja incluir na consulta.
  7. Selecione fora do painel Selecionar coluna para fechar a janela.

Como alternativa, você pode expandir as tabelas na seção Dados disponíveis e clicar duas vezes nos campos (colunas) que deseja selecionar. Para confirmar se o campo foi selecionado, verifique a cor do nome do campo na seção Dados disponíveis. A cor de um campo selecionado é exibida em azul.

Captura de tela das opções Selecionar coluna.

Nota

Depois que você adiciona uma tabela na tela, somente as tabelas associadas ou relacionadas a essa tabela são exibidas na seção Dados disponíveis.

Indicadores de campo

Quando você está adicionando campos à sua consulta, pode ver alguns indicadores/chamadas nos campos, em particular:

  • Ícone Bloquear: significa que você não tem as permissões baseadas em função necessárias para acessar os dados nesse campo. Você ainda poderá selecionar o campo na consulta; no entanto, você não verá dados nesse campo. Quando outros usuários executam o relatório, eles veem os dados com base em suas permissões baseadas em função. Para resolver a restrição, verifique e atualize as permissões de acesso a dados concedidas a você para os campos específicos nesse módulo.
  • Ícone de escudo: significa que o campo inclui informações confidenciais. Se você adicionar colunas confidenciais ao relatório, os logs de acesso de leitura serão gerados sempre que alguém usar (visualizações, programações ou gerações) o relatório. Você também deve incluir o campo de contexto (como ID do sistema do usuário) no relatório para ativar o registro em log de acesso de leitura.

Nota

Quando você seleciona um campo de dados pessoais confidenciais para sua consulta, o sistema pode selecionar automaticamente um campo identificador exclusivo dependente, como ID de usuário, ID da pessoa ou ID do candidato, mesmo que seja de uma tabela associada automaticamente. Isso é necessário para o registro em log de acesso de leitura nos relatórios de história.

Remoção de campo

Você pode adicionar acidentalmente um campo ou um campo não é mais necessário na história. Você pode remover esses campos.

Se você precisar remover uma tabela ou um campo, poderá fazer isso com o menu de ações da tabela.

Para remover um campo, conclua as seguintes etapas:

  1. Selecione a tabela na área de dados selecionada. Um menu de ações será exibido.
  2. Selecione o botão Selecionar colunas.
  3. Desmarque os campos que deseja remover da sua consulta.
  4. Selecione fora do painel Selecionar coluna para fechar a janela.

Remoção de tabela

Para remover uma tabela, conclua as etapas a seguir.

  1. Selecione a tabela na área de dados selecionada. Um menu de ações será exibido.
  2. Selecione o botão Remover tabela.
  3. Selecione Remover para confirmar a remoção da tabela.

Reetiquetagem de campo

Em muitos casos, as tabelas podem ter campos com nomes semelhantes.

Em determinadas circunstâncias, você pode querer modificar o denominador de um campo. Por exemplo, você pode selecionar a coluna Sobrenome em duas tabelas diferentes, como Informações básicas do usuário e Gerente.

Nesse caso, renomeie o campo para distinguir entre os dois campos, como usando o Sobrenome do gerente.

A coluna Síntese com os campos Descrição da coluna destacados.

Para reetiquetar um campo, conclua as etapas a seguir.

  1. Na seção Dados da barra de ferramentas, clique no botão Coluna calculada.
  2. Na caixa de diálogo de visão geral da coluna, atualize a Descrição da coluna para os campos.
  3. Selecione OK.

Visualização do Query Designer

Visualização da consulta

Visualizar consulta fornece uma visão geral de sua consulta de dados para as colunas que você selecionou e os dados que elas recuperam.

Visualização do Query Designer mostrando colunas de dados

Você pode clicar em Ocultar visualização para ocultar a visualização da consulta.

Exportar dados do Query Designer em relatórios de história

Caixa de diálogo Exportar fonte de dados mostrando opções de CSV e Excel

Você pode exportar dados em relatórios de história diretamente da página do Query Designer usando a funcionalidade Exportar dados.

O ícone Exportar dados está disponível na tela Visualização no Query Designer.

  • Se seus dados contiverem menos de 1 milhão de células, clique no ícone Exportar dados para baixar imediatamente os dados para sua pasta de download.
  • Se seus dados contiverem mais de 1 milhão de células, a exportação será programada off-line. Você recebe uma mensagem com um link para visualizar os relatórios programados.

A notificação de relatório programado confirma a entrega do e-mail após a conclusão, com uma tarefa destacada pronta para download no menu de ações.

O Gerenciamento de aprendizagem não é suportado atualmente para esta funcionalidade.

Ordenação e ordenação de colunas para exportação de dados no Query Designer

Caixa de diálogo Configurações de exportação mostrando as guias Ordem de colunas e Ordenação de coluna

Você pode definir a ordem e a ordenação das colunas para a exportação de dados. A exportação respeita sua ordem de coluna configurada e suas preferências de classificação.

Você pode usar o botão Exportação de dados no designer de consultas para acessar as opções Configurações de exportação e exportação.

Guia Ordem da coluna
Reorganize as colunas usando os botões de movimentação ou a navegação pelo teclado.
Ficha de registro Ordenação de coluna
Defina a ordenação para uma ou mais colunas, defina a sequência de ordenação como crescente ou decrescente e ajuste a prioridade deslocando os critérios de ordenação para cima ou para baixo.

Os dados de visualização e exportados refletem a ordem das colunas e a ordenação que você especificou. Essas configurações são salvas com a definição da consulta e aplicadas sempre que você visualiza ou exporta dados da fonte de dados. A configuração não afeta o conteúdo da história ou as configurações no nível do widget.

Dados do SAP SuccessFactors Learning em fontes de dados

Se sua organização usa o SAP SuccessFactors Learning, você pode usar Histórias para gerar relatórios sobre os dados de aprendizagem. No entanto, isso adicionará uma etapa adicional ao criar uma nova fonte de dados.

Painel para análise de conformidade da aprendizagem: 6 currículos, 17 cursos únicos, 103.300 cursos atribuídos no total, 2.792 cursos médios por país. O gráfico de setores mostra 76% de conformidade, 23,5% de não conformidade, 0,07% com 40 dias de conformidade.

Para organizações com SAP SuccessFactors Learning e Histórias, ao criar uma nova fonte de dados, você será solicitado a escolher uma conexão com o modelo de dados apropriado. O modelo de dados define quais esquemas, tabelas e campos podem ser usados na consulta:

  • SAP SuccessFactors Reporting (SAPSFSFREP): todos os esquemas que NÃO são do SAP SuccessFactors Learning
  • SAP SuccessFactors Learning (SAPSFSFLMS): SOMENTE os esquemas do SAP SuccessFactors Learning
Abra a lista e selecione uma conexão em tempo real da SAP.

O processo para criar a fonte de dados usando dados de aprendizagem é o mesmo. Somente os esquemas, tabelas e campos são diferentes.

Para saber mais sobre os esquemas de aprendizagem suportados para relatórios de história, consulte o tópico Dados disponíveis (esquema) em relatórios de história no documento Dados disponíveis (esquema) em relatórios de história | SAP Help Portal, no SAP Help Portal.

A interface do Query Designer mostrando uma conexão entre as tabelas Usuário e Resumo do histórico de aprendizagem e uma lista de opções de dados disponíveis.

Recomendações e proteções para fontes de dados em uma história

Cada consulta pode incluir no máximo 120 colunas, usar até 30 tabelas e recuperar até 1.000.000 células por consulta. Essas restrições são padrão em todas as instâncias e são implementadas para garantir o desempenho e evitar consultas intensivas de recursos que possam afetar os lados do servidor e do cliente.

Você deve:

  1. Planejar design de consulta da sua história: antes de criar sua história, conte o número esperado de colunas e tabelas necessárias para seus dados. Certifique-se de que você não excede 120 colunas ou 30 tabelas.

  2. Estimar total de células: calcule o volume de dados esperado e verifique se ele não excederá 1.000.000 células na saída da consulta.

  3. Evite usar relatórios de história para:

    • Dumps de dados para análise somente para Excel ou CSV

    • Disponibilização/dados intermediários para ingestão em outros sistemas

    • Finalidades de ETL ou data warehousing

  4. Verificar uniões de tabela:

    • Revise o número de junções e junções automáticas em sua consulta, garantindo que elas não excedam o limite de 30 tabelas.

    • Esteja ciente de que exceder o limite pode levar a problemas de desempenho ou erros de falta de memória

Como designer, você receberá avisos e será bloqueado para adicionar elementos de padrão railed guard assim que um limite definido for atingido, garantindo o desempenho ideal do relatório.

ConsultaAdvertênciaLimite
Autojunção530
Instruções IF aninhadas1285

Nota

Histórias existentes não são afetadas no momento da execução, mesmo que atualmente excedam esses limites. Ao editar uma história existente, as grades de proteção bloqueiam a adição de novas instâncias desses construtos, mas todos os outros elementos podem ser modificados sem restrição, garantindo que o desempenho permaneça inalterado.

Consultar verificações de validação

Se a configuração do sistema SAP SuccessFactors for modificada, ou se você importar definições de relatório de um sistema diferente, pode acabar com relatórios com fontes de dados que são inválidas. Portanto, a SuccessFactors integrou uma ferramenta de validação de consultas ao Query Designer.

Quando você visualiza ou finaliza uma consulta, ela aciona algumas verificações de validação que ajudam você a identificar e corrigir problemas na consulta, se existirem.

Captura de tela de erros de validação.

As verificações de validação de consulta ajudam você a identificar o seguinte:

  • Colunas ausentes (campos): as verificações de validação identificam os campos usados na consulta (colunas selecionadas, filtros e/ou cálculos), mas não estão disponíveis no sistema. Para resolver o problema, você pode substituir o campo em falta por uma opção válida ou pode eliminar o campo em falta.
  • Objetos ausentes (tabelas): as verificações de validação identificam as tabelas usadas na consulta (seus campos são incluídos em colunas, filtros e/ou cálculos selecionados), mas não estão disponíveis no sistema. Para resolver o problema, remova a tabela ausente da sua consulta e remova os campos da tabela ausente de filtros e/ou cálculos.
  • Permissão ausente (metadados): quando um usuário edita uma consulta com filtros, se o usuário não tiver acesso aos dados de nenhum dos campos usados nos filtros, a consulta será interrompida. Essa verificação de validação identifica esses filtros inválidos que quebram a consulta. Para resolver o problema, você pode remover os filtros inválidos e salvar suas modificações na consulta.

Quando faltam colunas, as etapas para resolver o problema variam dependendo de onde o campo é usado:

  • Se um campo ausente tiver sido selecionado como coluna na consulta, o sistema fornecerá opções para atualizar ou remover o campo para corrigir o problema.
  • Se um campo em falta tiver estado em um filtro ou em um cálculo, o sistema fornece detalhes do campo em falta e da entidade na qual o campo foi utilizado. Você deve atualizar manualmente a entidade para corrigir o problema.

Nota

As verificações de validação só são aplicáveis no Query Designer, não no Designer de histórias. Isso significa que as verificações de validação não conseguem identificar os erros nos widgets usados na história.

Interação: criar um novo relatório e criar uma consulta de informações do empregado

Exemplo empresarial

Neste exercício, você criará um novo relatório com uma fonte de dados utilizando a tabela Informações básicas do usuário.

Campos de tabelas relacionadas

Para a maioria dos relatórios, você precisará usar mais de uma tabela para recuperar os dados necessários.

As tabelas no esquema de relatório podem ser relacionadas a outras tabelas, dentro do mesmo esquema ou em um esquema diferente. Depois de adicionar uma tabela à tela, somente as tabelas associadas ou relacionadas a essa tabela serão exibidas na seção Dados disponíveis.

Você pode adicionar tabelas relacionadas a partir da seção Dados disponíveis ou por meio do menu de ações da tabela. Um benefício dos Dados disponíveis é que eles têm uma opção de pesquisa.

Para adicionar uma tabela ou campo relacionado a partir de Dados disponíveis, conclua as seguintes etapas:

  1. Navegue ou localize a tabela/campo apropriado na seção Dados disponíveis.
  2. Clique duas vezes nela ou arraste e solte a tabela/campo na tela de consulta.
  3. Você pode adicionar campos usando o mesmo método ou o comando Selecionar colunas no menu de ação da tabela.

Nota

A primeira tabela que você adiciona à consulta é referida como tabela de orientação. Cada consulta só pode ter uma única tabela de orientação. Todas as tabelas adicionadas à consulta devem estar relacionadas à tabela de orientação, diretamente ou por meio de outra tabela relacionada.

Adicione uma tabela ou campo relacionado, como descrito no texto anterior.

Você também pode adicionar tabelas relacionadas usando o comando Mostrar tabelas relacionadas no menu de ação da tabela. Os esquemas e a tabela relacionados serão exibidos à direita das tabelas selecionadas. Os esquemas são exibidos como rótulos recolhíveis/expansíveis, como avaliação 360.

  1. Selecione a tabela na área de dados selecionada.

    Um menu de ações será exibido.

  2. Selecione o botão Exibir tabelas relacionadas.
  3. Selecione > para expandir o esquema e mostrar as tabelas relacionadas disponíveis.

  4. Para adicionar uma tabela:

    a. Selecione o ícone + para adicionar a tabela sem campos.

    b. Clique na tabela e use o comando de menu de ação Selecionar colunas para selecionar as colunas.

  5. A tabela é adicionada à tela.
Adicione tabelas relacionadas usando o comando mostrar Tabelas relacionadas.

Nota

As tabelas relacionadas que você adiciona à tela também podem ter tabelas relacionadas. Portanto, uma consulta pode envolver muitas tabelas de vários esquemas.

Atualmente, sua consulta só pode incluir até 120 colunas, que são selecionadas a partir de um máximo de 30 tabelas. Sua consulta pode recuperar dados de até 1.000.000 células. No entanto, certifique-se de que o número total de colunas de todas as consultas não exceda 180.

Tutorial em vídeo de tabelas relacionadas

Tipo de join para tabelas relacionadas

Depois que uma tabela relacionada é adicionada à tela, você pode ajustar o tipo de junção entre as duas tabelas. Cada tabela relacionada terá um padrão, que pode ser substituído selecionando o ícone de junção de tabela.

Para ajustar o tipo de junção, selecione o ícone de junção de tabela.

Inner joins

Tipos de junção

Duas tabelas, Informações globais do cargo e Bônus pontual, são ordenadas por interseção de dados usando inner join, resultando em IDs de usuário compartilhados, AAA e BBB, mostradas na tabela Resultados da consulta com detalhes do cargo e do bônus.

As junções internas mostram apenas registros que existem nos dois objetos. Neste exemplo, o CCC do funcionário não é mostrado nos resultados da consulta porque eles não existem no objeto Bônus pontual.

Junções externas esquerdas

Duas tabelas, Informações globais do cargo e Bônus pontual, são mescladas usando uma junção externa esquerda, resultando em uma tabela Resultados da consulta com dados combinados para cada ID de usuário, incluindo detalhes de compensação.

As junções externas esquerdas exibem todos os registros do objeto à esquerda e somente os registros que correspondem ao objeto à direita. Neste exemplo, o CCC do colaborador é mostrado nos resultados da consulta porque eles existem no objeto Informações globais do cargo, no entanto, com resultados vazios das colunas Bônus pontual porque não existem nesse objeto.

Tipos de junção de alteração do Query Designer

Para modificar o tipo de junção, conclua as seguintes etapas:

  1. Selecione o ícone de junção de tabelas.
  2. Selecione o tipo de junção apropriado.
  3. Você pode testar seus resultados com o botão Visualizar consulta.

Interação: tabelas relacionadas em uma consulta

Exemplo empresarial

Neste exercício, você adicionará dados adicionais de uma tabela relacionada. Você incluirá a Data de nascimento da Tabela de Informações Pessoais Básicas.

Síntese

  • O Query Designer é uma ferramenta gráfica usada para criar, visualizar e salvar consultas como fontes de dados.
  • Um esquema define as tabelas, os campos e as relações disponíveis para áreas específicas no SAP SuccessFactors.
  • A tabela de orientação é a primeira tabela adicionada a uma consulta, e todas as outras tabelas devem estar relacionadas a ela.
  • As consultas estão restritas a um máximo de 120 colunas, 30 tabelas e um milhão de células de dados para desempenho.