Configuração dos registos de ações de fluxos de ambiente de trabalho

Esta página fornece orientações de configuração para os registos de fluxos de ambiente de trabalho, localizados na secção de caraterísticas do ambiente no centro de administração do Power Platform.

A definição Estado de ativação dos registos de ação de execução define quando os registos de ação de execução de fluxo de ambiente de trabalho devem ser capturados e até permite desativá-los completamente.

Pré-requisitos

• Licença premium do Power Automate e privilégios administrativos para configurar definições de registo
• Configurações do URL e do endereço IP do Power Automate
  • Cloud pública
  • Cloud da administração pública

Configurar a versão do registo de ações de fluxos de ambiente de trabalho

A Versão dos registos de ações permite-lhe escolher V1, V2 ou ambos.

O valor Tempo de vida da entidade FlowLogs em minutos determina por quanto tempo os registos de ação devem ser mantidos na tabela elástica de Registos de Fluxo. O Dataverse elimina automaticamente registos mais antigos do que o período de tempo especificado. Eis alguns valores de exemplo para sua comodidade.

Principais diferenças dos registos de fluxo de ambiente de trabalho V1 e V2

A tabela seguinte descreve as diferenças entre os registos de fluxo de ambiente de trabalho V1 e V2:

Os registos V2 oferecem melhorias significativas em relação à versão anterior, V1. O V2 utiliza a caraterística tabelas elásticas , que é excelente para gerir grandes volumes de dados, como cenários de registo de ações, e tem retenção de dados incorporada (TTL). Ideal para organizações que precisam de aceder a uma quantidade significativa de dados para relatórios, governação e integração com controlo automático de retenção de dados.

Cálculos de procura de capacidade do Dataverse para registos V2

A tabela seguinte mostra estimativas de consumo de armazenamento de base de dados de amostra do Dataverse por execução de fluxo de ambiente de trabalho quando são utilizados registos V2. Descreve a procura de armazenamento aproximada para diferentes números de ações, assumindo uma média de 3 KB de armazenamento por ação.

Consultar dados dos registos V2

O acesso aos dados dos registos de ação do fluxo de ambiente de trabalho pode ser alcançado fazendo uma chamada à API para o back-end do Dataverse, usando a sintaxe de chamada à API tradicional ou através do novo método ExecuteCosmosSqlQuery. Este método permite executar uma consulta SQL relativamente ao Dataverse, permitindo a obtenção e filtragem de dados.

O modelo de dados dos registos V2 baseia-se numa relação elemento principal-subordinado entre as tabelas Sessão de Fluxo e Registo de Fluxo. Cada registo herda permissões do respetivo registo de sessão de fluxo principal. Para consultar os registos de ação de uma execução de fluxo de ambiente de trabalho específica, pode utilizar a seguinte sintaxe de consulta.

Sintaxe de chamada à API tradicional do Dataverse

A chamada à API seguinte obtém uma sessão de fluxo específica pelo seu ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) e, em seguida, acede aos registos de ação associados utilizando a relação flowsession_flowlog_parentobjectid.

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid  

Nova sintaxe de chamada à API ExecuteCosmosSqlQuery através da tabela FlowLogs

    [Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
    QueryText=@p1,EntityLogicalName=@p2,QueryParameters=@p3,PageSize=@p4)?
    @p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
    @p2: 'flowlog'
    @p3: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p4: 50

Saiba mais sobre consultar colunas JSON em tabelas elásticas.

Dividir a chamada em partes individuais

• O URL base (https://[minha organização].api.crm[minha região].dynamics.com/api/data/v9.2/) é o ponto final para a API Web do Dataverse.
• ExecuteCosmosSqlQuery é o método que está a ser chamado. Este método permite a execução de uma consulta SQL relativamente ao Dataverse.
• Os parâmetros para o método ExecuteCosmosSqlQuery são fornecidos entre parênteses após o nome do método:
  • QueryText=@p1: A consulta SQL a executar. Neste caso, a consulta seleciona várias propriedades de uma tabela onde o tipo é 100000001 (tipo de registo de ações de fluxo de ambiente de trabalho) e ordena os resultados pela propriedade startTime por ordem decrescente.
  • EntityLogicalName=@p2: esta secção é o nome lógico da tabela (flowlog) que armazena os registos de ação.
  • QueryParameters=@p3: esta secção é um objeto JSON que especifica parâmetros para a consulta. No exemplo anterior, está a especificar um par chave-valor onde as chaves são @referencingParentId e @referencingParentLogicalName com os valores de flowsessionid (GUID) e tipo de tabela flowsession.
  • PageSize=p4: Esta secção é o tamanho da página de consulta.

Limitações conhecidas

• Os registos V2 só estão disponíveis para execuções de fluxos de ambiente de trabalho que são iniciados a partir de um fluxo de cloud através da ação de conector de fluxo de ambiente de trabalho.
• Atualmente, não há suporte para trabalhos de exclusão em massa para a tabela Registo de fluxo .
• Os registos do registo de fluxos ainda não podem ser visualizados na secção Tabela do Maker Portal (make.powerapps.com).
• Alterar a versão do registo de ações não migra os registos de ação de fluxo de ambiente de trabalho anteriores para o novo tipo de armazenamento de registos.