Exportar dados do usuário do Project para a web

Artigo
07/28/2023

Este artigo descreve como um administrador de locatário do Microsoft 365 pode exportar dados de um usuário específico de Project para a Web. Em seguida, o administrador pode optar por exibir os dados do usuário e decidir quais dados deseja disponibilizar ao usuário. Os dados da tarefa de Project para a Web são sincronizados com Planner para preencher a exibição "Atribuído a Mim" do usuário no Planner. Se você estiver interessado exclusivamente nos dados do projeto, poderá exportá-los de Project para a Web usando as etapas fornecidas abaixo. No entanto, se você também desejar exportar os dados específicos do Planner associados a essas tarefas de projeto, poderá fazê-lo exportando os dados da exibição "Atribuído a mim" em Planner.

Project para a Web dados são armazenados no Dataverse no Microsoft PowerApps. Este artigo descreve como você pode:

Exibir dados de Project para a Web de um usuário específico usando a função Localização Avançada em Dynamics 365.
Use um script do PowerShell para exportar dados sobre projetos específicos dos quais seu usuário fazia parte.

Requisitos

Você precisará do seguinte para procurar dados em um usuário específico por meio do recurso de pesquisa Localização Avançada:

Você precisa da Microsoft Entra ID do objeto (Microsoft Entra ID) do usuário. Você pode encontrá-lo no Centro de Microsoft Entra Administração.
Você precisa ser um administrador global em seu locatário do Microsoft 365. Você precisa disso para acessar o Centro de Dynamics 365 Administração.

Se você também quiser exportar e exibir informações sobre projetos específicos:

Você precisa ser um administrador de locatário.
Você precisa ter uma licença de Project Plano 1, Project Plano 3 ou Project Plano 5.

Métodos para encontrar os dados do usuário

Dependendo do tipo de dados de usuário que você precisa encontrar, há dois caminhos que você pode tomar na busca e exportação dos dados do usuário.

Localizar dados sobre o projeto do usuário e objetos de roteiro no Dataverse – use o recurso Localização Avançada no Centro de Dynamics 365 Administração para localizar todos os dados do usuário contidos no Dataverse (por exemplo, objetos relacionados a seus projetos e roteiros).
Encontre dados sobre projetos específicos aos quais seu usuário foi associado – use o script de exportação de projeto do PowerShell para obter detalhes sobre projetos específicos aos quais o usuário foi associado.

Localizar dados do usuário no Dataverse com o recurso de pesquisa Localização Avançada

Project para a Web informações do usuário que reside no Dataverse - como roteiro e objetos e propriedades do projeto - estão localizadas em soluções Dynamics 365 específicas. O recurso de pesquisa Localização Avançada no centro de Dynamics 365 Administração pode consultar entre entidades nessas soluções para encontrar as informações necessárias.

Entender Project para a Web dados do Dataverse e onde ele reside

Ao procurar dados de Project para a Web de um usuário específico no Dynamics 365 Dataverse, ele está localizado nestas cinco soluções de Dynamics 365:

Nome	Nome de exibição
PortfolioService	Serviço de Portfólio
msdyn_ProjectServiceCore	Project
MicrosoftDynamicsScheduling	Agendamento universal de recursos
msdynce_SchedulingPatch	Patch de agendamento
mydynce_Scheduling	Agendar

Você pode examinar especificamente qualquer uma dessas soluções Dynamics 365 para ter uma ideia das entidades que existem para ela. Entender as entidades existentes para uma solução específica pode ajudá-lo a entender o que procurar em sua consulta.

Para exibir entidades para uma solução Dynamics 365:

No centro de Administração Microsoft 365, em Administração centros, selecione Dynamics 365.
No Centro de Administração Dynamics 365, selecione a instância padrão e selecione Abrir.
Na página Configurações Dynamics 365, selecione o menu Configurações e, na seção Personalização, selecione Soluções.
Na página Todas as Soluções, selecione o Nome de Exibição da solução na qual você está interessado.
Na página de informações da solução, expanda Entidades para exibi-las.
Em cada entidade, você pode selecionar objetos específicos para obter mais detalhes sobre suas propriedades.

