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

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

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

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

לבעיה יכולים להיות אחד מהמצבים הבאים:

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

תמיד אפשר לפתוח מחדש עניינים שנסגרו.

נמחקאפשר למחוק עניין כך שהוא לא יהיה זמין בכלל.

בקשה שנמחקה תישאר באשפה למשך כ-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

אחזור של עניין

יש שתי תצוגות של פנייה: בסיסי (ברירת המחדל) ומלא. בתצוגה המלאה מתווספות הרשאות לנושא לתצוגה הבסיסית.

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

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

הרשאות בנושאים

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

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