Implemente blocos do Looker

Esta página descreve os passos para instalar um bloco do Looker pré-criado para o Cortex Framework localizado num repositório público do GitHub, como:

Para implementar o painel de controlo do Looker para a Dun & Bradstreet, consulte o painel de controlo do Looker Studio para a Dun & Bradstreet.

Pré-requisitos

Para aceder e usar estes painéis de controlo pré-criados, tem de fazer o seguinte:

  1. Implemente o Cortex Framework: certifique-se de que o Cortex Framework está configurado com as suas origens de dados. Para mais informações, consulte o artigo Pré-requisitos da framework Cortex para implementação.
  2. Aceda ao Looker: aceda ao Looker e familiarize-se com a plataforma.
  3. Explore os painéis de controlo disponíveis: explore os painéis de controlo pré-criados e as estatísticas disponíveis no painel de controlo que quer implementar. Para mais informações, consulte o artigo Blocos do Looker disponíveis.

Depois de concluir os pré-requisitos, pode instalar o seu Looker Block.

Instalação

Os blocos do Looker usam o LookML (Looker Modeling Language) para definir o modelo semântico para os painéis de controlo do Looker. Para instalar o modelo do LookML que corresponde à sua origem de dados do Cortex, use uma das seguintes opções:

  • Opção A: instale através do mercado do Looker a partir de um URL do Git.
  • Opção B: instale através da criação de um fork do repositório.

As secções seguintes descrevem os passos para cada opção.

Opção A: instale através do Looker Marketplace a partir de um URL do Git

O mercado do Looker é uma localização central no Looker para encontrar, implementar e gerir blocos do Looker, aplicações, visualizações e plug-ins. Para instalar através do mercado do Looker a partir de um URL do Git, siga estes passos:

  1. Aceda à sua instância do Looker.
  2. Clique no botão Marketplace na barra de menu do Looker .
  3. No menu do Marketplace, selecione a opção Gerir.
  4. Na página Gerir, selecione o menu de Opções (três pontos) .
  5. Selecione o botão Instalar através do URL do Git.
  6. Introduza o URL e o SHA do repositório escolhido:
  7. Clique em Instalar.
  8. Aceite e continue na caixa de diálogo dos Termos de Utilização.
  9. Introduza os parâmetros obrigatórios que correspondem aos seus dados:
    • Nome da ligação
    • ID do projeto
    • Conjunto de dados de relatórios
  10. Clique em Instalar.

Para mais informações, consulte a documentação do Looker sobre a instalação de uma ferramenta a partir de um URL do Git.

Opção B: instale através da criação de uma ramificação do repositório

Para instalar blocos do Looker através da ramificação do repositório, siga estes passos:

  1. Crie uma bifurcação do repositório do GitHub:

    1. Navegue para o repositório do GitHub do bloco do Looker escolhido:
    2. Clique em Fork no canto superior direito do repositório.
    3. Crie um fork com o seu nome de utilizador. Esta ação cria uma cópia do repositório na sua conta do GitHub.

  2. Crie um projeto do LookML em branco:

    1. Confirme se está no modo de programação.
    2. Selecione Projetos no menu Desenvolver.

    3. Na parte superior esquerda da página Projetos do LookML, selecione Configurar novo modelo para abrir a página Configurar um modelo.

    4. Na página Configurar um modelo, especifique as opções para o seu modelo:

      1. Modelo: atribua ao modelo o mesmo nome do ficheiro model.lkml no repositório. Por exemplo, dê o nome cortex-<datasource> ao modelo.

      2. Projeto: atribua um nome ao seu projeto. Dê-lhe o mesmo nome que o modelo ou especifique um nome diferente.

      3. Ligações permitidas: especifique as ligações à base de dados que o modelo pode usar ou especifique que o modelo pode usar quaisquer ligações atuais ou futuras.

    5. Clique em Guardar para guardar o projeto como um Projeto pendente.

    6. Na página Projetos do LookML, localize o novo projeto na secção Projetos pendentes.

    7. Clique em Adicionar LookML para abrir a página Novo projeto.

    8. Na página Novo projeto, especifique as opções do seu projeto:

      1. Nome do projeto: já preenchido com o valor especificado no passo anterior.
      2. Ponto de partida: selecione Projeto em branco.

    9. Selecione Criar projeto. O Looker cria o projeto e abre-o no IDE do Looker.

    Para mais informações, consulte a documentação original do Looker sobre como gerar um modelo LookML.

  3. Associe o novo projeto do LookML ao repositório bifurcado: siga os passos na documentação do Looker, no artigo Configurar e testar uma ligação Git.

  4. Atualize os valores das constantes no ficheiro manifest.lkml:

    1. Abra o ficheiro manifest.lkml no repositório bifurcado no Looker.
    2. Localize a secção de constantes e atualize os valores conforme descrito na secção Parâmetros obrigatórios.

  5. Consolide e implemente alterações na produção. Com o projeto do Looker baseado no seu repositório bifurcado, pode personalizar o LookML para se adequar às necessidades específicas da sua empresa. Siga os passos descritos no artigo Como implementar as alterações na produção.

Parâmetros obrigatórios

Estes valores obrigatórios são configurados durante o processo de instalação do Marketplace ou, se este bloco tiver sido instalado a partir de um repositório Git bifurcado, tem de atualizar os valores destas constantes no ficheiro manifest.lkml do projeto.

Parâmetro Valor Descrição Blocos do Looker
Connection Name Nome da associação O nome da ligação do BigQuery que permite ao Looker consultar o conjunto de dados REPORTING do Cortex. tem de estar ativada. Tudo
Project ID ID do projeto O Google Cloud projeto onde o conjunto de dados de relatórios reside no BigQuery. Para mais informações, consulte o artigo Identificar projetos. Tudo
Reporting Dataset Nome do conjunto de dados para relatórios O conjunto de dados de RELATÓRIOS da Cortex Data Foundation implementado, onde as vistas do conjunto de dados da origem de dados residem no Google Cloud projeto do BigQuery. Consoante as definições de implementação da Cortex Data Foundation, este nome do conjunto de dados seria normalmente do padrão que termina com _REPORTING. Tudo
Client Número de cliente SAP (mandt) O número do cliente SAP (mandt) a usar para relatórios. SAP
Sign Change Yes ou No Para os relatórios de lucros e perdas/demonstração de resultados, a receita é geralmente apresentada no livro-razão geral como um número negativo, o que indica um crédito. Se definir o valor de alteração de sinal como Yes, é apresentado como um número positivo nos relatórios de demonstração de resultados. SAP

Requisitos adicionais específicos do bloqueio

Alguns blocos têm requisitos específicos para a respetiva implementação. Para mais informações, consulte a implementação específica do bloco:

Bloquear Link para requisitos adicionais
SAP Especificações adicionais para o bloco do Looker da estrutura do Cortex para SAP.
Oracle EBS Especificações adicionais para o bloco do Looker da estrutura do Cortex para o Oracle EBS.

Recursos adicionais

Para mais informações sobre o LookML, consulte a seguinte documentação e formação: