จัดการกรณี

กรณีคือคอนเทนเนอร์สำหรับข้อมูลทั้งหมดที่เกี่ยวข้องกับหัวข้อหนึ่งๆ เช่น คดีการฟ้องร้องหรือการตรวจสอบ กรณีมีข้อมูลดังนี้

  • คำค้นหาที่บันทึกไว้
  • เก็บรักษาไว้
  • บัญชีที่แชร์กรณีด้วย
  • ส่งออกชุด
  • บันทึกการตรวจสอบ

หากต้องการทำงานกับทรัพยากรในห้องนิรภัย บัญชีต้องมีสิทธิ์ที่จําเป็นสําหรับห้องนิรภัยและการเข้าถึงเรื่อง หากต้องการเข้าถึงเคส บัญชีต้องเป็นผู้สร้างเคส มีเคสที่แชร์กับตน หรือมีสิทธิ์ดูเคสทั้งหมด

กรณีมีสถานะต่อไปนี้

รัฐคำอธิบาย
เปิดกรณีดังกล่าวจะยังคงทำงานอยู่ และคุณจะสร้างการเก็บรักษา เรียกใช้การค้นหา และส่งออกข้อมูลภายในกรณีดังกล่าวได้
ปิดโดยปกติแล้ว เมื่อการตรวจสอบเสร็จสิ้นแล้ว ปัญหาจะปิด

คุณจะเปิดเคสที่ปิดไปแล้วขึ้นมาใหม่ได้ทุกเมื่อ

ลบแล้วคุณสามารถลบเคสเพื่อให้ไม่พร้อมใช้งานโดยสมบูรณ์

กรณีที่ลบไปแล้วจะยังคงอยู่ในถังขยะประมาณ 30 วัน ซึ่งในระหว่างนี้สามารถกู้คืนได้ หลังจากนั้นระบบจะล้างข้อมูลเคสออกอย่างถาวร

วงจรของ Matters

สร้างเคส

ตัวอย่างต่อไปนี้สร้างเคสใหม่ที่มีชื่อและคำอธิบายที่ระบุ

Java

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

รับเรื่อง

เนื้อหามี 2 มุมมอง ได้แก่ พื้นฐาน (ค่าเริ่มต้น) และแบบเต็ม มุมมองแบบเต็มจะเพิ่มสิทธิ์สำหรับ Matter ลงในมุมมองพื้นฐาน

ตัวอย่างต่อไปนี้จะดึงข้อมูลเรื่องดังกล่าว

Java

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 รายการต่อคำขอโดยค่าเริ่มต้น)

Java

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

Python

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

ตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการเคสที่เปิดอยู่ ปิดแล้ว และลบแล้วทั้งหมดในคำขอหลายรายการ

Java

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)

ตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการเรื่องของรัฐที่ระบุ

Java

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

อัปเดตเคส

ตัวอย่างต่อไปนี้จะอัปเดตชื่อและคำอธิบายของเคส

Java

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

ปิดเคส

ตัวอย่างต่อไปนี้แสดงวิธีปิดเคส

Java

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']
 

ลบ ยกเลิกการลบ หรือเปิดเคสอีกครั้ง

ตัวอย่างต่อไปนี้แสดงวิธีลบ เลิกลบ หรือเปิดเคสอีกครั้ง

Java

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

แต่ละเรื่องจะมีชุดสิทธิ์ของผู้ที่เข้าถึงหรือแก้ไขได้ คุณดูข้อมูลนี้ได้โดยการดูมุมมองแบบเต็มของเรื่อง

Java

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