법적 사안 관리

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

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

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

법적 사안에는 다음과 같은 상태가 표시됩니다.

법적 사안 만들기

다음 예에서는 지정된 이름과 설명을 사용하여 새 법적 사안을 만듭니다.

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

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

법적 사안 가져오기

법적 사안에는 기본 (기본값)과 전체의 두 가지 보기가 있습니다. FULL 뷰는 기본 뷰에 법적 권한을 추가합니다.

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

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

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

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

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

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

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

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

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

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