Zarządzanie blokadami

Blokady pozwalają przechowywać dane bez ograniczeń czasowych ze względu na zobowiązania prawne i zobowiązania do ochrony danych. Zwykle blokady są nakładane na co najmniej jednego użytkownika, aby uniemożliwić usunięcie danych potencjalnie istotnych dla sprawy, dopóki sprawa nie będzie już aktywna.

Jeśli użytkownik, którego dotyczy blokada, usunie zablokowane dane, zostaną one usunięte z widoku tego użytkownika, ale pozostaną w Vault. Jeśli blokada jest aktywna, administrator Vault może wyszukiwać i eksportować te dane.

Blokady składają się z tych komponentów:

• Usługa – aplikacja odpowiedzialna za przechowywanie danych. Usługę możesz ustawić na Pocztę, Dysk lub Grupy dyskusyjne.
• Zakres – elementy objęte blokadą. Zakres można ustawić na 1 konto użytkownika lub większą ich liczbę albo na jednostkę organizacyjną.
• Opcje dodatkowe (opcjonalne) – szczegółowe informacje (zapytania lub opcje konfiguracji) służące do zawężania zakresu danych, które mają być przechowywane w zdefiniowanym zakresie. Dostępne są następujące opcje:
  • poczta, Grupy dyskusyjne: zapytanie pozwalające zawęzić zakres blokady
  • Dysk: uwzględnij dyski współdzielone w blokadzie

Aby móc korzystać z zasobów Vault, konto musi mieć wymagane uprawnienia w Vault i dostęp do sprawy. Aby uzyskać dostęp do sprawy, konto musi utworzyć sprawę, udostępnić ją użytkownikowi lub mieć uprawnienie Wyświetlanie wszystkich spraw.

Uwaga: aby można było utworzyć blokadę, musi istnieć sprawa.

Tworzenie blokady poczty na określonych kontach użytkowników za pomocą zapytania

Poniższy przykład ilustruje sposób utworzenia blokady o nazwie „Moje pierwsze konta pocztowe” dla:

• Usługa: poczta
• Element: konta użytkowników „user1” i „user2”
• Opcje dodatkowe: zapytanie „to:[e-mail]”

Pobierz identyfikatory kont użytkowników z AdminSdk. Pamiętaj, że HeldAccount może przyjmować identyfikator konta lub adres e-mail. Jeśli podasz oba, używany będzie adres e-mail, a identyfikator konta będzie ignorowany.

Java

HeldMailQuery mailQuery = new HeldMailQuery().setTerms("to:[e-mail]");
List accounts = Lists.newArrayList();
accounts.add(new HeldAccount().setAccountId(user1accountId));
accounts.add(new HeldAccount().setEmail(user2Email));
Hold hold = new Hold()
    .setName("My First mail Accounts Hold")
    .setCorpus("MAIL");
    .setQuery(new CorpusQuery().setMailQuery(mailQuery))
    .setAccounts(accounts);
Hold createdHold = client.matters().holds().create(matterId, hold).execute();
  

Python

def create_hold_mail_accounts(service, matter_id, account_id):
    mail_query = {'terms': 'to:[e-mail]'}
    accounts = [
        {'accountId': user1_account_id},
        {'email': user2_email}
    ]
    wanted_hold = {
        'name': 'My First mail Accounts Hold',
        'corpus': 'MAIL',
        'query': {
            'mailQuery': mail_query
        },
        'accounts': accounts
    }
    return service.matters().holds().create(
        matterId=matter_id, body=wanted_hold).execute()

Tworzenie blokady Dysku w jednostce organizacyjnej i uwzględnianie treści z dysku współdzielonego

Ten przykład pokazuje, jak tworzona jest blokada o nazwie „Mój pierwszy dysk jako jednostka organizacyjna” dla:

• Usługa: Dysk
• Jednostka: jednostka organizacyjna „Finanse” (identyfikator jednostki organizacyjnej jest rejestrowany w jednostce organizacyjnej orgUnitId)
• Dodatkowe opcje: uwzględnij dyski współdzielone, do których należą użytkownicy w tej jednostce organizacyjnej

Pobierz identyfikatory jednostek organizacyjnych z AdminSdk.

Java

HeldOrgUnit orgUnit = new HeldOrgUnit().setOrgUnitId(orgUnitId);
// Include shared drives content.
HeldDriveQuery driveQuery = new HeldDriveQuery().setIncludeSharedDriveFiles(true);
// Create the hold.
Hold hold = new Hold()
    .setName("My First Drive OU Hold")
    .setCorpus("DRIVE")
    .setQuery(new CorpusQuery().setDriveQuery(driveQuery))
    .setOrgUnit(orgUnit);
Hold createdHold = client.matters().holds().create(matterId, hold).execute();
return createdHold;

Python

def create_hold_drive_org(service, matter_id, org_unit_id):
    drive_query = {'includeSharedDriveFiles': True}
    org_unit = {'orgUnitId': org_unit_id}
    wanted_hold = {
        'name': 'My First Drive OU Hold',
        'corpus': 'DRIVE',
        'orgUnit': org_unit,
        'query': {
            'driveQuery': drive_query
        }
    }
    return service.matters().holds().create(
        matterId=matter_id, body=wanted_hold).execute()

