مدیریت امور

یک موضوع محفظه ای است برای همه داده های مربوط به یک موضوع خاص، مانند یک پرونده قضایی یا یک تحقیق. یک موضوع شامل:

  • عبارت جستجوی ذخیره شده
  • دارای
  • حساب هایی که موضوع با آنها به اشتراک گذاشته شده است
  • مجموعه های صادراتی
  • دنباله حسابرسی

برای کار با منابع Vault، حساب باید دارای امتیازات Vault مورد نیاز و دسترسی به موضوع باشد. برای دسترسی به یک موضوع، حساب باید موضوع را ایجاد کرده باشد، موضوع را با آنها به اشتراک گذاشته باشد، یا دارای امتیاز View All Matters باشد.

یک موضوع دارای حالات زیر است:

حالت شرح
باز کن موضوع فعال است و می‌توانید در آن نگه‌داری ایجاد کنید، جستجوها را اجرا کنید و داده‌ها را صادر کنید.
بسته شد معمولاً وقتی تحقیقات کامل می شود، موضوع بسته می شود.

موضوعات بسته شده را می توان در هر زمان بازگشایی کرد.

حذف شده موضوعی را می توان حذف کرد تا کاملاً از دسترس خارج شود.

یک موضوع حذف شده تقریباً 30 روز در سطل زباله باقی می ماند و در این مدت می توان آن را بازیابی کرد. پس از آن مدت، موضوع برای همیشه پاکسازی می شود.

چرخه عمر اهمیت دارد

یک موضوع ایجاد کنید

مثال زیر یک موضوع جدید با نام و توضیحات مشخص شده ایجاد می کند.

جاوا

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

یه موضوعی بگیر

دو دیدگاه برای یک موضوع وجود دارد: BASIC (پیش فرض) و FULL. نمای FULL مجوزهای ماده را به نمای BASIC اضافه می کند.

مثال زیر موضوع مشخص شده را بازیابی می کند.

جاوا

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