Imports WINDREAMLib Imports WINDREAMLib.WMCOMEvent Imports WINDREAMLib.WMEntity Imports WINDREAMLib.WMObjectEditMode Imports WINDREAMLib.WMSearchOperator Imports WINDREAMLib.WMSearchRelation Imports WMOBRWSLib Public Class ClassWindream_allgemein #Region "+++++ Konstanten +++++" Const DEBUG = AUS Const AUS = 0 Const WINDREAM = 1 Const VARIABLEN = 2 #End Region #Region "+++++ Variablen +++++" Public oConnect ' der Typ darf nicht festgelegt werden (warum auch immer... geht sonst nicht) Public oSession 'As WINDREAMLib.WMSession ' der Typ darf nicht festgelegt werden (warum auch immer... geht sonst nicht) Public oBrowser As New WMOBRWSLib.ServerBrowser Public oDokumentTypen As WINDREAMLib.WMObjects #End Region #Region "+++++ Allgemeine Methoden und Funktionen +++++" ''' ''' Konstruktor für die windream-Klasse ''' ''' Sub New() ' wenn ein Fehler bei der Initialisierung auftrat If Not Me.Init() Then ' Nachricht ausgeben ClassLogger.Add("Achtung Es trat ein Fehler bei der Initialisierung der Klasse windream auf. Bitte prüfen Sie ob der windream-Server aktiv ist und alle Dienste gestartet sind.", True) ' das Programm "abschießen" Process.GetCurrentProcess.Kill() End If End Sub ''' ''' Initialisiert die statische Klasse (Login, Session starten, usw.) ''' ''' Liefert True wenn das Anmelden erfolgreich war, sonst False ''' Public Function Init() As Boolean Try Try ' Session-Objekt instanziieren und mit dem im Client ausgewählten Server belegen Me.oSession = CreateObject("Windream.WMSession", Me.GetCurrentServer) ' Connection-Objekt instanziieren Me.oConnect = CreateObject("Windream.WMConnect") 'MsgBox("windrem init 'ed") Catch ex As Exception Return False End Try ' wenn windream nicht angemeldet ist If Not Me.IsLoggedIn Then ' Art der Anmeldung an windream festlegen ' 0x0L (also 0) = Standard windream Benutzer ' WM_MODULE_ID_DOCTYPEEDITOR_LIC = ermöglicht Zugriff auf die windream Management Funktionen (Z.B. zur Verwaltung der windream Dokumententypen, Auswahllisten, etc.) ' WM_MODULE_ID_INDEXSERVICE = ermöglicht der Session die Indexierungs-Events vom windream DMS-Service zu empfangen Me.oConnect.ModuleID = 0 ' setzt die minimal erwartete windream-Version Me.oConnect.MinReqVersion = "3" ' -- Impersonifizierung nur möglich mit registry-eintrag -- ' oConnect.UserName "\schulung\windream" ' oConnect.Password "windream" ' Verbindung mit Session-Objekt (und dem ausgewählten Server) aufbauen Me.oConnect.LoginSession(Me.oSession) If Me.oSession.aLoggedin = False Then ClassLogger.Add("Achtung: Es konnte keine Verbindung mit dem windream-Server hergestellt werden", True) Return False End If ' AUSGABE VON SYSTEMINFORMATIONEN ' Gibt die Versionsart (Lizenztyp) also Small-Business-Edition (SBE), Small-Business-Extension (SBX) ' oder Business-Edition (BE) aus 'MsgBox("WindreamVersion: " & oSession.GetSystemInfo("WindreamVersion") & vbNewLine & "LicenceKey: " & oSession.GetSystemInfo("LicenceKey") & vbNewLine & _ ' vbNewLine & "LicenceName: " & oSession.GetSystemInfo("LicenceName")) 'Dim WMCtrl As AISCONTROLDATACOMLib.AISControlData 'WMCtrl = New AISCONTROLDATACOMLib.AISControlData '' liefert die Versionsnummer des Clients 'MsgBox(WMCtrl.WMWorkstationBuildNo) 'MsgBox(WMCtrl.W '' liefert den Servernamen des angemeldeten windreams 'MsgBox(WMCtrl.WMServerName) Try Me.oSession.SwitchEvents(WMCOMEventWMSessionNeedIndex, False) ' der Parameter WMEntityDocument definiert, dass nur Dokumenttypen und keine ' Ordnertypen ausgelesen werden Me.oDokumentTypen = Me.oSession.GetWMObjectTypes(WINDREAMLib.WMEntity.WMEntityDocument) Catch ex As Exception Return False End Try End If Return True Catch ex As Exception ClassLogger.Add("Achtung Fehler beim Login an windream - Evtl. Keine Verbindung zu windream: " & ex.Message, True) 'If Err.Number = -2147220985 Then ' ClassLogger.Add("Achtung Fehler beim Login an windream - Keine Verbindung zu windream: " & ex.Message, True) ' MsgBox("Die installierte windream-Version ist nicht ausreichend für den Betrieb der Tool Collection für windream." & vbNewLine & _ ' "Bitte kontaktieren Sie Digital Data." & vbNewLine & vbNewLine & "Fehlernachricht:" & vbNewLine & Err.Description, MsgBoxStyle.Exclamation, "Unzureichende windream-Version") 'Else ' ClassLogger.Add("Achtung Fehler beim Login an windream - Keine Verbindung zu windream: " & ex.Message, True) 'End If Return False End Try End Function #End Region #Region "+++++ Funktionen die für den Objekttyp relevate Informationen zurückliefern +++++" ''' ''' Liefert alle Indexe eines Objekttypen. ''' ''' Name des Objekttyps ''' Array mit allen Objekttyp zugeordneten Indexen als String ''' Public Function GetIndicesByObjecttype(ByVal name As String) As String() Try Dim oObjectType As WMObject Dim oIndexAttributes As WMObjectRelation Dim oIndexAttribute As WMObject Dim oIndex As WMObject Dim oRelProperties As WMObjectRelationClass ' den Objekttyp laden oObjectType = Me.oSession.GetWMObjectByName(WMEntityObjectType, name) ' Beziehung zu Indizes des Objekttyp auslesen oIndexAttributes = oObjectType.GetWMObjectRelationByName("TypeAttributes") ' Array für Indizes vorbereiten Dim aIndexNames(oIndexAttributes.Count - 1) As String ' alle Indizes durchlaufen For j As Integer = 0 To oIndexAttributes.Count - 1 ' aktuellen Index auslesen oIndexAttribute = oIndexAttributes.Item(j) ' Eigenschaften des Index auslesen oRelProperties = oIndexAttribute.GetWMObjectRelationByName("Attribute") ' Index aus den Eigenschaften auslesen oIndex = oRelProperties.Item(0) ' Indexname speichern aIndexNames(j) = oIndex.aName Next ' Indexarray zurückgeben Return aIndexNames Catch ex As Exception ClassLogger.Add("Achtung: Fehler beim Auslesen der windream-Indexe: " & ex.Message) Return Nothing End Try End Function ''' ''' Liefert einen Objekttyp als WMObject an Hand dessen Name. ''' ''' Name des Objekttyps ''' Objekttyp als WMObject ''' Public Function GetObjecttypeByName(ByVal objekttypName As String) As WMObject Try ' alle Objekttypen auslesen Dim oObjectTypes As WMObjects = Me.oSession.GetWMObjectTypes(WINDREAMLib.WMEntity.WMEntityDocument) ' alle Objekttypen durchlaufen und nach dem mit dem angegebenen Namen suchen For Each oObjectType As WMObject In oObjectTypes If oObjectType.aName = objekttypName Then Return oObjectType End If Next Return Nothing Catch ex As Exception ClassLogger.Add("Achtung: Fehler in GetObjecttypeByName: " & ex.Message) Return Nothing End Try End Function ''' ''' Überprüft ob der angegebene Index im Objekttyp existiert ''' ''' Name des zu durchsuchenden Objekttyps ''' Name des zu suchenden Indexes ''' Liefert True wenn der Index im Objekttyp existiert, sonst False ''' Public Function ExistIndexInObjekttyp(ByVal objekttyp As String, ByVal indexname As String) As Boolean Try Dim indexnamen() As String = Me.GetIndicesByObjecttype(objekttyp) If indexnamen Is Nothing Then Return False For Each index As String In indexnamen If index = indexname Then Return True Next Catch ex As Exception ClassLogger.Add("Achtung: Fehler in ExistIndexInObjekttyp: " & ex.Message) End Try Return False End Function #End Region #Region "+++++ Allgemeine Funktionen die Informationen zurückliefern +++++" ''' ''' Liefert True wenn die windream-Session angemeldet ist und False für den Fall, dass die Session nicht eingeloggt ist. ''' ''' Anmeldestatus als Boolean ''' Public Function IsLoggedIn() As Boolean Try Return Me.oSession.aLoggedin Catch ex As Exception ClassLogger.Add("Achtung: Fehler in IsLoggedIn: " & ex.Message) End Try Return False End Function ''' ''' Liefert den Servernamen an dem windream aktuell angemeldet ist. ''' ''' Servername als String ''' Public Function GetCurrentServer() As String Try Return Me.oBrowser.GetCurrentServer 'ClassWindream.oBrowser.GetCurrentServer Catch ex As Exception ClassLogger.Add("Achtung: Fehler in GetCurrentServer: " & ex.Message) End Try Return "" End Function 'Public Function GetSharedCurrentServer() As String ' Try ' Return ClassWindream.oBrowser.GetCurrentServer ' Catch ex As Exception ' MsgBox("Der aktuell gewählte windream-Server konnte nicht ausgelesen werden." & vbNewLine & vbNewLine & "Fehlernachricht:" & vbNewLine & ex.Message, MsgBoxStyle.Critical, "Fehler beim Auslesen des windream-Servers") ' End Try ' Return "" 'End Function ''' ''' Liefert das Windream-Laufwerk des windream-Servers, in Form '[Laufwerksbuchstabe]:'. (z.B. 'W:') ''' ''' Laufwerksbuchstabe mit Doppelpunkt als String ''' 'Public Function GetWindreamDriveLetter() As String ' Try ' Dim oControl As AISCONTROLDATACOMLib.AISControlData ' Dim sDrive As String = "" ' oControl = New AISCONTROLDATACOMLib.AISControlData ' sDrive = oControl.GetStringValue(&H10040003) ' Return sDrive & ":" ' Catch ex As Exception ' MsgBox("Fehlernachricht: " & ex.Message, MsgBoxStyle.Critical, "Fehler beim Auslesen des windream-Laufwerks") ' End Try ' Return "" 'End Function ''' ''' Liefert den Typen eines Indexes als Integer. ''' ''' Name des zu überprüfenden Indexfeldes ''' Liefert eine Zahl, die einen Typen beschreibt ''' Public Function GetTypeOfIndexAsIntByName(ByVal indexname As String) As Integer Try Dim oAttribute = Me.oSession.GetWMObjectByName(WINDREAMLib.WMEntity.WMEntityAttribute, indexname) Dim vType = oAttribute.getVariableValue("dwAttrType") Return vType Catch ex As Exception Return Nothing End Try End Function #End Region End Class