Usar o Advanced Find para pesquisar dados de usuário

Use Dynamics 365 pesquisa de Localização Avançada para procurar dados de Project para a Web para seu usuário. O Advanced Find pesquisará todas as soluções em sua instância do Dataverse. Em seguida, você pode baixar os resultados diretamente em uma planilha do Excel e determinar o que fornecer ao usuário.

No Centro de Administração Dynamics 365, selecione a instância padrão e selecione Abrir.
Na página Configurações Dynamics 365, selecione o menu Configurações e, na seção Personalização, selecione Soluções.
Selecione o botão Avançar Localizar .
Em Localização Avançada, no menu Procurar , selecione os objetos que você deseja pesquisar, como projetos ou roteiros do usuário.

Por exemplo, se você quiser exibir todos os roteiros dos quais seu usuário fez parte, selecione Roadmaps.
Para começar a criar sua consulta, selecione Selecionar e selecione os campos dos quais você precisa começar a pesquisar projetos ou roteiros dos quais seu usuário fazia parte. Você precisará dos usuários Microsoft Entra ID ou nome da conta.

Por exemplo:
- Para localizar todos os roadmaps pertencentes ao usuário, selecione o campo Proprietário e selecione Equals e, em seguida, insira o nome da conta para o usuário.
- Para localizar todos os roadmaps criados pelo usuário, selecione o campo Criado por e, em seguida, selecione Equals e, em seguida, insira o nome da conta para o usuário.
Quando terminar de selecionar seus critérios de pesquisa, na faixa de opções, selecione Editar Colunas.
Na página Editar colunas, selecione Adicionar colunas e selecione as colunas que você deseja incluir na consulta. Quando terminar, selecione OK.
Selecione Resultados para executar sua consulta.
Depois de receber seus resultados, você pode exportá-los para o Excel. Para fazer isso, selecione Exportar e selecione Planilha Estática.

Em seguida, você pode examinar os resultados para determinar quais dados deseja fornecer ao usuário.

Use o script de exportação para ver detalhes sobre projetos específicos

Se você precisar procurar mais detalhes contidos em projetos específicos aos quais o usuário foi associado, use o script ExportProjectContent PowerShell para obter mais informações sobre cada projeto. Com o script, você pode obter os seguintes arquivos para um projeto específico:

Arquivos de projeto (. MPP) para o projeto. Adicione o parâmetro -mppexport $true ao cmdlet para gerar arquivos .mpp dos planos do projeto.
Um arquivo XML que contém detalhes e configurações do projeto.

Obter as IDs do projeto dos projetos que você está interessado

Antes de executar o script, você precisa obter as IDs do Projeto dos projetos nos quais está interessado.

Supondo que você tenha usado a pesquisa de Localização Avançada para consultar os projetos do usuário e os tenha baixado em um arquivo do Excel, a coluna ID do Projeto é a primeira coluna da planilha do Excel, mas está oculta por padrão. Desmarcando a primeira coluna pode ser um pouco complicado, portanto, se você precisar de ajuda, consulte Desmarcando a primeira linha ou coluna em uma planilha.

Depois de desativar as colunas na planilha, procure o nome do projeto e procure o valor correspondente na coluna Project para encontrar a ID do Projeto para o projeto.

Instância do Dataverse.

Executar o script Exportar

Agora que você tem as IDs de Projeto dos projetos que você está interessado em examinar, use a função ExportProjectContent Windows PowerShell para obter mais informações. A função ExportProjectUserContent está incluída no módulo ProjectExport Windows PowerShell.

Baixe o módulo Project Export Windows PowerShell e primeiro desbloqueie o arquivo zip e descompacte os arquivos.

