Pular para o conteúdo principal
Procore

Introdução à Análise 2.0 (Beta)

  1. Última atualização
  2. Salvar como PDF

Índice

Visão geral

 Em versão Beta
Existente Os clientes da Analytics têm a oportunidade de participar do Programa Beta aberto para Análise 2.0. Entre em contato com seu gerente de sucesso do cliente para saber mais.

O Analytics 2.0 fornece uma solução poderosa e amigável para aproveitar os dados do seu projeto, tomar decisões informadas e obter insights mais profundos sobre o desempenho e os resultados gerais do projeto. 

Os principais recursos incluem:

  • Os dados são atualizados a cada hora que você pode puxar a qualquer momento. Além disso, os dados são monitorados para precisão e integridade.
  • É possível extrair todos os dados do Procore, incluindo campos personalizados, fluxos, histórico de alterações e atividade do usuário.*
  • Nova plataforma de dados com maior escalabilidade e disponibilidade de dados.
  • Relatórios pré-construídos de POWER BI.

*Todos os conjuntos de dados não estarão disponíveis no início da fase Beta aberta. Paridade de recursos completo com o Analytics 1.0 em breve.

 

 

Considerações

  • Você pode continuar usando sua versão atual do Procore Analytics, mesmo que opte pela Versão Beta aberta para Analytics 2.0.
     
  • Se você não estiver vendo o texto explicativo para ingressar na versão Beta aberta, talvez outro Administrador da empresa em sua empresa já tenha recusado o contrato Beta.
     
  • Para reativar o convite, entre em contato com seu gerente de sucesso do cliente para reativação.
     
  • Se estiver tendo problemas para se conectar a Procore Analytics 2.0, entre em contato com seu gerente de sucesso do cliente do Procore.

Perguntas comuns

Qual a frequência de atualização de dados?

Os dados são atualizados por hora ao longo do dia. 

Como faço minha conexão com o Procore Analytics 2.0?

É possível acessar a Analytics 2.0 de várias maneiras. A maneira mais comum seria conectar-se no Power BI. Consulte Começar com Procore Analytics 2.0. 

Perderei o acesso aos relatórios existentes?

Procore Analytics 1.0 ficará disponível até 2025. O objetivo é dar aos usuários tempo de sobra para mudar para o Analytics 2.0.

Os clientes na Extração de dados precisarão migrar para Procore Analytics 2.0?

Sim, os clientes no Data Extract precisarão passar para Procore Analytics 2.0, agora chamado de Cloud Connector (movido pelo Delta Share).  Procore Analytics 2.0 também incluirá relatórios do PowerBI como um recurso que os clientes não são obrigados a usar, mas estarão disponíveis para todos os clientes com Procore Analytics 2.0.

Ainda preciso que as licenças do Power BI acessem o Procore Analytics2.0?

Ainda será necessário compartilhar as licenças de BI de energia para compartilhar relatórios de POWER BI. 

Como atualizo os relatórios personalizados que foram desenvolvidos internamente?

Procore Analytics 2.0 agora usa o compartilhamento Delta de databricks. Qualquer conexão existente com o Analytics 1.0 (Azure SQL) precisa ser alterada. Várias tabelas e colunas de relatórios foram renomeadas. As alterações básicas que você precisará fazer incluem a atualização de relatórios para usar o novo conector Delta Sharing, atualizar nomes de tabelas e colunas e atualizar visuais que podem ter quebrado após você ter feito as alterações mencionadas acima. Dependendo de como seu relatório foi criado, pode haver considerações adicionais. Consulte Começar com Procore Analytics 2.0. 

Como o processo de cópia de dados em meu armazém de dados será afetado pela 2.0?

Procore Analytics 2.0 agora usa o compartilhamento delta de tijolos de dados para acesso aos dados. Você pode saber mais sobre o compartilhamento da Delta aqui.    

 

Para quaisquer outras perguntas ou preocupações sobre Procore Analytics 2.0, entre em contato com o Grupo Comunitário Analytics 2.0 Beta. 

Permissões

Saiba quais são as permissões de usuário necessárias para executar as ações descritas nessa ferramenta.

 

Permissões

 |  |  A ação está disponível no aplicativo Web, iOS e/ou Android do Procore. Clique para visualizar o artigo.

icon-mindtouch-table-check.png Os usuários podem realizar a ação com esse nível de permissão.

