Restaurar registros de tabela do Microsoft Dataverse excluídos

Como parte dos processos comerciais regulares com Microsoft Dataverse, os usuários geralmente excluem registros ou transações manual ou sistematicamente, planejados ou por acidente, por meio de processos do sistema, seleção única, várias seleções e exclusão em massa. A recuperação de dados excluídos é difícil e, geralmente, os registros nem sempre podem ser recuperados. Para resolver essa limitação, o gerenciamento de registros excluídos desse ambiente está disponível para recuperar dados de registro de tabela da maioria dos tipos de cenários de exclusão em um período de tempo configurável especificado.

Os desenvolvedores devem ler Restaurar registros excluídos com código para aprender a interagir com essa configuração usando código.

Pré-requisitos

Para restaurar registros do Dataverse excluídos, ative a configuração Manter registros do Dataverse excluídos em seu ambiente.

Manter excluídos os registros do Dataverse

  1. Entre no centro de administração do Power Platform como administrador (administrador Dynamics 365 ou administrador Microsoft Power Platform).
  2. Selecione Gerenciar>Ambientes e abra o ambiente desejado.
  3. Selecione Configurações>Produto>Recursos.
  4. Role para baixo para exibir a área de registros excluídos e selecione a opção Manter registros do Dataverse excluídos .
  5. Na caixa Manter registros excluídos (dias), insira o número de dias, entre 1 e 30, para manter registros excluídos.
  6. Clique em Salvar.
  7. Permita 30 minutos para o sistema definir a configuração.

    Note

    Você só pode restaurar registros excluídos depois que a configuração é ativada.

Exibir e restaurar os registros excluídos no Power Apps

Você pode gerenciar proativamente o armazenamento usado por registros excluídos. A qualquer momento, você pode liberar esse armazenamento selecionando a opção Excluir todos os registros , que remove permanentemente todos os itens excluídos que consomem armazenamento no momento.

Centro de administração do Power Platform

Para restaurar registros excluídos do centro de administração, entre no centro de administração do Power Platform como um usuário com a função de segurança do administrador do sistema e conclua as etapas a seguir.

  1. Selecione Gerenciar.
  2. Selecione Ambientes e abra o ambiente no qual você quer exibir e restaurar os registros excluídos.
  3. Vá para Configurações>Gerenciamento de Dados>Registros Excluídos.
  4. Exiba todos os registros excluídos de todas as tabelas.
  5. Selecione um ou mais registros que você deseja restaurar e, em seguida, selecione Restaurar na barra de comandos.
  6. Selecione OK para confirmar a ação de restauração.

Aplicativo das configurações de ambiente do Power Platform

Para restaurar registros excluídos do aplicativo de Configurações do Ambiente do Power Platform:

  1. Entre no ambiente do Power Platform como usuário com o direito de acesso do administrador do sistema.
  2. Selecione o aplicativo Configuração de Ambiente do Power Platform ou selecione Configurações>Configurações Avançadas.
  3. Vá para Sistema>Gerenciamento de Dados>Registros Excluídos.
  4. Exiba todos os registros excluídos de todas as tabelas.
  5. Selecione um ou mais registros a serem restaurados e selecione Restaurar na barra de comandos.
  6. Selecione OK para confirmar a restauração.

Solução de problemas e limitações

A configuração de registros excluídos só dá suporte a operações de exclusão

A configuração de registros excluídos só dá suporte a operações de exclusão, não a atualizações.

A operação de restauração só dá suporte a registros

A operação de restauração só dá suporte a registros. Ele não oferece suporte à recuperação de organizações ou tabelas.

Alguns registros não são restaurados

Algumas organizações adicionam lógica de negócios personalizada que exclui registros relacionados a um registro que foi excluído. Para restaurar registros relacionados excluídos pela lógica de negócios personalizada, você precisa aplicar a lógica oposta na Restore operação para recuperar os registros quando você restaurar o registro original que foi excluído.

Você pode restaurar registros excluídos por meio do processo de comportamento em cascata do relacionamento da tabela. Para obter mais informações sobre o comportamento em cascata, consulte Configurar o comportamento em cascata da relação de tabela.

