Avarkivera Apex

Att avarkivera en post avarkiverar även hela dess hierarkiska träd med rotposter och underordnade poster.

Anteckning Avarkivering bearbetas inte om sökresultatet innehåller fler än 1 000 poster.

Anteckning

Avarkiveringsbegäranden via Apex är begränsade till 50 per timme och organisation.

Om du överskrider denna gräns får du HTTP-statuskod 429.

Anteckning Avarkiverade Apex kan köra upp till 10 avarkiverade åtgärder samtidigt. Både Ångra och Apex Avarkivera räknas som avarkiveringsåtgärder.

Förkrav

Aktivera Arkiv Aktivera Avarkivera för att avarkivera poster från appen Arkiv eller via Apex. Om du endast behöver en avarkiveringsbehörighet, aktivera en av dessa egna behörigheter och tilldela den manuellt till en egen behörighetsuppsättning eller profil.

• Arkiv Avarkivera: Behörighet att endast avarkivera poster från appen Arkivera.
• Arkivera avarkiverad SDK: Behörighet att endast avarkivera poster via Archive SDK.

Avarkivera Apex funktioner

Sök i ett objekt per begäran om avarkivering och tillämpa högst sex filter för sökningen.

performUnarchiveSdk(String sObjectName, List<SearchFilter> filters, DateRange dateRange)
performUnarchiveSdk(String sObjectName, List<SearchFilter> filters)

Apex parametrar

sObjectName

Objektet som frågas av Apex. Denna parameter krävs.

Sökfilter

Filter som begränsar sökresultat baserat på fältvillkor. Denna parameter krävs.

• Fältnamn: Fältet att filtrera efter, till exempel Name eller CreatedDate.
• Värde eller Lista över värden: Det eller de specifika värden som ska matchas. Om du använder en lista över värden kombinerar Apex Datafrågor dem med en OR.

Datumfilter

För att söka baserat på datum, använd parametern DateRange och de filter som behövs. DateRange filtrerar poster efter fält som ArchiveDate, CreatedDate och ModifiedDate. Denna parameter är valfri. Datumfilterrekommendationer:

• Lägg till fältet archive_date att söka efter baserat på arkiveringsdatumet.
• Använd Apex datumformat: MM/DD/ÅÅÅÅ.

Returnerade värden

Returvärdet är ArchiverAccessorResponse.

• Begär ID för den avarkiverade operationen som utförs
• Totalt antal poster som hämtats av sökningen
• Statuskod, inklusive fel

ArchiverAccessorResponse.getBody(); ⇒ String
ArchiverAccessorResponse.getStatusCode(); ⇒ integer
  200 - if the request was accepted
  400 - if the request wasn't accepted
ArchiverAccessorResponse.getErrorMessage(); ⇒ String

Avarkivera Apex scenarion

Gå igenom exempel på processen att avarkivera Apex i appen Arkiv.

Scenario 1: Färre än 1 000 matchande poster hittades, begäran bearbetad—Framgång!

Du vill avarkivera alla kandidater som har en kandidatexamen.

• Du kör funktionen Arkivera Apex avarkivering med filtrets has BA=true.
• Systemet söker i kandidatlistan och hittar färre än 1 000 arkiverade poster.
• En ny aktivitet av typen Unarchive SDK läggs till och alla avarkiverade fält fylls i. Returvärdet är antalet poster som hittades.

Scenario 2: Mer än 1 000 matchande poster hittades, begäran bearbetades inte—Misslyckande

Du vill avarkivera alla kandidater som har en magisterexamen.

• Du kör funktionen Arkivera Apex avarkivering med filtrets has MA=true.
• Systemet söker i kandidatlistan och hittar mer än 1 000 arkiverade poster.
• Processen för att avarkivera Apex avslutas utan resultat och ingen aktivitet skapas. Returvärdet inkluderar antalet poster som hittades och ett fel: 400, för stort omfång.

Scenario 3: Färre än 1 000 poster, inga matchande poster hittades, ingen begäran bearbetad—Misslyckande

Du vill avarkivera alla kandidater som har en magisterexamen.

• Du kör funktionen Arkivera Apex avarkivering med filtrets has MA=true.
• Systemet söker i kandidatlistan och hittar färre än 1 000 poster, men inga matchande poster hittas. Ingen aktivitet skapas. Returvärdet är antalet poster som hittades.

Scenario 4: Färre än 1 000 matchande poster hittades, begäran bearbetad, delvis genomförd — Framgång!

Du vill avarkivera alla kandidater som har en kandidatexamen.

• Du kör funktionen Arkivera Apex avarkivering med filtrets has BA=true.
• Systemet söker igenom kandidatlistan, hittar färre än 1 000 poster och avarkiverar dem.
• Poster som matchar filtret avarkiveras framgångsrikt. En ny aktivitet av typen Unarchive SDK läggs till och alla avarkiverade fält fylls i. Returvärdet är antalet poster som hittades.

Koddokumentation

performUnarchiveSdk(String sObjectName, List<SearchFilter> filters, DateRange dateRange)
performUnarchiveSdk(String sObjectName, List<SearchFilter> filters)

Returvärde: ArchiverAccessorResponse

ArchiverAccessorResponse.getBody(); ⇒ String
ArchiverAccessorResponse.getStatusCode(); ⇒ integer
  200 - if the request was accepted
  400 - if the request wasn't accepted
ArchiverAccessorResponse.getErrorMessage(); ⇒ String

Kodexempel

Exempel 1: Avarkivera konton som heter Äg.

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

Exempel 2: Avarkivera konton med ett filter där namn är PersonAccount3 och datumintervallet är poster som skapats under de senaste 150 dagarna.

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