icon-mindtouch-table-check.png Os usuários podem adotar essa ação com esse nível de permissão E um ou mais requisitos adicionais, como permissões granulares.

Ação Nenhuma Somente leitura Padrão Administrador Obs.

Gerar um token de dados

 Web

       check-green2.png

Qualquer pessoa com acesso de nível "Administrador" à Análise pode conceder acesso adicional a usuários à ferramenta Análise. 

 

Obter acesso aos seus dados do Procore

Para começar a acessar seus dados do Procore, você precisa gerar um token de acesso. O token de acesso é uma sequência de dígitos que você inserirá em seu sistema BI para acessar os dados. Normalmente, os usuários que precisam de tokens de acesso são engenheiros de dados ou desenvolvedores do Power BI. 

 

Considerações

  • Você precisa estar com a ferramenta Procore Analytics habilitada. 
  • Para habilitar o Analytics 2.0, um Administrador da empresa precisa aceitar o contrato Beta aberto.
  • Ao padrão, todos os Administradores da empresa têm acesso de nível "Administrador" à Análise no Diretório. 
  • Qualquer pessoa com acesso de nível "Administrador" à Análise pode conceder acesso adicional a usuários à ferramenta Análise. 
  • Para gerar um token de dados, os usuários precisam ter acesso de nível "Administrador" à ferramenta Análise. 

Passos

Aceitar contrato Beta e ativar

Após ser convidado para a fase Beta aberta, os Administradores da empresa verão um banner pop-up convidando você a aceitar o contrato Beta na próxima vez que fizer login no Procore. Se você não vir o pop-up, outro Administrador da empresa pode já ter recusado o contrato Beta. Entre em contato com seu Gerente de sucesso do cliente para reativar.

Conceder acesso de nível de administrador a analytics 2.0 aos usuários finais de dados

Assim que qualquer Administrador da empresa aceitar o contrato Beta, todos os Administradores da empresa verão Procore Analytics no menu suspenso de ferramentas no Procore. Adicionar administradores de análise (p. ex., alguém em TI ou um analista de dados) para ajudar com seus próximos passos, acessar o cartão diretório de nível de empresa do usuário e fornecer acesso de nível de administrador à ferramenta Análise.

Conectar-se aos seus dados 

Qualquer pessoa com acesso de nível administrador à ferramenta Análise poderá gerar tokens de acesso de dados por meio da ferramenta Análise. Os usuários finais de dados devem gerar tokens de dados e, em seguida, precisarão seguir as etapas adicionais na próxima seção deste guia para conectar os dados a um armazém de dados ou solução de BI. Para começar a conectar seus dados, siga as etapas abaixo:

  1. Faça login no Procore. 
  2. Clique no ícone Conta & Perfil na barra de navegação.
  3. Clique em Definições do meu perfil. 
  4. Clique na guia Procore Analytics Tokens . 
  5. Em seguida, você escolherá sua conexão com Procore Analytics.
  6. Se você tiver Databricks, insira seu identificador e clique em Conectar.
  7. Escolha qual tipo de token você vai gerar.
  8. Clique em Gerar token.
    Nota: O token desaparecerá após uma hora ou se você sair da página. Para gerar um novo token, retorne à Etapa 1. 
  9. A próxima seção deste guia ajudará você a se conectar à sua solução downstream.

Conectar-se ao BI de alimentação

Conectar-se com modelos de análise

Fazer download de arquivo de credenciais

  1. Crie um arquivo chamado "config.share".
  2. Adicione os campos abaixo:
    {
    "shareCredentialsVersion": 1,
    "bearerToken": "",
    "endpoint": "",
    "expiração em tempo": ""
    }
  3. Adicione ao arquivo config.compartilhamento os valores de bearerToken, endpoint, shareCredentialsVersion e expiraçãoTime recebidos do Procore.

Executar user_exp.py roteiro

