아카이브 해제 Apex

레코드를 보관 취소하면 레코드와 관련된 루트 또는 하위 레코드의 전체 계층 트리를 보관 취소합니다.

노트 검색 결과에 1,000개가 넘는 레코드가 포함되어 있는 경우 보관 취소가 처리되지 않습니다.

노트 Apex 통한 보관 취소 요청은 각 조직에 대해 시간당 50개로 제한됩니다.

전제 조건:

보관 취소 활성화 - 보관에서 또는 Apex 통해 레코드를 파악합니다.

보관 취소 권한이 하나만 필요한 경우 다음 사용자 정의 권한 중 하나를 활성화한 다음, 사용자 정의 권한 집합 또는 프로필에 수동으로 할당할 수 있습니다.

• 보관 취소 - 보관에서만 레코드를 보관 취소할 수 있는 권한입니다.
• 보관 취소 SDK 보관 - 보관 Apex 통해서만 레코드를 보관 취소할 수 있는 권한입니다.

아카이브화되지 않는 Apex 함수

보관되지 않은 요청당 하나의 개체를 검색하고 검색에 최대 6개의 필터를 적용할 수 있습니다.

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

Apex 매개 변수

sObjectName - Apex 쿼리한 개체입니다.

이 매개 변수는 필수입니다.

검색 필터 - 필드 조건을 기반으로 검색 결과의 범위를 좁힙니다.

• 필드 이름 - Name 또는 CreatedDate 등 필터링할 필드입니다.
• 값 또는 값 목록 - 일치시킬 특정 값 또는 값입니다.

  값 목록을 사용하는 경우 값 사이의 OR로 Apex 데이터 쿼리가 쿼리됩니다.

이 매개 변수는 필수입니다.

날짜 필터 - 날짜를 기반으로 검색하려면 DateRange 매개 변수와 필수 필터를 사용합니다. DateRange은 ArchiveDate, CreatedDate 및 ModifiedDate과 같은 필드로 레코드를 필터링합니다.

날짜 필터 권장 사항:

• 보관 날짜를 기반으로 검색하려면 archive_date 날짜 필드를 추가합니다.
• Apex 날짜 형식을 사용합니다. MM/DD/YYYY.

이 매개 변수는 선택적입니다.

반환된 값

• 수행된 보관 취소 작업의 요청 ID
• 검색을 통해 검색된 총 레코드 수
• 오류를 포함한 상태 코드입니다.

반품 값: 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

노트 보관 취소 Apex 최대 10개의 보관 취소 작업을 동시에 실행할 수 있습니다. Undo 및 Apex Unarchive는 모두 보관되지 않는 작업으로 간주됩니다.

코드 문서

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

performUnarchiveSdk(string sObjectName, list<SearchFilter> filters)

반품 값: 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

Apex 아카이브 해제 코드 예제

예 1: 소유로 명명된 계정 보관 취소

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

예 2: 이름이 PersonAccount3이고 날짜 범위가 지난 150일 동안 생성된 레코드인 필터를 사용하여 계정을 보관 해제합니다.

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