CLARC CONTENT SERVER Konfiguration
- Dennis Balzuweit
- Merve Yurdakul
Owned by Dennis Balzuweit
Grundeinstellungen
Mit einem Doppelklick auf den C4 Konfigurationsknoten /clarc/Software/clarc content server/Basics wird der Dialog zur Konfiguration der Grundeinstellungen geöffnet.
Der Dialog kann ebenfalls über den entsprechenden Schnellzugriffs-Button (Konfiguration), Enter oder das Kontext-Menü geöffnet werden.
/clarc/Software/clarc content server/Basics
| Parameter | Beschreibung |
|---|---|
Basics | |
| Log level | Der vom Server zu verwendende Log-Level. |
| Create log file | Logdatei erzeugen - ja/nein. |
Security | |
| Allow external requests | Erlaubt HTTP Anfragen welche nicht vom lokalen System kommen. Wichtig z.B. für das API Szenario. |
| Use trusted ip list | Es werden nur HTTP Anfragen von Systemen akzeptiert, welche in der Liste der vertrauenswürdigen IP-Adressen aufgeführt sind. |
| Trusted ip list | Liste der vertrauenswürdigen IP-Adressen. Siehe "Use trusted IP list". Die Adressen werden mit "," getrennt aufgeführt. |
| Allow api keys | Konfiguration und Verwendung von api keys erlaubt ja/nein |
Security SAP | |
| Allow put certification | Erlaubt das Senden von Zertifikaten an den SAP Content Server. |
| Auto accept certificates (set active when sent) | Ist diese Option ausgewählt, werden die übertragenen Zertifikate direkt aktiviert. Ansonsten werden die Zertifikate in den C4 Ordner "Pending" eines Repositories abgelegt und können von dort aus aktiviert werden. Siehe Repository Konfiguration. |
| Check SAP Interface version | Ermöglicht eine Prüfung der Interface Version von SAP, wenn die Option aktiv ist. |
| SAP URL security | Bestimmt, ob bei einem Request von SAP die URL signiert und geprüft werden soll. Wird diese Einstellung auf false gesetzt (nicht empfohlen), kann der Betrieb mit SAP auch ohne übermitteltes Zertifikat erfolgen. |
| Default document protection | Das ist der Standardschutz, wenn kein Zugriffsparameter von SAP in der URL mitgegeben wird.
|
Provider
Die Konfiguration erfolgt über folgenden Knoten:
/clarc/Software/clarc content server/Provider
| Parameter | Beschreibung |
|---|---|
Fulltext | |
| Provider name | Frei zu vergebender Name des Providers |
| Provider type |
|
| noch nicht unterstützt | |
Metadata | |
| Provider name | Frei zu vergebender Name des Providers |
| Provider type |
|
Provider settings - Typ: MongoDB | |
| Hostname / IP | Hostname oder IP zur MongoDB |
| Port | Port zur MongoDB |
| Replica set name | Name des replica sets (wenn aufgesetzt). Die Hosts und dir Port eines Replica sets müssen kommasepariert angegeben werden. |
| Database name | Datenbankname |
| Collection prefix/name | Prefix für den Namen einer Collection. (Standard: ContSrvRepo_) Aus dem Prefix und dem Namen des repositories ergibt sich der endgültige Name einer Collection in der MongoDB. |
| Use custom collection name | Ist diese Option gesetzt, wird statt dem Prefix der angegebene Name für die Collection verwendet. |
| User name | Username für MongoDB |
| Password | Passwort des Users für MongoDB |
| Authentication DB | Datenbankname für die Authentifizierung zur MongoDB ( |
Transport layer security (TLS) | TLS benutzen ja/nein |
| Collation locale | Standard Spracheinstellungen bei text suche (Standard: en) |
Provider settings - Typ: MongoDB SQL-92 | |
| Wie MongoDB, nur mit anderer Ablageschnittstelle (MongoDB wird empfohlen) | |
Provider settings - Typ: Elastic Search | |
| Hostname / IP | Hostname oder IP zur MongoDB |
| Port | Port für requests (Standard: 9200) |
| Base URL | Basis URL für requests zu Elastic Search (Standard: /) |
| Index name | Name des Index in Elastic Search (Standard: documents) |
| Index type | Typ des Index in Elastic Search (Standard: _doc) |
Storage | |
| Provider name | Frei zu vergebender Name des Providers |
| Provider type |
|
Provider settings - Typ: WindowsFileSystem | |
| Current folder path | Stammverzeichnis in welchem die Daten abgelegt werden. Es werden automatisch Unterverzeichnisse entsprechend der konfigurierten repositories angelegt. |
| Used folder paths | Historie der verwendeten Stammverzeichnisse |
| Temp folder path | Verzeichnis zur Ablage von temporäre Dateien |
| Encryption method |
|
| Folder structure | 2/2 oder 2/3 (Standard). Legt die Verzeichnisstruktur fest. Für eine voraussichtlich sehr große Dokumentenanzahl sollte 2/3 benutzt werden. |
Provider settings - Typ: OtrisEAS | |
| Hostname / IP | Hostname oder IP des Servers |
| Base URL | Basis-URL der requests zu Server. Standard: /eas/archives |
| Port | Port der requests. Standard 8085 |
| Username | Username |
| Password | Passwort |
| Store | Ablagename (Store) im EAS system |
| EAS Identity | Otris-EAS user Identität |
| EAS Tokens | Tokens als UUID für requests |
Provider settings - Typ: Centera | |
| noch nicht unterstützt | |
leave empty für default)Repository Konfiguration
Hinweis
Die Konfiguration muss bis zur Version 5.3 manuell erfolgen. Siehe C4 Expertenmodus aktivieren.
Die Konfiguration erfolgt über folgenden Knoten:
/clarc/Software/clarc content server/Repositories
COMMON / SAP / VIRTUAL Knoten
| Parameter | Beschreibung |
|---|---|
Repository | |
| Repository name | Name des Repositories |
| Display name | Angezeigter Name im CLARC SEARCH CENTER |
| Repository description | Hier kann eine Beschreibung für die Repository hinterlegen. |
| Default language | Standardsprache für dieses Repository |
| active | Gibt an, ob das Repository aktiviert ist. |
| visible | Sichtbar im CLARCH SEARCH CENTER ja/nein (nur COMMON und VIRTUAL) |
| Allowed access modes | Erlaubte Zugriffsarten auf das Repository:
|
Display names | |
| Language | Ländereinstellung |
| Display name | Name im CLARC SEARCH CENTER für das konfigurierte Land |
Provider | |
| Storage provider | Auswahlfeld für konfigurierte Storage-Provider |
| Metadata provider | Auswahlfeld für konfigurierte Metadata-Provider |
| Fulltext provider | Auswahlfeld für konfigurierte Fulltext-Provider (aktuell nicht unterstützt) |
Advanced | |
| Versioning is active | Versionierung ja/nein (Standard: nein). Geänderte Dokumente werden versioniert. Gelöschte Dokumente werden dabei physikalisch gelöscht. |
| Compliance mode is active | Compliance ja/nein (Standard: nein). Geänderte Dokumente werden versioniert, aber gelöschte Dokumente dabei nur als gelöscht markiert. |
API | |
| Api key | Angabe eines API Keys für die Schnittstelle. Bei Benutzung eines API Keys ist keine Authentifizierung am Server nötig. |
Permissions | |
| Konfiguration der Gruppen mit Zugriffsrechten | |
COMMON Knoten
| Parameter | Beschreibung |
|---|---|
Fields | |
| Fields scheme | Auswahl eines im C4 konfigurierten Feldschemas (optional) |
| Search fields | Auswahl einer im C4 konfigurierten Liste von Suchfeldern im Feldschema (optional). Verwendet im CLARC SEARCH CENTER |
| Result fields | Auswahl einer im C4 konfigurierten Liste von Trefferlisten im Feldschema (optional). Verwendet im CLARC SEARCH CENTER |
| Table fieldscheme | Auswahl eines im C4 konfigurierten Feldschemas (optional) für die Repräsentation einer Tabelle |
| Validate passed data with fieldscheme | Sollen die übergebenen Daten mit dem Feldschema validiert werden (ja/nein) |
| Restrict passed data to fieldscheme settings | Nur gültige Felder aus dem Feldschema dürfen übergeben werden (ja/nein) |
Documents | |
| Default doctype name | Standard Name für den Dokumenttyp (Mappentyp in documents). Wird über die Suche in documents nach diesem Dokumenttyp gesucht, wird für Dokumente mit leerem Typen im Repository dieser als name als Typ genommen und in der Suche berücksichtigt. |
| Fieldscheme mapping | Mapping zwischen dem Mappentyp aus documents und dem Feldschema in CLARC. Die einzelnen Felder müssen mit Namen und Typen exakt übereinstimmen. |
| Fieldscheme | Feldschema in CLARC |
| Doctype name | Mappentyp aus Documents |
WORM | |
| Lock files | Dateien werden auf dem Storage gesperrt ja/nein (Standard: nein). Für die Aktivierung der WORM-Funktionalität ist ein Metadatenprovider notwendig. |
| Retention time | Anzahl Tage der Sperrung |
| Locking delay | Sperrung erfolgt nach der angegebenen Anzahl Minuten nach Ablage es Dokuments |
SAP Knoten
SAP Repositories benötigen einen Mandanten (Tenant), der auf dem SAP Knoten angelegt werden kann. Anschließend erfolgt die Konfiguration des Repositories über diesen Mandanten-Knoten.
| Parameter | Beschreibung |
|---|---|
Advanced | |
| Used as ILM repository | Repository wird zur Speicherung von ILM Informationen (WebDAV) aus SAP genutzt ja/nein (Standard: nein) |
| Protected by ILM repository | Auswahl eines Repositories, das ILM Informationen speichert. Damit können Dokumente in SAP Repositories gegen löschen geschützt werden. |
| Tunnel to AchiveLink archive | Aktivieren einer Tunnelverbindung zu einem beliebigen ArchiveLink Archiv. |
| Certificate | Auswahl eines erzeugten Zertifikats für den Zugriff auf das ArchiveLink Archiv. Ein Zertifikat (PKCS#7) kann mit dem Knopf auf der rechten Seite erzeugt werden. Dort muss ein Passwort und ein Hash Algorithmus gewählt werden. Ebenfalls müssen Angaben des Ausstellers erfasst werden, damit eine Aussteller ID (Authentication ID) erzeugt werden kann. Für eine Beschreibung der Felder siehe https://de.wikipedia.org/wiki/X.509 |
| Certificate password | Das beim Erzeugen des Zertifikats gewählte Passwort |
| Authentication ID | Die beim Erzeugen des Zertifikats generierte Authentication ID. Eventuell vorhandene Leerzeichen dürfen dabei nicht manuell gelöscht werden. |
| Base path to archive (URL) | Die URL zum ArchiveLink Archiv |
| ArchiveLink version | Version der ArchiveLink Schnittstelle (in der Regel 0045, 0046 oder 0047) |
| External repository name | Name des ArchiveLink Archiv |
| Test connection | Prüft die Verbindung zum ArchiveLink System |
| Get server info | Holt Informationen des ArchiveLink Servers |
| Send public certificate | Sendet das erzeugte Zertifikat zum ArchiveLink Server. Dort muss das Zertifikat dann aktiviert werden, damit Daten gelesen werden können |
Certificates | |
Listet alle übertragenen Zertifikate aus SAP auf (nicht zu verwechseln mit den Zertifikaten aus dem Reiter Advanced). Ausgewählte Zertifikate befinden sich unter dem Knoten "Certificates". Die Einträge, die in der Liste nicht ausgewählt sind befinden sich unter "Certificates/Pending". Durch das an- und auswählen werden die Zertifikate entsprechend verschoben. Details zu den Zertifikaten werden angezeigt, wenn man den jeweiligen Eintrag per Doppelklick öffnet | |
VIRTUAL Knoten
Virtuelle Repositories können zusammengeführte COMMON Repositories, aber auch z.b. ein eingeschränktes einzelnes COMMON Repository sein. Zu beachten ist, dass bei der Auswahl mehrerer Quell-Repositories zwingend das gleiche Feldschema hinterlegt sein muss. Über Suchkriterien kann die Ergebnismenge eines virtuellen Repositories angepasst werden (z.b. nur Dokumenttypen "Rechnung"). Es werden keine Daten in virtuellen Repositories gespeichert, sondern es ist lediglich die Anzeige einer Menge von Dokumenten basierend auf den gewählten Quell-Repositories. Daten müssen immer in den zugehörigen Quell-Repositories abgelegt werden.
| Parameter | Beschreibung |
|---|---|
Source repositories | |
| Auswahl der zu verwendenden Quell-Repositories. | |
Search criteria | |
| Logical AND queries | Jede Zeile dieser Liste wird logisch mit UND verknüpft. Die Syntax eines queries entspricht dabei dem OData Standard. Mit dem "+" Knopf kann eine logische ODER Sequenz erstellt werden. Zur Auswahl stehen dabei die im Feldschema hinterlegten Felder, sowie einige interne Felder (_createdate, _changedate,...). Durch die Kombination logischer ODER Sequenzen mit logischen UND Sequenzen können komplexe Abfrage erzeugt werden, die immer die Basis bei Anfragen an das virtuelle Repository sind. |
Aktivierung
Die vorgenommenen Änderungen werden über den C4 Button "Refresh Services" übernommen.