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
Gere um token de inserção com acesso ao conjunto de dados. Se você usar o método de autenticação de usuário mestre , verifique se seu aplicativo tem os seguintes escopos: Dataset.Read.All
, Content.Create
e Workspaces.ReadWrite.all
. Consulte Token de Inserção – Gerar Token para obter mais informações.
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 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 getDatasetsInGroup
API REST e recuperar o CreateReportEmbedURL
. Consulte conjuntos de dados – Obter conjuntos de dados em grupo para obter mais informações.
Observação
Você deve ter permissões de compilação ou gravação no conjunto de dados para criar um novo relatório.
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 modos Exibir e Editar.
Permissões de token de acesso necessárias para edição
Gere um token de inserção com acesso ao relatório. Se você usar o método de autenticação de usuário mestre , verifique se seu aplicativo tem os seguintes escopos: Dataset.ReadWrite.All
e Report.ReadWrite.All
. Você também deve definir o allowEdit: true
sinalizador para cada relatório que o usuário final precisa editar. Consulte Token de Inserção – Gerar Token para obter mais informações.
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 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 inseriu um relatório regular e o modo de exibição deve estar em Editar. Certifique-se de definir o viewMode
parâmetro models.ViewMode.Edit
e 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 que foram 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
Gere um token de inserção com acesso ao relatório e ao conjunto de dados. Se você quiser salvar o relatório em outro workspace, o token precisará ter acesso ao workspace de destino. Se você usar o método de autenticação de usuário mestre , verifique se seu aplicativo tem os seguintes escopos: Report.ReadWrite.All
e Workspaces.ReadWrite.all
. Você também deve definir o allowEdit: true
sinalizador para cada relatório que o cliente precisa editar. Consulte Token de Inserção – Gerar Token para obter mais informações.
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 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 save
operação do 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
Ligue report.isSaved
para verificar se o relatório foi 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 de saveAs personalizada
Você pode criar uma caixa de diálogo personalizada saveAs
adicionando a configuração de useCustomSaveAsDialog: true
relatório ao objeto de configuração. Essa configuração oculta a caixa de diálogo padrão da interface do usuário.
O saveAsTriggered
evento é 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
a partir de sua caixa de diálogo personalizada. Confira Salvar uma cópia de um relatório para obter mais informações.
let saveAsParameters = {
name: "newReport"
targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};
report.saveAs(saveAsParameters);
Ouvir os eventos save and saveAs
O saved
evento é gerado quando uma salvação é disparada por uma save
ou saveAs
ação na interface do usuário ou usando as APIs. Veja Como lidar com eventos para obter mais informações.
report.on("saved", function (event) {
console.log(event);
});