법적 사안 관리

법적 사안은 소송 사건이나 조사와 같은 특정 주제와 관련된 모든 데이터를 보관하는 컨테이너입니다. 법적 사안에 포함되는 항목은 다음과 같습니다.

  • 저장된 검색어
  • 보존 조치
  • 법적 사안이 공유된 계정
  • 세트 내보내기
  • 감사 추적

Vault 리소스를 사용하려면 계정에 필요한 Vault 권한이 있고 케이스에 대한 액세스 권한이 있어야 합니다. 법적 사안에 액세스하려면 해당 계정이 법적 사안을 만들었거나, 법적 사안이 해당 계정과 공유되었거나, 모든 법적 사안 보기 권한이 있어야 합니다.

문제의 상태는 다음과 같습니다.

주설명
열기법적 사안이 활성 상태이며 이 사안 내에서 보존 조치를 만들고, 검색을 실행하고, 데이터를 내보낼 수 있습니다.
종료됨일반적으로 조사가 완료되면 문제가 종료됩니다.

종료된 법적 사안은 언제든지 다시 열 수 있습니다.

삭제됨사안을 삭제하면 완전히 사용할 수 없게 됩니다.

삭제된 법적 사안은 약 30일 동안 휴지통에 보관되며 이 기간에는 복원할 수 있습니다. 이 기간이 지나면 해당 사안은 영구적으로 삭제됩니다.

문제 수명 주기

법적 사안 만들기

다음 예에서는 지정된 이름과 설명으로 새 사안을 만듭니다.

자바

Matter matter = new Matter();
matter.setName("Matter Name");
matter.setDescription("Matter Description");
Matter createdMatter = client.matters().create(matter).execute();

Python

def create_matter(service):
  matter_content = {
      'name': 'Matter Name',
      'description': 'Matter Description',
  }
  matter = service.matters().create(body=matter_content).execute()
  return matter

법적 사안 가져오기

케이스에는 BASIC(기본값) 및 FULL(전체)의 두 가지 보기가 있습니다. 전체 보기는 BASIC 보기에 사안 권한을 추가합니다.

다음 예에서는 지정된 사안을 검색합니다.

자바

client.matters().get(matterId).execute(); // Returns BASIC view.
client.matters().get(matterId).setView("BASIC").execute();
client.matters().get(matterId).setView("FULL").execute();

Python

matter_id = getMatterId()
service.matters().get(matterId=matter_id).execute(); // Returns BASIC view.
service.matters().get(matterId=matter_id, view='BASIC').execute();
service.matters().get(matterId=matter_id, view='FULL').execute();

사안 나열

다음 예는 진행 중인, 종료된, 삭제된 모든 케이스를 나열하는 방법을 보여줍니다 (요청당 최대 기본값 100개).

자바

List mattersList = client.matters().list().execute().getMatters();

Python

mattersList = client.matters().list().execute()

다음 예는 여러 요청에 걸쳐 진행 중인, 종료된, 삭제된 모든 케이스를 나열하는 방법을 보여줍니다.

자바

ListMattersResponse firstPageResponse = client.matters().list().setPageSize(20).execute();
 
String nextPageToken = firstPageResponse.getNextPageToken());
if (nextPageToken != null) {
  client.matters().list().setPageToken(nextPageToken).setPageSize(20).execute();
}

Python

list_response1 = service.matters().list(
        view='FULL', pageSize=10).execute()
for matter in list_response1['matters']:
    print(matter)

if ‘nextPageToken’ in list_response1:
    list_response2 = service.matters().list(
        pageSize=10, pageToken=list_response1['nextPageToken']).execute()
    for matter in list_response2['matters']:
      print(matter)

다음 예는 지정된 상태의 문제를 나열하는 방법을 보여줍니다.

자바

// Only get open matters.
List openMattersList = client.matters().list().setState("OPEN").execute().getMatters();

// Only get closed matters.
List closedMattersList = client.matters().list().setState("CLOSED").execute().getMatters();

// Only get deleted matters.
List deletedMattersList = client.matters().list().setState("DELETED").execute().getMatters();

Python

# Only get open matters.
openMattersList = client.matters().list(
    state='OPEN').execute()

# Only get closed matters.
closedMattersList = client.matters().list(
    state='CLOSED').execute()

# Only get deleted matters.
deletedMattersList = client.matters().list(
    state='DELETED').execute()

문제 업데이트

다음 예에서는 사안의 이름과 설명을 업데이트합니다.

자바

String matterId = "matterId";
Matter matter = new Matter().setName("New Name").setDescription("New Description");
vault.matters().update(matterId, matter).execute();

Python

def update_matter(service, matter_id):
    wanted_matter = {
        'name': 'New Matter Name',
        'description': 'New Description'
    }
    updated_matter = service.matters().update(
        matterId=matter_id, body=wanted_matter).execute()
    return updated_matter

법적 사안 종료하기

다음 예는 케이스를 종료하는 방법을 보여줍니다.

자바

String matterId = "matterId";
// If the matter still has holds, this operation will fail.
client.matters().close(matterId, new CloseMatterRequest()).execute();

Python

def close_matter(service, matter_id):
    close_response = service.matters().close(
        matterId=matter_id, body={}).execute()
    return close_response['matter']

법적 사안 삭제, 삭제 취소 또는 다시 열기

다음 예는 케이스를 삭제, 삭제 취소 또는 다시 여는 방법을 보여줍니다.

자바

Matter matter = client.matters().get(matterId).execute();
 
// Delete the matter.
client.matters().delete(matter.getMatterId());
// Undelete the matter.
client.matters().undelete(matter.getMatterId(), new UndeleteRequest());
// Reopen the matter.
client.matters().reopen(matter.getMatterId(), new ReopenMatterRequest());

Python

def reopen_matter(service, matter_id):
    reopen_response = service.matters().reopen(
        matterId=matter_id, body={}).execute()
    return reopen_response['matter']

def delete_matter(service, matter_id):
    service.matters().delete(matterId=matter_id).execute()
    return get_matter(matter_id)

def undelete_matter(service, matter_id):
    undeleted_matter = service.matters().undelete(
        matterId=matter_id, body={}).execute()
    return undeleted_matter

Matter 권한

각 케이스에는 액세스하거나 수정할 수 있는 사용자의 권한이 설정되어 있습니다. 케이스의 전체 보기를 확인하면 이를 확인할 수 있습니다.

자바

String matterId = "Matter Id";
String accountId = "Account Id";
 
// List permissions for a matter.
Matter matter = client.matters().get(matterId).setView("FULL").execute();
List matterPermissions = matter.getMatterPermissions();
 
// Add a user to the permission set.
client
    .matters()
    .addPermissions(matterId)
    .setMatterPermissionAccountId(accountId)
    .setMatterPermissionRole("COLLABORATOR")
    .execute();
 
// Remove a user from the permission set.
client
    .matters()
    .removePermissions(matterId)
    .setAccountId(accountId)
    .execute();

Python

def list_matter_permission(service, matter_id):
    matter = service.matters().get(matterId=matter_id, view='FULL').execute()
    return matter['matterPermissions']
 
def add_matter_permission(service, matter_id, account_id):
    permission = service.matters().addPermissions(
        matterId=matter_id,
        matterPermission_accountId=account_id,
        matterPermission_role='COLLABORATOR',
        sendEmails='False',
        ccMe='False').execute()
    return permission

def remove_matter_permission(service, matter_id, account_id):
    service.matters().removePermissions(
        matterId=matter_id, accountId=account_id).execute()