ניהול העניינים

עניין הוא מאגר לנתונים שקשורים לנושא ספציפי, כמו תיק משפטי או חקירה. תיק משפטי כולל את הפריטים הבאים:

  • שאילתות חיפוש שמורות
  • השהיות
  • חשבונות ששותפו איתם העניין
  • ייצוא של קבוצות
  • נתיב ביקורת

כדי לעבוד עם משאבים ב-Google Vault, לחשבון צריכות להיות הרשאות Vault הנדרשות וגישה לעניין. כדי לגשת לתיק, החשבון צריך ליצור את התיק, לקבל שיתוף של התיק או לקבל את ההרשאה View All Matters.

לתיק יש את המצבים הבאים:

מדינה (State)תיאור
פתיחההעניין פעיל, ואפשר ליצור בו החזקות לצורך משפטי, להריץ חיפושים ולייצא נתונים.
סגורבדרך כלל, כשחקירה מסתיימת, הנושא נסגר. אפשר לפתוח מחדש עניינים סגורים בכל שלב. לפני שסוגרים עניין, צריך למחוק את כל ההחזקות שמשויכות אליו.
נמחקאפשר למחוק עניין כך שהוא לא יהיה זמין יותר. עניינים שנמחקו נשארים באשפה למשך כ-30 יום, ובמהלך התקופה הזו אפשר לשחזר אותם. אחרי התקופה הזו, העניין יימחק באופן סופי. אפשר למחוק רק עניינים סגורים.

מחזור החיים של עניינים משפטיים

יצירת עניין

בדוגמה הבאה נוצר עניין חדש עם שם ותיאור.

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

קבלת עניין

יש שתי תצוגות של עניין משפטי: BASIC (ברירת מחדל) ו-FULL. בתצוגה FULL נוספות הרשאות לטיפול לתצוגה BASIC.

בדוגמה הבאה מאחזרים את העניין שצוין.

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

הצגת רשימה של matters

בדוגמה הבאה אפשר לראות איך מציגים רשימה של כל התיקים הפתוחים, הסגורים והמחוקים. כברירת מחדל, ה-API מחזיר עד 100 עניינים לכל בקשה.

Java

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

Python

mattersList = service.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");
client.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
 

הרשאות בתיק משפטי

לכל עניין יש קבוצת הרשאות שקובעת למי יש גישה אליו או הרשאת עריכה שלו. אפשר לראות את זה בתצוגה FULL של עניין מסוים.

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