법적 사안 관리

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

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

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의 두 가지 보기가 있습니다. 전체 뷰는 기본 뷰에 문제 권한을 추가합니다.

다음 예에서는 지정된 사안을 가져옵니다.

자바

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

케이스 권한

각 케이스에는 액세스하거나 수정할 수 있는 사용자의 권한 집합이 있습니다. 법적 사안의 전체 보기를 가져와서 확인할 수 있습니다.

자바

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()