Os registros excluídos não aparecem depois de ativar a configuração Manter registros do Dataverse excluídos

Antes de solucionar problemas

Os registros excluídos só são mantidos depois que a configuração Manter registros do Dataverse excluídos estiver ativada . Os registros excluídos antes de você ativar a configuração não podem ser restaurados.

Ativar a configuração Manter registros do Dataverse excluídos dispara uma tarefa de sistema em segundo plano chamada Ativar a manutenção de dados excluídos para a organização. Esse trabalho deve ser concluído com êxito antes que os registros excluídos sejam mantidos para restauração posteriormente. Mesmo que a configuração esteja ativada, isso não garante que o trabalho tenha sido concluído.

Como o trabalho funciona

  • Quando você ativa a configuração, o trabalho do sistema é criado automaticamente e começa a ser executado.
  • Se o trabalho for bem-sucedido, ele será removido automaticamente da lista de Trabalhos do Sistema . Sua ausência significa sucesso.
  • Se o trabalho falhar, ele permanecerá na lista por alguns dias para que você possa abri-lo e exibir os detalhes do erro.

Verificar o status da tarefa do sistema

  1. Abra o centro de administração do Power Platform.
  2. Selecione o ambiente em que o problema está ocorrendo.
  3. Vá para Configurações>Auditoria e logs>Trabalhos do sistema.
  4. Na página Todos os Trabalhos do Sistema, pesquise por Habilitar manutenção dos dados excluídos para a Organização.

Interpretando o que você vê

O que você vê O que significa Ação
O trabalho não está listado O trabalho foi concluído e removido automaticamente. Este é o resultado esperado. Verifique se o registro excluído recentemente aparece em Configurações>Gerenciamento de dados>Registros excluídos.
O trabalho está listado, Status: Bem-sucedido O trabalho foi concluído com êxito, mas ainda não foi limpo. Nenhuma ação é necessária.
O trabalho está listado, Status: Falha A tarefa encontrou um erro. Abra o trabalho para exibir detalhes do erro e contate o suporte.
O trabalho está listado, Status: Aguardando ou em andamento O trabalho ainda está em execução. Aguarde alguns minutos e atualize.

Quando entrar em contato com o suporte

Entre em contato com um representante de suporte Microsoft se alguma das seguintes opções se aplicar:

  • O trabalho indica Falha e não é possível resolver o erro com os detalhes fornecidos.
  • O trabalho não está mais listado (ou mostra Sucesso), mas os registros excluídos ainda não aparecem em Configuração>Gerenciamento de dados>Registros excluídos
  • Já se passaram mais de 30 minutos desde que você ativou a configuração, mas os registros excluídos ainda não aparecem em Configurações>Gerenciamento de Dados>Registros Excluídos.

Registros excluídos por meio de comportamentos em cascata não estão presentes na exibição Registros Excluídos

Registros excluídos por meio de comportamentos automatizados em cascata não podem ser restaurados de maneira independente. Você precisa restaurar esses registros na ordem na qual foram excluídos. O registro original que foi excluído deve ser restaurado antes de quaisquer registros relacionados que foram excluídos por meio de comportamentos em cascata automatizados.

Para obter mais informações sobre o comportamento em cascata, consulte Configurar o comportamento em cascata da relação de tabela.

Não há suporte para tabelas

Quando a configuração de registros excluídos está geralmente disponível, ela é habilitada para a maioria das tabelas.

Algumas tabelas não dão suporte à restauração de registros excluídos. Essas tabelas incluem:

Verifique a contagem de atributos de uma entidade específica usando {organizationUrl}/api/data/v9.0/EntityDefinitions(LogicalName='account')/Attributes?$count=true.

Os desenvolvedores podem detectar quais tabelas estão habilitadas para manutenção de registros excluídos em seu ambiente.

Tabelas nas quais a definição de registros excluídos não oferece suporte

A partir de agosto de 2024, a consulta para detectar quais tabelas não têm o recurso de registros excluídos habilitado retorna essas tabelas em um ambiente dataverse descustomizado.

