Definição do esquema de análise de gestão personalizada do Microsoft Power Platform (pré-visualização)
[Este artigo inclui documentação pré-versão e está sujeito a alterações.]
Este tópico aborda o conteúdo dos dados exportados do Power Platform para localizações de armazenamento do Azure Data Lake Gen2.
Importante
- Esta é uma caraterística de pré-visualização.
- As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas funcionalidades estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.
- Esta caraterística está a ser implementada gradualmente em todas as regiões e pode ainda não estar disponível na sua região.
Estrutura da saída de dados
Ao exportar dados de inventário e de utilização do Power Apps e Power Automate para o seu Data Lake Storage, a análise de gestão personalizada disponibiliza os dados num formato de esquema Common Data Model. Estes metadados baseados no Common Data Model permitem partilhar os seus dados em todas as aplicações e processos de negócio, como o Power Apps, o Power Automate, o Power BI, o Dynamics 365 e o Azure.
O ficheiro de exportação de dados inclui:
Um inventário completo de todas as aplicações, fluxos, conectores e metadados associados que existem no inquilino.
Dados de utilização compostos por dados a partir do momento em que a exportação começa.
Após a primeira vez que gera uma exportação de dados, o Power Automate gera atualizações diárias incrementais. Cada atualização diária inclui detalhes sobre todas as aplicações novas e existentes, incluindo informações de conector. A exportação de dados contém o ID do objeto principal (userid) do Microsoft Entra. Opcionalmente, pode utilizar ainda mais o Microsoft Entra para obter nomes de utilizadores e unidades de negócio reais, tais como marketing, vendas ou finanças.
Estrutura de pastas do Power Apps
A principal pasta raiz do Power Apps tem a seguinte estrutura de pasta:
- \Aplicações
- \ConnectionReference
- \Ligações
- \Ambientes
- \Utilização
Estrutura de pastas do Power Automate
A principal pasta raiz do Power Automate tem a seguinte estrutura de pasta:
- \Fluxos
- \FlowsConnectionReference
- \Utilização
Ver os dados e as pastas dentro do portal do Azure
Os dados listados nestas pastas podem ser vistos através do seu portal do Azure. Para obter mais informações, aceda a https://portal.azure.com. Em seguida, navegue para a sua conta de armazenamento (Base>Subscrições>o nome da sua subscrição>Grupos de Recursos>o seu grupo de recursos>as suas contas de armazenamento>Conta de Armazenamento).
A estrutura dos contentores e pastas dentro do data lake
A pasta principal está no formato de data aaaa-mm-dd (por exemplo, 2020-02-28).
A pasta raiz contém duas pastas: Metadados e KPI:
- A pasta Metadados contêm os dados de inventário numa lista de ficheiros, uma para cada região.
- A pasta KPI contém dados de utilização.
Tabelas de definição de esquema
As tabelas a seguir detalham as definições de esquema dos dados. Os metadados são considerados dados de inventário.
Subpasta do Power Apps
Aplicações
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| AppName | Guid | ID da aplicação exclusivo que pode ser utilizado para unir tabelas |
| Nome | Texto longo | Nome da aplicação |
| Descrição | Longtext | Descrição da aplicação (atualmente indisponível) |
| tenantId | GUID | ID de inquilino do cliente |
| EnvironmentId | Texto longo | ID do Ambiente |
| Type | Texto longo | Aplicação criada com o Power Apps |
| Subtipo | Texto longo | Tela | Modelo | Páginas |
| DocumentVersion | Datetime | O carimbo de data e hora é utilizar como versão da aplicação |
| Uri | Texto longo | URI da aplicação |
| Lifecyclestate | Texto longo | Rascunho | Publicado |
| DocumentUri | Texto longo | URI de informações da aplicação |
| IconUri | Longtext | URI do Ícone da aplicação |
| Proprietário | Longtext | Nome do proprietário da aplicação |
| createdPrincipalId | GUID | ID do objeto do Microsoft Entra do principal do criador da aplicação |
| CreatedTime | Datetime | Data em que a aplicação foi criada |
| lastModifiedPrincipalId | GUID | ID do objeto do Microsoft Entra do último utilizador modificado |
| lastModifiedTime | Datetime | Data em que a aplicação foi atualizado pela última vez |
| lastenabledprincipalId | GUID | ID do objeto do Microsoft Entra do último utilizador publicado |
| lastEnabledTime | Datetime | Data em que a aplicação foi publicada pela última vez |
| DeletedTime | Datetime | Data em que a aplicação foi eliminada |
| DeletedprincipalId | Texto longo | ID do objeto do Microsoft Entra do utilizador que eliminou a aplicação |
| sharedUsers | Int | Número de utilizadores com quem a aplicação é partilhada |
| sharedGroups | Int | Número de grupos com quem a aplicação é partilhada |
| Solução | Longtext | ID da solução a que a aplicação pertence |
| Creationtype | Texto longo | Gerado | Descartar desenvolvimento |
| embeddingHost | Texto longo | Teams | Power Apps | Power BI |
| Definições | Texto longo | Reservado |
| customExtensions | Texto longo | Reservado |
Referência de ligação
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| resourceId | Guid | ID da aplicação exclusivo (pode ser utilizado para unir a Tabela de utilização) |
| Nome a apresentar | Texto longo | Nome descritivo introduzido pelo utilizador – por exemplo, Office 365 Outlook |
| connectionrefId | GUID | ID de ligação exclusivo |
| EnvironmentId | Texto longo | ID do Ambiente |
| Escalão | Texto longo | Premium ou Standard |
| Type | Texto longo | Tipo de ligação – por exemplo, SQL, Office 365 ou Azure |
Ligações
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| ConnectionId | Guid | ID de ligação exclusivo |
| connectionName | Texto longo | Nome descritivo introduzido pelo utilizador – por exemplo, Office 365 Outlook |
| apiId | GUID | Tipo de conector |
| EnvironmentId | Texto longo | ID do Ambiente |
| Displayname | Texto longo | URI da ligação |
| isCustomApi | Texto longo | Sim | Não |
| createdPrincipalId | GUID | ID do objeto do Microsoft Entra do principal do criador da aplicação |
| CreatedTime | Datetime | Data em que a aplicação foi criada |
| Swaggerurl | Longtext | URL do Swagger para a API personalizada |
| tenantId | GUID | ID de inquilino do cliente |
Ambientes
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| Environmentid | Longtext | ID do Ambiente |
| nome | Texto longo | Nome do ambiente |
| Finalidade | Longtext | Detalhes sobre aquilo para o que o contentor do ambiente foi criado |
| tenantGuid | GUID | ID de inquilino do cliente |
| Environmentstate | Texto longo | Ativado | Desativado |
| environmenttype | Texto longo | Sandbox | Produção | Avaliação | Teams |
| Securitygroup | Texto longo | ID do grupo de segurança do proprietário |
| Environmentregion | Longtext | Localização geográfica do ambiente |
| EnvironmentUrl | Longtext | URL do Ambiente |
| é Predefinido | Longtext | Valor booleano para indicar se este é o ambiente predefinido |
| CdsInstanceURL | Texto longo | URI do Ambiente |
| CdsInstanceId | GUID | Identificador do ambiente |
| createdPrincipalId | GUID | ID do objeto do Microsoft Entra do principal do criador da aplicação |
| CreatedTime | Datetime | Data em que a aplicação foi criada |
| lastModifiedPrincipalId | GUID | ID do objeto do Microsoft Entra do utilizador que modificou a aplicação pela última vez |
| lastModifiedTime | Datetime | Data em que a aplicação foi atualizado pela última vez |
| DeletedTime | Datetime | Data em que a aplicação foi eliminada |
| DeletedprincipalId | Texto longo | ID do objeto do Microsoft Entra do utilizador que eliminou a aplicação |
Utilização
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| AppId | GUID | ID da aplicação exclusivo (pode ser utilizado para unir tabelas) |
| environmentId | GUID | ID do Ambiente |
| tenantId | GUID | ID de inquilino do cliente |
| ObjectID | GUID | ID do objeto do utilizador do Microsoft Entra |
| SessionId | GUID | ID da Sessão |
| timeaccessed | Datetime | A hora em que o utilizador abriu ou acedeu à aplicação |
| País/região | Longtext | O país a partir do qual a aplicação é aberta; é filtro |
| plataforma | Texto longo | Plataforma ou sistema operativo a partir do qual a aplicação é aberta (ver a nota a seguir a esta tabela) |
| PlayerVersion | Texto Longo | A versão do leitor do Power Apps a partir da qual a aplicação é aberta |
| AppVersion | Datetime | Versão da aplicação |
| Browsername | Longtext | Browser do cliente |
| DataVersion | Int(11) | Dados de tabela, não relacionados com o utilizador |
Subpasta do Power Automate
Fluxos
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| ResourceId | GUID | ID do fluxo exclusivo (pode ser utilizado para unir tabelas) |
| name | LongText | Nome do fluxo |
| type | LongText | Power Automate |
| subtipo | LongText | Fluxo de Cloud |
| environmentId | GUID | ID do Ambiente |
| resourceVersion | LongText | Versão do fluxo |
| lifecycleState | LongText | Rascunho, Publicado |
| events_created_timestamp | Datetime | Data em que o fluxo foi criado |
| events_created_principalId | GUID | ID do objeto do Microsoft Entra do principal criador do fluxo |
| events_lastModified_timestamp | Datetime | Data em que o fluxo foi atualizado pela última vez |
| sharedUsers | número inteiro | Número de utilizadores com quem o fluxo é partilhado |
| sharedGroups | número inteiro | Número de grupos com quem o fluxo é partilhado |
FlowsConnectionReference
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| resourceId | GUID | ID do fluxo exclusivo (pode ser utilizado para unir tabelas) |
| tenantId | GUID | ID de inquilino do cliente |
| environmentId | GUID | ID do Ambiente |
| connectionrefId | LongText | ID da Referência de Ligação exclusivo |
| connectorType | LongText | Tipo de conector utilizado pelo fluxo |
| connectionId | LongText | ID de ligação exclusivo |
| displayName | LongText | Nome da referência de ligação |
| escalão | LongText | Standard, Premium |
Utilização
| Nome da propriedade | Tipo de propriedade | Descrição |
|---|---|---|
| resourceId | GUID | ID do recurso exclusivo (pode ser utilizado para unir tabelas) |
| environmentId | GUID | ID do Ambiente |
| tenantid | GUID | ID de inquilino do cliente |
| timeaccessed | Datetime | A hora em que o utilizador abriu ou acedeu à aplicação |
| estado | LongText | Com êxito, Falhado, Cancelado, Terminado |
| subType | LongText | Fluxo de Cloud |
| execuções | Int | Número de execuções |
Nota
- As versões mais recentes dos sistemas operativos de plataforma geralmente bem conhecidos devem conter dados, mas em alguns casos estes dados poderão não estar disponíveis.
- Existe um problema conhecido para aplicações condicionadas por modelo em que o valor createdPrincipalID é null.