Mit Richtlinien für die Anwendung "Dateien" arbeiten

Mithilfe der FilesPolicyService-Befehle können Sie Informationen zu Richtlinien hinzufügen, bearbeiten, zählen und zurückgeben. Richtlinien werden auf Bibliotheken angewendet, um die maximale Größe für diese Bibliotheken festzulegen.

Vorbereitende Schritte

Sie müssen den wsadmin-Client verwenden, um Verwaltungsbefehle zu verwenden. Weitere Informationen finden Sie im Abschnitt wsadmin-Client starten.

Vorgehensweise

Starten Sie den wsadmin-Client.
Starten Sie den Jython-Script-Interpreter der Anwendung "Dateien" mit dem folgenden Befehl:
```
execfile("filesAdmin.py")
```
Führen Sie die folgenden Befehle aus, um mit Richtlinien zu arbeiten:
FilesPolicyService.add(string title, long maximumSize)
Erstellt eine Richtlinie mit einem angegebenen Titel und einer maximalen Größe. Durch Richtlinien wird eine maximale Größenbegrenzung für Bibliotheken definiert.

Bei der Erstellung einer Richtlinie wird eine Richtlinien-ID erstellt und an Sie zurückgegeben. Die Richtlinien-ID weist das folgende Standard-UUID-Format (Universally Unique Identifier) auf: 00000000-0000-0000-0000-000000000000. Wenn Sie andere FilesPolicyService-Befehle ausführen, müssen Sie Richtlinien-IDs als Parameter bereitstellen. Richtlinien können mithilfe des Befehls "FilesLibraryService.assignPolicy" oder des Befehls "FilesLibraryService.assignPolicyBatch" Bibliotheken zugeordnet werden.

Eine Bibliothek ist eine Gruppe von Dateien, die einer Person oder einer Community gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.

Parameter:
title

Der Titel der Richtlinie. Dies ist ein erforderlicher Wert.

maximumSize

Die maximal zulässige Größe in Byte. Der Wert muss mindestens null sein. Der Wert null gibt an, dass die Größe uneingeschränkt ist.

Zahlen für ein Volumen ab 2 GB sind lange Literale. Sie müssen am Ende der Zahl ein "L" hinzufügen, z. B. muss eine Richtlinie von 2 GB als 2147483648L angegeben werden.
Beispiel:
```
FilesPolicyService.add("My Policy", 2147483648L)
```
FilesPolicyService.edit(string policyId, string title, long maximumSize)
Bearbeitet den Titel und die maximale Größe einer Richtlinie mit einer angegebenen Kennung. Falls sich die Kennung auf eine Standardrichtlinie bezieht, wird der Titel nicht geändert. Durch Richtlinien wird eine maximale Größenbegrenzung für Bibliotheken definiert. Eine Bibliothek ist eine Gruppe von Dateien, die einer Person oder einer Community gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.

Parameter:
policyID

Die Richtlinien-ID im folgenden Standard-UUID-Format (Universally Unique Identifier): 00000000-0000-0000-0000-000000000000.

title

Der Titel der Richtlinie. Dies ist ein erforderlicher Wert.

maximumSize

Die maximal zulässige Größe in Byte. Der Wert muss mindestens null sein. Der Wert null gibt an, dass die Größe uneingeschränkt ist.

Zahlen für ein Volumen ab 2 GB sind lange Literale. Sie müssen am Ende der Zahl ein "L" hinzufügen, z. B. muss eine Richtlinie von 2 GB als 2147483648L angegeben werden.
Beispiel:
```
FilesPolicyService.edit("2d93497d-065a-4022ae25-a4b52598d11a", "My Policy", 2147483648L)
```
FilesPolicyService.getById(string policyId)
Gibt Informationen zu einer einzelnen Richtlinie zurück, die anhand einer Kennung angegeben wird. Durch Richtlinien wird eine maximale Größenbegrenzung für Bibliotheken definiert. Eine Bibliothek ist eine Gruppe von Dateien, die einer Person oder einer Community gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.
Parameter:
policyId

Die Richtlinien-ID im folgenden Standard-UUID-Format (Universally Unique Identifier): 00000000-0000-0000-0000-000000000000. Die folgenden Informationen werden zurückgegeben:
id: Die Kennung.

title: Der Richtlinientitel.