Seu ambiente pode retornar resultados diferentes. Talvez não haja suporte para tabelas se você personalizá-las adicionando um grande número de colunas.

aaduser
aicopilot
aiplugin
aipluginconversationstartermapping
aipluginexternalschemaproperty
aipluginoperation
aipluginoperationresponsetemplate
annualfiscalcalendar
appaction_appactionrule_classicrules
appactionrule
appconfig
application
applicationuser
applicationuserrole
appmodulecomponent
appnotification
asyncoperation
attributeimageconfig
backgroundoperation
bot_botcomponent
bot_environmentvariabledefinition
botcomponent_aipluginoperation
botcomponent_connectionreference
botcomponent_environmentvariabledefinition
botcomponent_workflow
bulkdeletefailure
businessunit
callbackregistration
card
cardstateitem
catalogassignment
columnmapping
componentversion
componentversionnrddatasource
connectionreference
connectionroleassociation
copilotexamplequestion
copilotsynonyms
customapi
customapiresponseproperty
customcontroldefaultconfig
datalakefolder
datalakeworkspace
dataprocessingconfiguration
desktopflowbinary
displaystring
duplicaterulecondition
dvfilesearchattribute
dvtablesearch
dvtablesearchentity
entity
entitydataprovider
entityindex
entityrecordfilter
environmentvariabledefinition
eventexpanderbreadcrumb
expiredprocess
fabricaiskill
federatedknowledgeconfiguration
fieldpermission
fixedmonthlyfiscalcalendar
flowlog
flowmachinegroup
flowmachineimageversion
flowrun
goal
importentitymapping
importjob
importmap
interactionforemail
kbarticletemplate
lookupmapping
mainfewshot
managedproperty
metadataforarchival
mobileofflineprofileitem
mobileofflineprofileitemfilter
msdyn_aiconfiguration
msdyn_aitemplate
msdyn_componentlayer
msdyn_connectordatasource
msdyn_dataflow_datalakefolder
msdyn_dataflowtemplate
msdyn_dmsrequest
msdyn_entitylinkchatconfiguration
msdyn_helppage
msdyn_knowledgeassetconfiguration
msdyn_knowledgesearchfilter
msdyn_modulerundetail
msdyn_odatav4ds
msdyn_pmbusinessruleautomationconfig
msdyn_pmcalendarversion
msdyn_pmprocessextendedmetadataversion
msdyn_pmprocessusersettings
msdyn_pmrecording
msdyn_pmview
msdyn_salesforcestructuredqnaconfig
msdyn_slakpi
msdyn_solutioncomponentcountsummary
msdyn_solutioncomponentsummary
msdyn_solutionhistorydatasource
msdyn_tour
mspp_adplacement
mspp_columnpermissionprofile
mspp_entityform
mspp_entitylist
mspp_pagetemplate
mspp_powerpagescoreentityds
mspp_publishingstatetransitionrule
mspp_shortcut
mspp_sitesetting
mspp_webform
mspp_webformstep
mspp_weblinkset
mspp_webpageaccesscontrolrule
mspp_website
mspp_websitelanguage
navigationsetting
nlsqregistration
ownermapping
pluginassembly
plugintracelog
position
powerbimashupparameter
powerfxrule
powerpagecomponent_powerpagecomponent
powerpagesite_dvfilesearch
powerpageslog
principalentitymap
privilegesremovalsetting
processstage
publisher
quarterlyfiscalcalendar
queuemembership
recordfilter
recyclebinconfig
relationshipattribute
reportcategory
retaineddataexcel
ribbonmetadatatoprocess
roleeditorlayout
roletemplate
runtimedependency
savedqueryvisualization
sdkmessagefilter
sdkmessageprocessingstepimage
searchtelemetry
serviceendpoint
serviceplanappmodules
serviceplanmapping
sharepointsite
sitemap
slaitem
solution
solutioncomponentattributeconfiguration
solutioncomponentconfiguration
solutionhistorydata
subscriptionsyncentryoffline
synapselinkprofile
synapselinkschedule
systemform
systemuserauthorizationchangetracker
systemuserroles
teamprofiles
teamtemplate
tracelog
transformationparametermapping
userform
userquery
virtualentitymetadata
webwizard
workflowbinary
workflowlog
workqueueitem