Você pode usar os seguintes roteiros para criar um arquivo config.yaml com as configurações necessárias. 

  • Para armazenamento do Azure:
    cron_job: #true/falso
    run_as: #pyspark/python
    source_config:
      config_path: #path no arquivo config.share
      Tabelas:
      - "" Nome da tabela n.º se quiser fazer download de uma tabela específica. Deixe-o vazio se quiser fazer download de todas as tabelas
    source_type: delta_share
    target_config:
      auth_type: service_principal
      client_id: #client_id
      secret_id: #secret_id
      storage_account: nome #storage conta
      storage_path: #<container>@<storage-account>.dfs.core.windows.net/<directory>
      tenant_id: #tenant_id
    target_type: azure_storage
  • Para MSSQL DB:
    cron_job: #true/falso
    run_as: #pyspark/python
    source_config:
      config_path: #path no arquivo config.share
      Tabelas:
        - "" Nome da tabela n.º se quiser fazer download de uma tabela específica. Deixe-o vazio se quiser fazer download de todas as tabelas
    source_type: delta_share
    target_config:
      banco de dados: #target banco de dados
      host: #target nome de host:port
      senha: #password
      esquema: esquema #target (padrão a procore_analytics)
      nome de usuário: #username
    target_type: sql_server

Correr como PyS terminologia

Se o seu ambiente já estiver configurado com o Spark, escolha a opção "pys terminologia" quando solicitado ou depois que o "config.yaml" for gerado, você poderá executar os seguintes comandos para fazer download dos relatórios para o Diretório de dados.

  • Para escrever no armazenamento ADLS Gen2:
    spark-submit --pacotes io.delta:delta-sharing-spark_2.12:3.1.0, org.apache.hadoop:hadoop-azure:3.4.0,com.microsoft.azure:azure-storage:8.6.6,org.apache.hadoop:hadoop-common:3.4.0 --excludente-pacote com.sun.xml.bind:şb-impl delta_share_to_sql_spark.py
  • Para escrever no MSSQL DB:
    spark-submit --pacotes io.delta:delta-compartilhamento-spark_2.12:3.1.0 - potes <Calação do pote mssql-jdbc> delta_share_to_sql_spark.py

Executar como Python

  1. Na linha de comando, acesse a pasta inserindo o comando "cd <path to the folder>" .
  2. Instalar pacotes obrigatórios usando a "instalação de pip-r requirements.txt" ou "python-m pip instalar -r requirements.txt".
  3. Abra o SSIS e crie um novo projeto.
  4. Na caixa de ferramentas SSIS arrastar e soltar Executar tarefa de processo.
  5. Clique duas vezes em Executar tarefa de processo.
  6. Acesse a guia Processo.
  7. Ao lado de Executável, insira o caminho para python.exe na pasta de instalação python.
  8. Em Teoria dos trabalhos, insira o caminho para a pasta que contém o script que deseja executar (sem o nome do arquivo de roteiro).
  9. Em Argumentos, insira o nome do roteiro delta_share_to_azure_panda.py deseja executar com a .py e clique em Salvar.
  10. Clique em Começar no menu de fita superior.
  11. Durante a execução da tarefa, a saída do console Python é exibida na janela externa do console.
  12. Após o final da tarefa, ela exibirá um marca de verificação.

Escolher seu próprio método

O compartilhamento da Delta é um protocolo aberto para um compartilhamento seguro de dados. Você encontrará o repositório público gitş para compartilhamento delta em https://github.com/delta-io/delta-sharing. O repositório inclui exemplos e documentação para acessar dados compartilhados usando vários idiomas, como Python e Spark Connector (SQL, Python, Scala, Java, R).

 Obs.
Certifique-se de ter permissões e direitos de acesso adequados para fazer download dos arquivos necessários e executar contêineres Docker em seu sistema. Sempre siga as práticas recomendadas de segurança e diretrizes fornecidas pelo Procore ao lidar com dados e credenciais sigilosos.

Conectar-se a databricks

  1. Faça login em seu ambiente de Databricks.
  2. Clique em Catálogo.
  3. Em Compartilhamento Delta, selecione Compartilhado comigo.
  4. Clique em Compartilhar Identş para copiar e compartilhar com a equipe de suporte do Procore.
    Nota: Quando o identificador de compartilhamento for recebido, o Procore o adicionará ao sistema. 
  5. Em Provedores, clique no identificador do Procore.
  6. Clique em Criar catálogo.
  7. Insira seu nome preferencial para o catálogo compartilhado.
  8. Clique em Criar.
    Agora, seu catálogo e tabelas compartilhados serão exibidos com o nome fornecido no Explorador de catálogos. 