Observação

Depois de descompactar o script, execute o seguinte em Windows PowerShell para importar os módulos:

Import-Module -Name ./projectexport

Para executar a função ExportProjectContent:

Em Windows PowerShell, onde você importou o módulo, execute o seguinte cmdlet:

ExportProjectContent -ProjectId (ProjectID of the project) -OutputDirectory (Location to put files) -InstanceId "(Dataverse instance name)"

Você precisará configurar os seguintes parâmetros ao executar o script:

Parâmetro	Descrição
ProjectId	GUID do projeto no Dataverse. Você aprendeu a encontrar isso na seção anterior.
Outputdirectory	Local em que os arquivos de exportação são colocados.
InstanceId	O identificador da instância Dynamics 365 que você está usando.

Para localizar a ID da instância:

No Centro de Administração Dynamics 365, selecione a instância padrão e selecione Abrir.
Na página de configuração PowerApps, examine a primeira parte da URL para determinar o valor da ID da instância. No gráfico abaixo, o valor da ID da instância seria https://orgde6d15d8.crm.dynamics.com.

Como exemplo de como executar o script, se a ID do projeto for dd065460-02b8-e911-a989-000d3a170e10, você deseja que os arquivos de saída acessem C:\User1Project1 e o nome da instância da organização Dataverse for https://orgde6d15d8.crm.dynamics.com, você executará o script assim:

ExportProjectContent -ProjectID dd065460-02b8-e911-a989-000d3a170e10 -OutputDirectory C:\User1Project1 -InstanceId https://orgde6d15d8.crm.dynamics.com"

Quando o script for concluído, vá para o local OutputDirectory especificado para localizar os arquivos .json para o projeto.

3a215ea2-c650-49db-8200-47bd4a7e2278_2023-02-13T21-29-13Z.json

Se você tiver vários projetos, execute o script novamente para cada projeto, usando seu valor ProjectID correspondente.

Observe que você pode receber várias versões do seu arquivo .json, conhecido como instantâneos. Estas são versões do arquivo de projeto antes das alterações que estão sendo feitas nele. Os arquivos de instantâneo incluirão um carimbo de data/hora para informar quando eles foram levados. A versão atual do arquivo é aquela com o carimbo de data/hora mais antigo , que seria a data de criação do projeto.

Todos os instantâneos armazenados atualmente para o projeto são exportados. Os instantâneos podem ser desmarcados periodicamente dependendo de quão ativo o projeto está.

As definições de campo estão na Definição de Conteúdo de Exportação.

Exibir e exportar histórico do projeto

Abra a ferramenta Localização Avançada . No menu Procurar , selecione o objeto Histórico do Projeto.

Se você quiser filtrar em um projeto específico, escolha Selecionar, selecione a opção Projeto na caixa de diálogo suspensa e adicione o projeto para o qual deseja ver itens do Histórico do Projeto.

Quando terminar de selecionar seus critérios de pesquisa, na faixa de opções, selecione Editar Colunas.

Na página Editar colunas , selecione Adicionar colunas e selecione as colunas que você deseja incluir na consulta. Quando terminar, selecione OK.

Selecione Resultados para executar sua consulta.

Depois de receber seus resultados, você pode exportá-los para o Excel. Para fazer isso, selecione Exportar e selecione Planilha Estática.

Use o portal do Power Apps para exibir as descrições dos diferentes campos armazenados com os dados do Histórico do Projeto. Abra a tabela Histórico do Projeto na solução msdyn_ProjectServiceCore_Patch . O campo msdyn_project é uma referência ao projeto relacionado. msdyn_projecttask é uma referência à tarefa associada (se aplicável). O campo msdyn_details é um objeto JSON que descreve os detalhes do registro de histórico. Mais informações sobre o que está contido no msdyn_details podem ser encontradas na Definição do Histórico de Tarefas.