maximumSize: Die maximal zulässige Größe der Bibliothek in Byte, bzw. 0 für uneingeschränkte Größe
Beispiel:
```
FilesPolicyService.getById("2d93497d-065a-4022ae25-a4b52598d11a")
```
FilesPolicyService.browse(string sortOption, string sortAscending, int pageNumber, int itemsPerPage)
Gibt eine Liste der Richtlinien mit Informationen zur Kennung, zum Titel und zur maximalen Größe zurück, wie sie für den Befehl "FilesPolicyService.getById(id)" beschrieben wurden. Durch Richtlinien wird eine maximale Größenbegrenzung für Bibliotheken definiert. Eine Bibliothek ist eine Gruppe von Dateien, die einer Person oder einer Community gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.

Parameter:
sortOption

Ein Zeichenfolgewert, der angibt, wie die Liste sortiert werden soll. Der Standardwert ist title, die Liste kann jedoch auch nach maximumSize sortiert werden.

sortAscending

Ein Zeichenfolgewert, der angibt, ob die Liste in aufsteigender alphabetischer Reihenfolge sortiert wird. Dies ist abhängig vom Parameter sortOption. Wenn für sortOption der Wert title angegeben ist, ist dieser Wert true; wenn sortOption einen anderen Wert enthält, lautet dieser Wert false.

pageNumber

Die Seitenzahl der zurückgegebenen Seite. Wenn der Wert für itemsPerPage beispielsweise 40 und der Wert für pageNumber 2 ist, gibt der Befehl die Elemente 41 bis 80 (Seite 2) anstatt der Elemente 1 bis 40 (Seite 1) aus.

itemsPerPage

Die maximale Anzahl der pro Seite aufzulistenden Richtlinien. Der Standardwert ist 20.
Beispiel:
```
FilesPolicyService.browse("title", "true", 1, 25)
```
FilesPolicyService.getCount()

Gibt die Gesamtzahl der Richtlinien zurück. Durch Richtlinien wird eine maximale Größenbegrenzung für Bibliotheken definiert. Eine Bibliothek ist eine Gruppe von Dateien, die einer Person oder einer Community gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.

FilesPolicyService.editPersonalDefault(long maximumSize)
Definiert die maximale Größe in Byte für die Standardrichtlinie der persönlichen Bibliothek. Die Standardrichtlinie wird auf alle persönlichen Bibliotheken angewandt, denen keine andere Richtlinie zugeordnet ist. Mithilfe der Standardrichtlinie können Sie die Größe der Bibliothek und damit die Größe des belegten Speicherplatzes steuern.

Eine persönliche Bibliothek ist eine Gruppe von Dateien, die einer einzigen Person gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.

Parameter:
maximumSize

Eine Zahl, durch die die maximal zulässige Größe in Byte für Bibliotheken dargestellt wird, denen die Standardrichtlinie zugeordnet wird.

Zahlen für ein Volumen ab 2 GB sind lange Literale. Sie müssen am Ende der Zahl ein "L" hinzufügen, z. B. muss eine Richtlinie von 2 GB als 2147483648L angegeben werden.
Beispiel:
```
FilesPolicyService.editPersonalDefault(2147483648L)
```
FilesPolicyService.editCommunityDefault(long maximumSize)
Definiert die maximale Größe in Byte für die Standardrichtlinie der Community-Bibliothek. Die Standardrichtlinie wird auf alle Community-Bibliotheken angewandt, denen keine andere Richtlinie zugeordnet ist. Mithilfe der Standardrichtlinie können Sie die Größe der Bibliothek und damit die Größe des belegten Speicherplatzes steuern.

Eine Community-Bibliothek ist eine Gruppe von Dateien, die einer Community gehören. Sie umfasst alle Versionen der Dateien, jedoch keine Metadaten, wie z. B. Kommentare.

Parameter:
maximumSize

Eine Zahl, durch die die maximal zulässige Größe in Byte für Community-Bibliotheken dargestellt wird, denen die Standardrichtlinie zugeordnet wird.

Zahlen für ein Volumen ab 2 GB sind lange Literale. Sie müssen am Ende der Zahl ein "L" hinzufügen, z. B. muss eine Richtlinie von 2 GB als 2147483648L angegeben werden.
Beispiel:
```
FilesPolicyService.editCommunityDefault(2147483648L)
```
FilesPolicyService.delete(string policyId)
Löscht die durch die Richtlinien-ID angegebene Richtlinie. Standardrichtlinien oder Richtlinien, die von Bibliotheken verwendet werden, können nicht gelöscht werden.

policyId

Die Richtlinien-ID im folgenden Standard-UUID-Format (Universally Unique Identifier): 00000000-0000-0000-0000-000000000000.
Beispiel:
```
FilesPolicyService.delete("f0d01111-9b21-4dd8-b8be-8825631cb84b")
```