Eine Rechtsangelegenheit ist ein Container für alle Daten, die sich auf ein bestimmtes Thema beziehen, z. B. auf einen Rechtsstreit oder eine Untersuchung. Dazu gehören:
- Gespeicherte Suchanfragen
- Holds
- Konten, für die die Rechtsangelegenheit freigegeben ist
- Exportsätze
- Audit-Trail
Damit das Konto mit Vault-Ressourcen arbeiten kann, muss es die erforderlichen Vault-Berechtigungen haben und Zugriff auf die Angelegenheit haben. Damit ein Konto auf eine Rechtsangelegenheit zugreifen kann, muss es die Rechtsangelegenheit erstellt oder die Freigabe erhalten haben oder die Berechtigung Alle Rechtsangelegenheiten abrufen haben.
Ein Fall hat die folgenden Status:
Status | Beschreibung |
---|---|
Öffnen | Die Rechtsangelegenheit ist aktiv und Sie können Holds erstellen, Suchanfragen ausführen und Daten daraus exportieren. |
Geschlossen | Normalerweise wird die Angelegenheit nach Abschluss der Prüfung geschlossen. Geschlossene Rechtsangelegenheiten können jederzeit wieder geöffnet werden. |
Gelöscht | Eine Rechtsangelegenheit kann gelöscht werden, sodass sie nicht mehr verfügbar ist. Gelöschte Rechtsangelegenheiten verbleiben etwa 30 Tage im Papierkorb und können innerhalb dieses Zeitraums wiederhergestellt werden. Nach Ablauf dieses Zeitraums werden die Daten endgültig gelöscht. |
Rechtsangelegenheit erstellen
Im folgenden Beispiel wird eine neue Rechtsangelegenheit mit dem angegebenen Namen und der 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
Es gibt zwei Ansichten für eine Anfrage: BASIC (Standard) und VOLLSTÄNDIG. In der vollständigen Ansicht werden der BASIC-Ansicht Berechtigungen für Datenelemente hinzugefügt.
Im folgenden Beispiel wird die angegebene Angelegenheit 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
Im folgenden Beispiel wird gezeigt, wie alle offenen, geschlossenen und gelöschten Rechtsangelegenheiten aufgelistet werden (bis zu 100 pro Anfrage).
Java
ListmattersList = client.matters().list().execute().getMatters();
Python
mattersList = client.matters().list().execute()
Im folgenden Beispiel wird gezeigt, wie alle offenen, geschlossenen und gelöschten Angelegenheiten über 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 Angelegenheiten eines bestimmten Bundeslandes aufgelistet werden.
Java
// Only get open matters. ListopenMattersList = 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()
Eine Anfrage 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
Im folgenden Beispiel wird gezeigt, wie eine Anfrage 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
Im folgenden Beispiel wird gezeigt, wie Sie eine Anfrage löschen, die Löschung rückgängig machen 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
Für jede Angelegenheit gibt es eine Berechtigungsgruppe, die festlegt, wer darauf zugreifen oder sie bearbeiten kann. Sie können sich die vollständige Ansicht einer Angelegenheit ansehen.
Java
String matterId = "Matter Id"; String accountId = "Account Id"; // List permissions for a matter. Matter matter = client.matters().get(matterId).setView("FULL").execute(); ListmatterPermissions = 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()