Criar, editar e salvar um relatório inserido

A análise integrada do Power BI permite que você crie, edite e salve relatórios inseridos. Um relatório pode ser criado com base em um conjunto de dados existente ou você pode editar um relatório existente. Você também pode salvar o relatório depois que ele foi criado ou editado.

Como criar um relatório

Saiba como criar um novo relatório em branco de um conjunto de dados existente.

Permissões de token de acesso necessárias para criar um relatório

Permissões necessárias do lado do cliente para criar um relatório

As seguintes permissões do lado do cliente são necessárias para criar um relatório:

• Criar – os usuários podem criar um novo relatório.

• Todos os – os usuários podem criar, exibir, editar, salvar e salvar uma cópia do relatório.

Criar um novo relatório

Crie um novo relatório em branco de um conjunto de dados existente. Você precisará de uma ID do conjunto de dados e da URL de inserção. Por exemplo, você pode usar a API REST getDatasetsInGroup e recuperar o CreateReportEmbedURL. Consulte Conjuntos de dados – Obter conjuntos de dados no grupo para obter mais informações.

let embedCreateConfiguration = {
    tokenType: tokenType,
    accessToken: accessToken,
    embedUrl: embedURL,
    datasetId: datasetId,
    settings: settings,
    theme: theme, // optional
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Create report
let report = powerbi.createReport(embedContainer, embedCreateConfiguration);

Você também tem a opção de criar um relatório com um tema aplicado a ele. Novos visuais adicionados ao relatório respeitarão o estilo do tema. Consulte Aplicar temas de relatório para obter mais informações.

Como editar um relatório

Saiba como editar um relatório existente e alternar entre os modos Exibir e Editar.

Permissões de token de acesso necessárias para edição

Permissões necessárias do lado do cliente para edição

As seguintes permissões do lado do cliente são necessárias para editar um relatório:

• Copiar – os usuários podem salvar uma cópia do relatório usando Salvar como.

• ReadWrite – os usuários podem exibir, editar e salvar o relatório.

• Todos os – os usuários podem criar, exibir, editar, salvar e salvar uma cópia do relatório.

Editar o relatório

Carregue o relatório existente no modo Editar. O relatório deve ser inserido da mesma forma que o aplicativo inseri um relatório regular e o modo de exibição deve estar em Editar. Certifique-se de definir o parâmetro viewMode como models.ViewMode.Edite se você tem as permissões de cliente certas.

let config = {
    type: 'report',
    tokenType: models.TokenType.Aad or models.TokenType.Embed,
    accessToken: YourAccessToken,
    embedUrl: YourEmbedUrl,
    id: YourEmbedReportId,
    permissions: models.Permissions.All,
    viewMode: models.ViewMode.Edit,
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Embed report
let report = powerbi.embed(embedContainer, config);

Agora, o usuário pode editar o relatório com base nas permissões de habilitadas.

Você também pode alternar entre os modos Editar e Exibir depois que o relatório é carregado.

report.switchMode("view");

Para alternar para o modo de edição:

report.switchMode("edit");

Como salvar um relatório

Saiba como salvar um relatório, incluindo opções adicionais, como salvar uma cópia de um relatório e salvar um relatório em outro workspace.

Permissões de token de acesso necessárias para salvar

Permissões necessárias do lado do cliente para salvar

As seguintes permissões do lado do cliente são necessárias para salvar um relatório:

• ReadWrite – os usuários podem exibir, editar e salvar o relatório.

• Criar – os usuários podem criar um novo relatório.

• Copiar – os usuários podem salvar uma cópia do relatório usando Salvar como.

• Todos os – os usuários podem criar, exibir, editar, salvar e salvar uma cópia do relatório.

Salvar um relatório

Ao criar um relatório, o relatório não será salvo até que você chame a operação save no menu de arquivo ou JavaScript.

report.save();

Salvar uma cópia de um relatório

Salve uma cópia adicional com um nome diferente. A cópia do relatório será salva no mesmo workspace que o conjunto de dados do relatório.

let saveAsParameters = {
    name: "newReport"
};

report.saveAs(saveAsParameters);

Você também pode salvar seu relatório em outro workspace. Verifique se você tem as permissões certas para o workspace de destino.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Verifique se o relatório foi salvo

Chame report.isSaved para garantir que o relatório seja salvo. Esse método pode ajudar a evitar a perda de alterações não salvas.

let isReportSaved = await report.isSaved();

Criar uma experiência saveAs personalizada

Você pode criar uma caixa de diálogo saveAs personalizada adicionando a configuração de relatório useCustomSaveAsDialog: true ao objeto de configuração. Essa configuração oculta a caixa de diálogo padrão da interface do usuário.

O evento saveAsTriggered é gerado quando um usuário clica em Salvar como na interface do usuário. Use essas informações para mostrar sua caixa de diálogo personalizada.

report.on("saveAsTriggered", function (event) {
    console.log(event);
});

Para executar uma operação salvar como, você pode chamar report.saveAs da caixa de diálogo personalizada. Consulte Salvar uma cópia de um de relatório para obter mais informações.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Ouvir os eventos salvar e salvar como

O evento saved é gerado quando um salvamento é disparado por uma ação save ou saveAs na interface do usuário ou usando as APIs. Consulte Como lidar com eventos para obter mais informações.

report.on("saved", function (event) {
    console.log(event);
});

Conteúdo relacionado

• Associar conjuntos de dados dinamicamente a um relatório
• Usar inserção em fases](phased-embedding.md)
• visão geral da criação de relatório