Rechtsangelegenheiten verwalten

Eine Rechtsangelegenheit enthält alle Daten zu einem bestimmten Thema, beispielsweise zu einer Streitsache oder einer Untersuchung. Eine Rechtsangelegenheit umfasst Folgendes:

  • Gespeicherte Suchanfragen
  • Holds
  • Konten, für die die Rechtsangelegenheit freigegeben ist
  • Gruppen exportieren
  • Audit-Trail

Damit Sie mit Vault-Ressourcen arbeiten können, muss das Konto die erforderlichen Vault-Berechtigungen und Zugriff auf die Rechtsangelegenheit haben. Damit Sie auf eine Rechtsangelegenheit zugreifen können, muss sie mit dem Konto erstellt oder für sie freigegeben sein oder über die Berechtigung Alle Rechtsangelegenheiten abrufen verfügen.

Eine Rechtsangelegenheit kann folgende Status haben:

StatusBeschreibung
ÖffnenDie Rechtsangelegenheit ist aktiv und Sie können Holds erstellen, Suchvorgänge ausführen und Daten darin exportieren.
GeschlossenWenn eine Untersuchung abgeschlossen ist, ist die Rechtsangelegenheit in der Regel abgeschlossen.

Geschlossene Rechtsangelegenheiten können jederzeit wieder geöffnet werden.

GelöschtEine Rechtsangelegenheit kann gelöscht werden, sodass sie nicht mehr verfügbar ist.

Gelöschte Rechtsangelegenheiten verbleiben ca. 30 Tage im Papierkorb. In diesem Zeitraum kann sie wiederhergestellt werden. Nach diesem Zeitraum wird die Rechtsangelegenheit dauerhaft gelöscht.

Lebenszyklus von Rechtsangelegenheiten

Rechtsangelegenheit erstellen

Im folgenden Beispiel wird eine neue Rechtsangelegenheit mit dem angegebenen Namen und der angegebenen Beschreibung erstellt.

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

Rechtsangelegenheit abrufen

Für eine Rechtsangelegenheit gibt es zwei Ansichten: BASIC (Standardeinstellung) und FULL. In der Ansicht VOLLSTÄNDIG werden zur BASIS-Ansicht Rechtsangelegenheiten hinzugefügt.

Im folgenden Beispiel wird die angegebene Rechtsangelegenheit abgerufen.

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

Rechtsangelegenheiten auflisten

Das folgende Beispiel zeigt, wie alle offenen, geschlossenen und gelöschten Rechtsangelegenheiten aufgelistet werden können (bis zu den standardmäßigen 100 Rechtsangelegenheiten pro Anfrage).

Java

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

Python

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

Das folgende Beispiel zeigt, wie alle offenen, geschlossenen und gelöschten Rechtsangelegenheiten für mehrere Anfragen aufgelistet werden.

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)

Das folgende Beispiel zeigt, wie Rechtsangelegenheiten eines bestimmten Status aufgelistet werden.

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

Rechtsangelegenheit aktualisieren

Im folgenden Beispiel werden der Name und die Beschreibung einer Rechtsangelegenheit aktualisiert.

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

Rechtsangelegenheit schließen

Das folgende Beispiel zeigt, wie eine Rechtsangelegenheit geschlossen wird.

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

Rechtsangelegenheiten löschen, wiederherstellen oder wieder öffnen

Das folgende Beispiel zeigt, wie Sie eine Rechtsangelegenheit löschen, wiederherstellen oder wieder öffnen.

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-Berechtigungen

Jeder Rechtsangelegenheit wird festgelegt, wer auf sie zugreifen oder sie bearbeiten darf. Sie können sich die VOLLSTÄNDIGE Ansicht einer Rechtsangelegenheit ansehen.

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