Annulla archiviazione Apex

Annullando l'archiviazione del record, si annulla l'archiviazione dell'intero albero gerarchico di tutti i record radice o controllati correlati.

Nota L'annullamento dell'archiviazione non viene elaborato se il risultato della ricerca contiene più di 1.000 record.

Nota Le richieste di annullamento dell'archiviazione tramite Apex sono limitate a 50 all'ora per ogni organizzazione.

Prerequisiti:

Archivia Abilita Annulla archiviazione: annullare l'archiviazione dei record dall'archivio o tramite Apex.

Se è necessaria una sola autorizzazione di annullamento dell'archiviazione, è possibile abilitare una di queste autorizzazioni personalizzate e quindi assegnarla manualmente a un insieme di autorizzazioni o a un profilo personalizzato.

• Archivia Annulla archiviazione: autorizzazione ad annullare l'archiviazione dei record solo da Archivia.
• Archive Unarchive SDK: autorizzazione ad annullare l'archiviazione dei record solo tramite Archive Apex.

Annulla archiviazione delle funzioni Apex

È possibile cercare un oggetto per ogni richiesta di annullamento dell'archiviazione e applicare un massimo di 6 filtri alla ricerca.

1. performUnarchiveSdk(string sObjectName, list<SearchFilter> filters, DateRange dateRange)
2. performUnarchiveSdk(string sObjectName, list<SearchFilter> filters)

Parametri Apex

sObjectName: l'oggetto sottoposto a query da Apex.

Questo parametro è obbligatorio.

Filtri di ricerca: filtri che restringono i risultati della ricerca in base alle condizioni dei campi.

• Nome campo: il campo in base al quale si desidera filtrare, ad esempio Name o CreatedDate.
• Valore o elenco di valori: il valore o i valori specifici che si desidera abbinare.

  Se si utilizza un elenco di valori, le query sui dati Apex vengono eseguite con OR tra i valori.

Questo parametro è obbligatorio.

Filtri data: se si desidera eseguire una ricerca in base alle date, utilizzare il parametro DateRange e i filtri obbligatori. DateRange filtra i record in base a campi come ArchiveDate, CreatedDate e ModifiedDate.

Consigli sui filtri data:

• Per eseguire la ricerca in base alla Data archiviazione, aggiungere il campo Data archive_date.
• Utilizzare il formato di data Apex: MM/GG/AAAA.

Questo parametro è facoltativo.

Valori restituiti

• ID richiesta dell'operazione di annullamento dell'archiviazione eseguita
• Numero totale di record recuperati dalla ricerca
• Codice di stato, inclusi gli errori.

Valore restituito: ArchiverAccessorResponse

1. ArchiverAccessorResponse.getBody(); ⇒ string
2. ArchiverAccessorResponse.getStatusCode();⇒ string
  a. 200 - if we accepted your request
  b. 400 - if we did not accept your request
3. ArchiverAccessorResponse.getErrorMessage();⇒ string

Nota Annulla archiviazione Apex può eseguire contemporaneamente fino a 10 azioni di annullamento dell'archiviazione. Sia Annulla che Annulla archiviazione Apex sono considerate azioni di annullamento dell'archiviazione.

Documentazione sul codice

performUnarchiveSdk(string sObjectName, list<SearchFilter> filters, DateRange dateRange)

performUnarchiveSdk(string sObjectName, list<SearchFilter> filters)

Valore restituito: ArchiverAccessorResponse

1. ArchiverAccessorResponse.getBody(); ⇒ string
2. ArchiverAccessorResponse.getStatusCode();⇒ string
  a. 200 - if we accepted your request
  b. 400 - if we did not accept your request
3. ArchiverAccessorResponse.getErrorMessage();⇒ string

Esempio di codice Apex Unarchive

Esempio 1: Annullare l'archiviazione degli account denominati Propri.

list<SearchFilter> request = new list<SearchFilter>();
string sObjectName = 'Account';
SearchFilter filter1 = new SearchFilter('Name', 'Own');
request.add(filter1);
ArchiverAccessorResponse res = ArchiverAccessor.performUnarchiveSdk(sObjectName, request);
Map<String, Object> jsonMap = (Map<String, Object>) JSON.deserializeUntyped(res.getBody());

system.debug(jsonMap.get('request_id'));
system.debug(jsonMap.get('total_result_count'));

Esempio 2: Annullare l'archiviazione degli account con un filtro, dove il nome è PersonAccount3 e l'intervallo di date è record creati negli ultimi 150 giorni.

// Initialize a list to hold search filters for the archive operation
list<SF_Archive.SearchFilter> request = new list<SF_Archive.SearchFilter>();

// Define the Salesforce object name to perform the operation on
string sObjectName = 'Account';
                
// Create a search filter based on the 'Name' field with a specific value
SF_Archive.SearchFilter filter1 = new SF_Archive.SearchFilter('Name', 'PersonAccount3');
                
// Add the created filter to the request list
request.add(filter1);
                
// Create a date range filter to select records created in the last 150 days
// It calculates the start date by subtracting 150 days from today's date
SF_Archive.dateRange range = new SF_Archive.dateRange('CreatedDate', system.today()-150, system.today());
                
// Perform the unarchive operation with the specified object name, filters, and date range
// This retrieves records from the archival that match the given criteria
SF_Archive.ArchiverAccessorResponse res = SF_Archive.ArchiverAccessor.performUnarchiveSdk(sObjectName, request, range);

// Deserialize the JSON response body to a Map object to easily access the data
Map<String, Object> jsonMap = (Map<String, Object>) JSON.deserializeUntyped(res.getBody());
                
// Debug print the request ID and total result count from the response for logging purposes
system.debug(jsonMap.get('request_id'));
system.debug(jsonMap.get('total_result_count'));