법적 사안 관리

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

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

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

법적 사안 가져오기

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

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

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

 

법적 사안 권한

각 법적 사안에는 액세스 또는 수정 권한이 있는 사용자 집합이 있습니다. 법적 사안을 전체 보기로 확인하여 확인할 수 있습니다.

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