activityfileattachment
aicopilot_aiplugin
aipluginconversationstarter
aipluginexternalschema
aiplugininstance
aipluginoperationparameter
aiplugintitle
appaction
appactionmigration
appactionrule_webresource_scripts
appconfiginstance
applicationroles
applicationuserprofile
appmodule
appmoduleroles
appointment
attribute
attributemaskingrule
bot
bot_botcomponentcollection
botcomponent
botcomponent_botcomponent
botcomponent_dvtablesearch
botcomponent_msdyn_aimodel
botcomponentcollection
bulkdeleteoperation
calendar
canvasapp
cardentityconnections
catalog
channelaccessprofileentityaccesslevel
complexcontrol
componentversiondatasource
connectioninstance
connectionrole
connector
copilotglossaryterm
credential
customapirequestparameter
customcontrol
customcontrolresource
datalakefolderpermission
datalakeworkspacepermission
dependency
desktopflowmodule
duplicaterule
dvfilesearch
dvfilesearchentity
dvtablesearchattribute
elasticfileattachment
entityanalyticsconfig
entityimageconfig
entitykey
entityrelationship
environmentvariablevalue
exchangesyncidmapping
exportedexcel
featurecontrolsetting
federatedknowledgeentityconfiguration
fieldsecurityprofile
flowcredentialapplication
flowmachine
flowmachineimage
flowmachinenetwork
fxexpression
import
importfile
importlog
indexattributes
invaliddependency
keyvaultreference
mailmergetemplate
managedidentity
maskingrule
mobileofflineprofile
mobileofflineprofileitemassociation
monthlyfiscalcalendar
msdyn_aimodel
msdyn_appinsightsmetadata
msdyn_componentlayerdatasource
msdyn_dataflow
msdyn_dataflowconnectionreference
msdyn_datalakeds
msdyn_dmsrequeststatus
msdyn_formmapping
msdyn_insightsstorevirtualentity
msdyn_knowledgemanagementsetting
msdyn_mobileapp
msdyn_nonrelationalds
msdyn_pmanalysishistory
msdyn_pmcalendar
msdyn_pminferredtask
msdyn_pmprocesstemplate
msdyn_pmprocessversion
msdyn_pmtemplate
msdyn_salesforcestructuredobject
msdyn_schedule
msdyn_solutioncomponentcountdatasource
msdyn_solutioncomponentdatasource
msdyn_solutionhistory
msdyn_timelinepin
msdyn_workflowactionstatus
mspp_columnpermission
mspp_contentsnippet
mspp_entityformmetadata
mspp_entitypermission
mspp_pollplacement
mspp_publishingstate
mspp_redirect
mspp_sitemarker
mspp_webfile
mspp_webformmetadata
mspp_weblink
mspp_webpage
mspp_webrole
mspp_websiteaccess
mspp_webtemplate
newprocess
optionset
picklistmapping
pluginpackage
plugintype
powerbidataset
powerbireport
powerpagecomponent
powerpagesite
powerpagesitelanguage
principalentitybusinessunitmap
privilege
processsession
processtrigger
publisheraddress
queue
recentlyused
recurringappointmentmaster
relationship
report
reportparameter
retentionconfig
role
roleprivileges
roletemplateprivileges
savedquery
sdkmessage
sdkmessageprocessingstep
searchresultscache
semiannualfiscalcalendar
serviceplan
serviceplancustomcontrol
sharedlinksetting
similarityrule
sla
slakpiinstance
solutioncomponent
solutioncomponentbatchconfiguration
solutioncomponentrelationshipconfiguration
subscriptionstatisticsoffline
synapsedatabase
synapselinkprofileentity
syncerror
systemuser
systemuserprofiles
teammobileofflineprofilemembership
teamroles
template
transformationmapping
translationprocess
usermobileofflineprofilemembership
userqueryvisualization
webresource
workflow
workflowcardconnections
workqueue

Restaurar registros excluídos com código