Migrar um relatório existente

  1. Abra o relatório que deseja migrar.
  2. Abra o Editor de consulta.
  3. Clique em Nova origem e clique em Mais. 
    Nota: Os valores dados a você não serão os mesmos que os valores nos exemplos abaixo.
  4. Na barra de pesquisa, digite "Compartilhamento Delta".
  5. Selecione Delta Sharing e clique em Conectar.
  6. Digite ou cole o servidor de compartilhamento Delta URL recebido do Procore. 
  7. Selecione a tabela que deseja migrar.
  8. Na nova consulta, clique em Editor avançado.
  9. Copie o conteúdo antes da palavra "in". Isso incluirá as etapas "Origem" e "Navegação" da consulta.
    Nota: A captura de tela abaixo é apenas um exemplo. Seus valores serão diferentes.  
    source-and-navigation-query.png
  10. Clique em Concluído.
  11. Abra a "Empresa".
  12. Substitua as etapas "Origem" e "Navegação" pelas etapas copiadas da Etapa 9.
    Nota: Certifique-se de colar o texto antes da palavra "dentro".
  13. Clique em Concluído. 
  14. Adicione uma vírgula no final do texto se houver etapas adicionais aplicadas.
  15. Visualize a consulta sobre os erros que podem ocorrer. Por exemplo, algumas colunas não existem na versão mais recente do Procore Analytics para que possamos removê-las de Etapas aplicadas.
  16. Em seguida, você reenviará a tabela do projeto.
  17. Consulta de projetos abertos.
  18. Clique em Editor avançado.
  19. Cole o mesmo código de conexão acima (copiado da consulta das empresas) até as duas primeiras linhas da consulta do projeto (antes de qualquer etapa começando pelo n.º).
  20. Agora, a nova consulta se parece com a captura de tela abaixo.
    project-query.png
  21. Adicione uma vírgula e altere o código para apontar para uma tabela diferente, como o exemplo abaixo:
    Exemplo:

    Origem ..." DeltaSharing.Contents(https://nvirginia.nuvem. databricks.c... d-4692f841b2ca",
    [rowLimitHint!'null]),pa_internal_test &u pa_internal_test . Fonte!"...[Nome!'"pa_internal_test"]!)[Dados],
    public_company_only . pa_internal_test......[Nome!'"public_company_only"]!)[Dados],
    empresas1 !) public_company_only!)[Nome!'"empresas"]!)...[Dados],

    Alterar -> empresas1 ): public_company_only!)...[Nome!'"empresas"]!)[Dados],
    Para -> Projetos !) public_company_only......[Nome!'"projetos"]......[Dados],
     
  22. "[Nome!'"projetos"]" é o que aponta para a tabela correta no Analytics 2.0.

Renomear tabelas e colunas de relatórios

  1. Abra o Editor de consulta para o relatório que você precisa renomear.
  2. Encontre a coluna que não está no Procore Analytics 2.0.
  3. Na barra de fórmula, substitua a coluna Analytics 1.0 pelo novo para o Analytics 2.0.
  4. Outro método seria adicionar uma etapa para renomear as colunas do Analytics 2.0 para os valores que você tinha em seu relatório anterior. 
  5. Por exemplo, agora a project_stage_name estátage_name na Analytics 1.0.
  6. Se você for para a etapa de navegação, poderá renomear a coluna aqui e corrigir erros nas etapas subsequentes.
  7. Clique em Inserir após fazer todas as atualizações. 
  8. Repita esse processo para qualquer outra coluna renomeada.
  9. Ao retornar ao erro, você verá o problema resolvido. 

Conectar-se à área de trabalho de BI de alimentação

  1. Abra sua área de trabalho com bi de energia.
  2. Na página Tela inicial, clique em Novo para expandir a seção.
  3. Clique em Relatar.
  4. Clique em Obter dados de outra fonte. 
  5. Na barra de pesquisa, digite "Compartilhamento Delta".
  6. Selecione Delta Sharing e clique em Conectar. 
  7. Digite ou cole o servidor de compartilhamento Delta URL recebido do Procore. 
  8. Se esta for a primeira vez que você se conectar a essa fonte, você será solicitado a fornecer seu Token de bearer de compartilhamento Delta.
  9. Após a autenticação, selecione as Procore Analytics tabelas que deseja inserir em seu relatório de BI do poder. 
  10. Selecione Carregar para visualizar seu relatório ou selecione Transformar dados para fazer mais transformaçãos na Consulta de energia. 

Configurar a segurança de nível de linha

  1. Configurar relação de nível de poder "Projeto" e "ProjectUser"
  2. Criar uma nova função de RLS
  3. Adicionar usuários a uma função de RLS

Configurar "projetos" e "project_users" relação de bi de poder

A configuração de uma relação de POWER BI entre os projetos e as tabelas de project_users conecta os dados dessas tabelas. Consulte Criar e gerenciar relacionamentos na área de trabalho icon-external-link.pngde Power BI. Veja abaixo duas opções para configurar esse relacionamento.

Opção 1

  1. Abra um relatório de Procore Analytics no desktop Power BI.
  2. Na guia Tela inicial, clique em Gerenciar relacionamentos.
  3. Na janela "Gerenciar relacionamentos", role as opções e selecione project_users (project_id) e clique em Editar.
    manage-relationships-analytics.png
  4. Preencha o seguinte na janela "Editar relacionamento":
    • Em "Cardealidade", selecione Muitos para um (*:1) e marque a caixa de verificação "Tornar esta relação ativa". Essas opções devem ser selecionadas por padrão.
    • Em "Direção de filtro cruzado", selecione Ambos e marque o caixa de verificação "Aplicar filtro de segurança em ambas as direções".
      edit-relationship-analytics.png
  5. Clique em OK para fechar a janela "Editar relacionamento".
  6. Clique em Fechar para fechar a janela "Gerenciar relacionamentos".
  7. Salve o relatório.
  8. Siga para as etapas em Criar uma nova função de RLS.

Opção 2

  1. Abra um relatório de Procore Analytics no desktop Power BI.
  2. Clique na visualização De modelo .


     
  3. Verifique a relação entre as tabelas "Projetos" e "project_users". A relação deve ter um (1) ao lado da tabela "projetos" e um asterisco (*) ao lado da tabela "project_users".
     Ponta
    Para visualizar apenas as tabelas "Projetos" e "project_users" (conforme mostrado abaixo), clique no ícone de adição (+) ao lado da guia "Todas as tabelas" para criar um novo layout e adicionar as tabelas "Projeto" e "Usuário do projeto" ao layout arrastando e soltando-as no menu Propriedades > Campos no espaço cinza.
    relationship-models-analytics.png
  4. Selecione a relação clicando duas vezes na linha de conexão entre eles.
  5. Preencha o seguinte na janela "Editar relacionamento":
    • Em "Cardealidade", selecione Muitos para um (*:1) e marque a caixa de verificação "Tornar esta relação ativa". Essas opções devem ser selecionadas por padrão.
    • Em "Direção de filtro cruzado", selecione Ambos e marque o caixa de verificação "Aplicar filtro de segurança em ambas as direções".

      edit-relationship-analytics2.png
  6. Clique em OK para fechar a janela "Editar relacionamento".
  7. Salve o relatório.
  8. Siga para as etapas em Criar uma nova função de RLS.

Criar uma nova função de RLS

  1. Na guia "Modelagem", clique em Gerenciar funções.
  2. Na janela "Gerenciar funções", faça o seguinte em cada coluna:
    • Na coluna "Funções", clique em Criar e insira um nome para a função no campo "Nova função". Usuário do projeto é o nome da função usada na imagem abaixo.
    • Na coluna "Tabelas", selecione project_users.
    • Selecione Alternar para editor do DAX.
    • Na coluna "Expressão DOX do filtro de tabela", insira [email_address] %) nome de usuárioprincipalname().
      security-roles-analytics.png
  3. Clique em Salvar na janela "Gerenciar funções de segurança".
  4. Salve e publique o relatório.
  5. Siga para as etapas em Adicionar usuários a uma função de RLS.

Adicionar usuários a uma função de RLS

Depois que a relação da tabela de RLS estiver configurada, os usuários precisarão ser adicionados às funções de RLS no serviço Power BI para visualizar um relatório de Procore Analytics. Para obter mais informações, consulte RLS (segurança de nível de linha) da Microsoft com Power BI: trabalhando com membros icon-external-link.png.

  1. Abra um relatório de Procore Analytics no serviço Power BI.
  2. Em "Conjuntos de dados", clique nas reticências (...) ao lado do relatório para o qual deseja configurar o RLS e clique em Segurança.
  3. Selecione a função à qual deseja adicionar um ou mais usuários.
     Ponta
    O uso de grupos de distribuição do Office 365 pode simplificar o processo de adicionar vários usuários a uma função de RLS de uma só vez. Consulte Introdução ao microsoft's Get with Microsoft 365 Groups no Outlook icon-external-link.png.
  4. Digite os endereços de e-mail e clique em Adicionar.
  5. Clique em Salvar.