Compartilhar via

Pasta do relatório do projeto do Power BI Desktop

  • Artigo

Importante

Os projetos do Power BI Desktop estão atualmente em versão prévia.

Este artigo descreve os arquivos e subpastas na pasta Relatório de um projeto do Microsoft Power BI Desktop. Os arquivos e subpastas aqui representam um relatório do Power BI. Dependendo do projeto, a pasta de relatório pode incluir:

1 – este arquivo é necessário.

Nem toda pasta de relatório de projeto inclui todos os arquivos e subpastas descritos aqui.

Arquivos de relatório

.pbi\localSettings.json

Contém configurações de relatório que se aplicam somente ao usuário atual e ao computador local. Deve ser incluído no gitIgnore ou em outras exclusões de controle do código-fonte. Por padrão, o Git ignora esse arquivo.

Para obter mais informações, confira o documento de esquema localSettings.json.

CustomVisuals\

Uma subpasta que contém metadados para visuais personalizados no relatório. O Power BI dá suporte a três tipos de visuais personalizados:

  • Visuais de repositório organizacional – as organizações podem aprovar e implantar visuais personalizados no Power BI da organização. Para saber mais, confira o tópico Repositório da organização.
  • Visuais Power BI do AppSource – também conhecidos como "Visuais públicos personalizados". Esses visuais estão disponíveis no Microsoft AppSource. Os desenvolvedores de relatórios podem instalar esses visuais diretamente do Power BI Desktop.
  • Arquivos visuais personalizados – também conhecidos como "Visuais personalizados privados". Os arquivos podem ser carregados no relatório fazendo o upload de um pacote pbiviz.

Somente visuais personalizados privados são carregados na pasta CustomVisuals. Os visuais do AppSource e da Organização são carregados automaticamente pelo Power BI Desktop.

RegisteredResources\

Uma subpasta que inclui arquivos de recursos específicos para o relatório e são carregados pelo usuário, como temas personalizados, imagens e visuais personalizados (arquivos pbiviz).

Os desenvolvedores são responsáveis pelos arquivos aqui e há suporte para alterações. Por exemplo, você pode alterar um arquivo e, após a reinicialização do Power BI Desktop, o novo arquivo é carregado no relatório. Essa pasta pode desbloquear alguns cenários úteis, como:

  • Criar temas personalizados fora do Power BI Desktop usando o esquema público.
  • Aplicar alterações em lote, alterando o arquivo de recurso em vários relatórios. Por exemplo, você pode mudar o tema corporativo personalizado, alternar entre temas claros e escuros e alterar imagens de logotipo.

Cada arquivo de recurso deve ter uma entrada correspondente no arquivo report.json, que, durante a versão preliminar, não tem suporte para edição. Só há suporte para edições em arquivos RegisteredResources para recursos que já foram carregados e fazem com que o Power BI Desktop registre o recurso em report.json.

semanticModelDiagramLayout.json

Contém diagramas de modelo de dados que descrevem a estrutura do modelo semântico associado ao relatório. Durante versão prévia, este arquivo não tem suporte para edição externa.

definition.pbir

Contém a definição geral de um relatório e configurações básicas. Esse arquivo também contém a referência ao modelo semântico utilizado pelo relatório. O Power BI Desktop pode abrir um arquivo pbir diretamente, como se o relatório fosse aberto por um arquivo pbip. Abrir um pbir também abre o modelo semântico ao lado se houver uma referência relativa usando byPath.

Exemplo de definition.pbir:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    },
    "byConnection": null
  }
}

A definição inclui a propriedade datasetReference, que faz referência ao modelo semântico utilizado no relatório. A referência pode ser:

byPath - Especifica um caminho relativo para a pasta do modelo semântico de destino. Não há suporte para caminhos absolutos. Uma barra (/) é usada como separador de pastas. Quando usado, o Power BI Desktop também abre o modelo semântico no modo de edição completo.

byConnection - Especifica um modelo semântico remoto no serviço Power BI usando uma cadeia de conexão. Quando uma referência byConnection é usada, o Power BI Desktop não abre o modelo semântico no modo de edição.

Ao usar uma referência byConnection, as seguintes propriedades devem ser especificadas:

Propriedade Descrição
connectionString A cadeia de conexão referente ao modelo semântico remoto.
pbiModelDatabaseName A ID do modelo semântico remoto.
connectionType Tipo de conexão. Para modelo semântico remoto de serviço, esse valor deve ser pbiServiceXmlaStyleLive.
pbiModelVirtualServerName Uma propriedade interna que deve ter o valor, sobe_wowvirtualserver.

Exemplo usando byConnection:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": {
      "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/WorkpaceName;Initial Catalog=SemanticModelName;Integrated Security=ClaimsToken",
      "pbiServiceModelId": null,
      "pbiModelVirtualServerName": "sobe_wowvirtualserver",
      "pbiModelDatabaseName": "e244efd3-e253-4390-be28-6be45d9da47e",
      "connectionType": "pbiServiceXmlaStyleLive",
      "name": null
    }
  }
}

Quando o modelo semântico e o relatório compartilham o mesmo espaço de trabalho, Fabric Git Integration sempre usa uma byPath referência ao modelo semântico.

Para obter mais informações, confira o documento de esquema definition.pbir.

mobileState.json

Contém configurações de aparência e comportamento do relatório ao renderizar em um dispositivo móvel. Esse arquivo não dá suporte à edição externa.

report.json

Define um relatório, incluindo visuais, layout de página e interações pretendidas. Durante versão prévia, este arquivo não tem suporte para edição externa.

Mail Luck!.

Arquivo da plataforma do Fabric que contém propriedades vitais para estabelecer e manter a conexão entre os itens do Fabric e o Git.

Para saber mais, consulte a Integração do Git com arquivos de sistema gerados automaticamente.

Conteúdo relacionado