Aufheben der Archivierung von Apex

Durch das Aufheben der Archivierung des Datensatzes heben Sie die Archivierung der gesamten hierarchischen Struktur aller zugehörigen Stamm- oder untergeordneten Datensätze auf.

Hinweis Das Aufheben der Archivierung wird nicht verarbeitet, wenn das Suchergebnis mehr als 1.000 Datensätze enthält.

Hinweis Aufhebungsanforderungen über Apex sind für jede Organisation auf 50 pro Stunde begrenzt.

Voraussetzungen:

Archivieren Enable Unarchive (Archivierung aktivieren): Heben Sie die Archivierung von Datensätzen aus dem Archiv oder über Apex auf.

Wenn Sie nur eine Berechtigung zum Aufheben der Archivierung benötigen, können Sie eine dieser benutzerdefinierten Berechtigungen aktivieren und sie dann manuell einem benutzerdefinierten Berechtigungssatz oder Profil zuweisen.

• Archivieren Aufheben der Archivierung: Nur die Berechtigung zum Aufheben der Archivierung von Datensätzen aus Archiven.
• Archive Unarchive SDK (Archivierungs-SDK aufheben): Berechtigung zum Aufheben der Archivierung von Datensätzen nur über Apex archivieren.

Aufheben der Archivierung von Apex-Funktionen

Sie können ein Objekt pro Aufhebungsanforderung durchsuchen und maximal 6 Filter auf die Suche anwenden.

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

Apex Parameter

sObjectName: Das von Apex abgefragte Objekt.

Dieser Parameter ist obligatorisch.

Suchfilter: Filter, die Suchergebnisse anhand von Feldbedingungen eingrenzen.

• Feldname: Das Feld, nach dem gefiltert werden soll, beispielsweise Name oder CreatedDate.
• Wert oder Liste der Werte: Der oder die spezifischen Werte, die abgeglichen werden sollen.

  Bei Verwendung einer Liste von Werten werden Apex-Datenabfragen mit OR zwischen den Werten abgefragt.

Dieser Parameter ist obligatorisch.

Datumsfilter: Wenn Sie anhand von Datumswerten suchen möchten, verwenden Sie den Parameter DateRange und die obligatorischen Filter. DateRange filtert Datensätze nach Feldern wie ArchiveDate, CreatedDate und ModifiedDate.

Datumsfilterempfehlungen:

• Fügen Sie das Feld "archive_date" hinzu, um anhand des Archivdatums zu suchen.
• Verwenden Sie das Apex-Datumsformat: MM/TT/JJJJ.

Dieser Parameter ist optional.

Zurückgegebene Werte

• Anforderungs-ID des ausgeführten Vorgangs zum Aufheben der Archivierung
• Gesamtanzahl der durch die Suche abgerufenen Datensätze
• Statuscode, einschließlich Fehlern.

Rückgabewert: 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

Hinweis Apex zum Aufheben der Archivierung kann bis zu 10 Aktionen zum Aufheben der Archivierung gleichzeitig ausführen. Sowohl "Rückgängig machen" als auch "Apex-Archiv aufheben" gelten als Aktionen zum Aufheben der Archivierung.

Codedokumentation

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

performUnarchiveSdk(string sObjectName, list<SearchFilter> filters)

Rückgabewert: 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

Beispiel für Apex Unarchive Code (Code zum Aufheben der Archivierung)

Beispiel 1: Aufheben der Archivierung von Accounts mit dem Namen "Own".

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'));

Beispiel 2: Aufheben der Archivierung von Accounts mit einem Filter, wobei der Name PersonAccount3 und der Datumsbereich Datensätze sind, die in den letzten 150 Tagen erstellt wurden.

// 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'));