Metadaten

Das Schleupen.CS Document Lifecycle Management nutzt Metadaten. Es ist in der Lage, Metadaten zu erstellen, zu verwalten und Dokumenten zuzuordnen.

Prozesse & Konzepte: Metadaten

Metadaten dienen der Sammlung von Informationen die zu einem Dokument zur Verfügung stehen. Sie sind selbst nicht Teil des Dokuments, gehören also nicht zu dessen Inhalt. Sie ermöglichen es, Dokumente besser aufzufinden und zu klassifizieren. Sie erlauben es, Beziehungen zwischen Dokumenten oder Dokumenten und CS 3.0 Objekten (z.B. Verträgen) herzustellen. Sie können in Verarbeitungsregeln genutzt werden.

Arten von Metadaten

CS 3.0 unterstützt die folgenden Arten von Metadaten:

  1. Systemmerkmale
  2. Ordnungsmerkmale
  3. Geschäftsobjektreferenzen

Die Struktur der Metadaten ist stark an die Archivstruktur angelehnt, um ein einfaches Mapping zwischen Dokumentendaten und Archivdaten zu ermöglichen und die Archiv-Recherche der Dokumentensuche anzugleichen.

Metadaten-Schema

Da Metadaten als XML-Daten verarbeitet werden, liegt es nahe, für deren Strukturdefinition ein XML-Schema (XSD) zu verwenden. Dieses kann genutzt werden um zu prüfen, ob ein XML-Dokument der Schema-Definition genügt.

Die Verwaltung der Metadaten-Schemata in Schleupen.CS, erfolgt über PowerShell Cmdlets.

Neues Schema erstellen

New-CSMetadataSchema erzeugt ein neues Schema-Objekt in der PowerShell. Dieses ist noch nicht in Schleupen.CS gespeichert.

New-CSMetadataSchema -Name <String> -Namespace <String> -ExternalVersion <String> [-Abstract <Switch>] [-DerivedFrom <String>] [-CabinetFileInfoId <Guid>]

Parameter

  • Name <String> = Der Name des neuen Schemas.
  • Namepsace <String> = Der Namensraum des neuen Schemas.
  • ExternalVersion <String> = Die externe Versionsnummer des neuen Schemas.
  • Abstract <Switch> = Gibt an ob das Schema abstrakt ist. D.h. dieses Schema dient als Vorlage für darauf aufbauende Geschäftsobjekte
     (Beispiel: Person (abstract) - Girokontoinhaber) (Keine Pflichtangabe)
  • DerivedFrom <String> = Gibt an ob das Schema, eine Spezialisierung eines anderen Schemas ist (keine Pflichtangabe).
  • CabinetFileInfoId <Guid> = Die Id des zugehörigen CabinetFileInfos (keine Pflichtangabe).

Schema speichern

Save-CSMetadataSchema speichert ein Metadaten-Schema im Schleupen.CS System.

Save-CSMetadataSchema -MetadataSchema <CSMetadataSchema> -XsdFilePath <String> -SessionToken <String>

Parameter

  • MetadataSchema <CSMetadataSchema> = Das zu speichernde Schema.
  • XsdFilePath <String> = Der vollständige Pfad (inkl. Dateiname) der Datei.
  • SessionToken <String> = Das Session Token für den Knoten in der Systemstruktur.

Beispiel:
Erstellt ein neues Metadaten Schema, fügt die entsprechende Datei, welche sich im Verzeichnis $xsdFilePath befindet, hinzu und speichert dieses anschließend. Der zugehörige Systemstrukturknoten wird als Session Token übergeben.

$sessionToken = Request-SessionToken -ViewName Standard -ElementName 9999 -ElementTypeName Mandant -SystemUsages Produktiv
$metadataSchema = New-CSMetadataSchema -Name 'SystemAndClassificationAttribute_Schema' -Namespace 'Schleupen.CS' -ExternalVersion '3.0'
$xsdFilePath = Join-Path $PSScriptRoot -ChildPath 'FileName.xsd'
Save-CSMetadataSchema -MetadataSchema $metadataSchema -XsdFilePath $xsdFilePath -SessionToken $sessionToken

Bestehendes Schema auswählen

Select-CSMetadataSchema liest ein bereits vorhandenes Schema anhand der übergebenen Parameter.

Select-CSMetadataSchema -Name <String> -Namespace <String> -ExternalVersion <String> -SessionToken <String>

Parameter

  • Name <String> = Der Name des gesuchten Metadaten Schemas.
  • Namespace <String> = Der Namensraum des gesuchten Metadaten Schemas.
  • ExternalVersion <string> = Die Externe Versionsnummer des Metadatenschemas.
  • SessionToken <String> = Das Session Token für den Knoten in der Systemstruktur.

Beispiel:

$sessionToken = Request-SessionToken -ViewName Standard -ElementName 9999 -ElementTypeName Mandant -SystemUsages Produktiv
Select-CSMetadataSchema -SessionToken $st -Name 'TestName' -Namespace 'Schleupen.CS.AP.DM' -ExternalVersion '3.0'
Cookie Consent mit Real Cookie Banner