Tworzenie blokady na poziomie grup na określonych kontach grup z zakresem dat

Z przykładu poniżej dowiesz się, jak utworzyć blokadę o nazwie „Moja pierwsza blokada grupy”:

• Usługa: grupy
• Element: konta grupy „grupa1” i „grupa2”
• Opcje dodatkowe: blokowanie tylko wiadomości z datami wysłania między „startTime” a „endTime”

Pobierz identyfikatory kont grup z AdminSdk.

Java

String APRIL_2_2017_GMT = "2017-04-02T00:00:00Z"; // See below for format*.
 
List accounts = Lists.newArrayList();
accounts.add(new HeldAccount().setAccountId(accountId));
accounts.add(new HeldAccount().setAccountId(accountId2));
HeldGroupsQuery groupQuery = new HeldGroupsQuery();
// Restrict by sent date.
groupQuery.setStartTime(APRIL_2_2017_GMT);
groupQuery.setEndTime(APRIL_2_2017_GMT);
// create the hold
Hold hold = new Hold()
    .setName("My First Group Hold")
    .setCorpus("GROUPS")
    .setQuery(new CorpusQuery().setGroupsQuery(groupQuery));
    hold.setAccounts(accounts);
Hold createdHold = client.matters().holds().create(matterId, hold).execute();
 

Python

def create_hold_groups_date_range(service, matter_id, group_account_id):
    groups_query = {
        'startTime': '2017-04-02T00:00:00Z', # See below for format*
        'endTime': '2017-04-02T00:00:00Z'
    }
    accounts = [{'accountId': group_account_id}]
    wanted_hold = {
        'name': 'My First Group Hold',
        'corpus': 'GROUPS',
        'query': {
            'groupsQuery': groups_query
        },
        'accounts': accounts
    }
    return service.matters().holds().create(
        matterId=matter_id, body=wanted_hold).execute()
 

• Format sygnatury czasowej. Dodatkowo godziny rozpoczęcia i zakończenia są konwertowane na czas GMT i zaokrąglane w dół do początku danej daty.

Wykonywanie zapytań i modyfikowanie istniejących blokad

Z przykładu poniżej dowiesz się, jak wyświetlić listę wszystkich kont objętych istniejącą blokadą:

Java

client.matters().holds().accounts().list(matterId, holdId).execute().getAccounts();

Python

# If no accounts are on hold, ['accounts'] will raise an error.
def list_held_accounts(service, matter_id, hold_id):
    return service.matters().holds().accounts().list(
        matterId=matter_id, holdId=hold_id).execute()['accounts'] 

Z przykładu poniżej dowiesz się, jak dodać konto do dotychczasowej blokady i z niej usunąć:

Java

// Add an account by id.
client
        .matters()
        .holds()
        .accounts()
        .create(matterId, holdId, new HeldAccount().setAccountId(accountId))
        .execute();
// Remove an account by id.
client.matters().holds().accounts().delete(matterId, holdId, accountId).execute();

String email = "[e-mail]";
// Add an account by email.
client
        .matters()
        .holds()
        .accounts()
        .create(matterId, holdId, new HeldAccount().setEmail(email))
        .execute();

Python

 
def add_held_account(service, matter_id, hold_id, account_id):
    held_account = {'accountId': account_id}
    return service.matters().holds().accounts().create(
        matterId=matter_id, holdId=hold_id, body=held_account).execute()

def remove_held_account(service, matter_id, hold_id, account_id):
    return service.matters().holds().accounts().delete(
        matterId=matter_id, holdId=hold_id, accountId=account_id).execute()

def add_held_account(service, matter_id, hold_id, email):
    held_account = {'email': email}
    return service.matters().holds().accounts().create(
        matterId=matter_id, holdId=hold_id, body=held_account).execute()
 

Z przykładu poniżej dowiesz się, jak zmodyfikować jednostkę organizacyjną w przypadku dotychczasowej blokady jednostki organizacyjnej:

Java

Hold hold = client.matters().holds().get(matterId, holdId).execute();
hold.getOrgUnit().setOrgUnitId(newOrgUnitId);
Hold modifiedHold = client.matters().holds().update(matterId, holdId, hold).execute();
return modifiedHold;
 

Python

def update_hold_ou(service, matter_id, hold_id, org_unit_id):
    current_hold = get_hold(matter_id, hold_id)
    current_hold['orgUnit'] = {'orgUnitId': org_unit_id}
    return service.matters().holds().update(
        matterId=matter_id, holdId=hold_id, body=current_hold).execute() 

Ten przykład pokazuje, jak wyświetlić wszystkie blokady dotyczące sprawy:

Java

 
String matterId = "Matter Id";


// List all holds.
List holdsList = 
    client.matters().holds().list(matterId).execute().getHolds();

// Paginate on holds.
ListHoldsResponse response = client
        .matters()
        .holds()
        .list(matterId)
        .setPageSize(10)
        .execute();

String nextPageToken = response.getNextPageToken();
if (nextPageToken != null) {
    client
        .matters()
        .holds()
        .list(matterId)
        .setPageSize(10)
        .setPageToken(nextPageToken)
        .execute();
}
  

Python

# This can paginate in the same manner as with matters.
def list_holds(service, matter_id):
    return service.matters().holds().list(matterId=matter_id).execute()