Dieses Dokument stellt die Definition für Anwendungen in cardo3 dar. Voraussetzung ist cardo Version 3.4.2 oder höher.
Änderungen werden immer unter Berücksichtigung der Abwärtskompatibilität durchgeführt. Beachten Sie gegebenenfalls Hinweise an einzelnen Elementen, ab welcher cardo Version diese eingesetzt werden können.
Ausführliche Details und Beispiele finden Sie online unter http://www.cardogis.com/content.asp?pgid=159
Konfiguration der Anwendung, Startseite, Image, Fenstereigenschaften etc.
Die Sicherheitsthemen für diese Anwendung. Eine Anwendung kann 0...n Sicherheitsthemen definieren.
Weitere Informationen zum Rechtekonzept sind unter http://www.cardogis.com/content.asp?pgid=171 nachzulesen.
Die Sicherheitsthemen für diese Anwendung. Eine Anwendung kann 0...n Sicherheitsthemen definieren.
Der Key des Knotens innerhalb der Stufe muss eindeutig sein.
Hinweis: Es kann hier nicht zwischen Groß-/Kleinschreibung unterschieden werden.
Der Key des Sicherheitsthemas innerhalb der Anwendung muss eindeutig sein.
Hinweis: Es kann hier nicht zwischen Groß-/Kleinschreibung unterschieden werden.
Jede Anwendung muss einen eindeutigen Schlüssel definieren. Dieser Schlüssel sollte den Firmennamen des Anbieters und einen anwendungsspezifischen Teil haben.
Bei den Schlüsseln wird nicht zwischen Groß-/Kleinschreibung unterschieden.
Der Schlüssel darf nur aus den Zeichen a-Z, 0-9 und . bestehen und muss mit einem Buchstaben beginnen.
Wenn die Anwendung als IApplication Instanz vorliegt, wird dieser Parameter bei der Registrierung aus der Klasseninstanz verwendet und die hier gemachte Angabe wird davon überschrieben.
Der FullTypeName muss den vollqualifizierten .NET Typename für das Administrationsobjekt der Anwendung beschreiben.
Wenn die Anwendung als IApplication Instanz vorliegt, wird dieser Parameter bei der Registrierung aus der Klasseninstanz verwendet und die hier gemachte Angabe wird davon überschrieben.
Beschreibt die Laufzeit-Konfiguration der Anwendung. Dabei handelt es sich um die Eigenschaften, die der Programmierer konfigurierbar behandelt haben möchte.
Das System stellt die entsprechende Oberfläche für die Parametereingabe zur Verfügung.
Hier muss der FullName eines .NET Type angegeben werden, der das Interface IDU.cardo3.Api.Applications.IApplicationRuntimeConfiguration implementiert.
Der Anwendungstitel ist nicht optional und sollte eine kurze prägnante Beschreibung der Anwendung bieten.
In der Regel definiert eine Anwendung hier eine Startseite. Die Angabe erfolgt als URL relativ zum Web-Root.
Bsp:
Relativ zum Web-Root: /net3/project/cardo3Apps/MyApplicationKey/start.aspx
Jede Anwendung muss ein Icon bereitstellen. Die URL muss vom Browser des Anwenders erreichbar sein. Internet URLs werden nicht empfohlen.
Das Bild sollte im Format Png24 vorliegen und eine Größe von 48x48 Pixel haben.
Wenn cardo das Fenster erstellt, können hier die Standardeigenschaften belegt werden.
LayerTags definieren die Verbindung zwischen einer Ebene und einer Anwendung. cardo bietet dann z.B. bei einer Selektion
die Möglichkeit, die entsprechende Anwendung aufzurufen.
Die hier vergebenen Layer-Tags muss der Betreuer an den entsprechenden Ebenen einstellen. Die Eigenschaft in cardo heißt "Anwendungsname der Ebene".
Tags stellen einen Alias dar. Die internen Ebenennamen basieren auf einem Autowert, dadurch kann eine Anwendung bei verschiedenen Installationen die Ebene identifizieren.
Versionshinweis: Das Element LayerTags wird erst ab Version 3.4.3.9322 unterstützt.
Der Key des Knotens innerhalb der Stufe muss eindeutig sein.
Hinweis: Es kann hier nicht zwischen Groß-/Kleinschreibung unterschieden werden.
Wenn vorhanden, dann stellt cardo4 die Anwendungschicht für den Aufruf bereit.
Gibt an, ob die Laufzeit eine Rechteprüfung für den Start anbieten soll. Dadurch wird im Wesentlichen gesteuert, ob das Anwendungs-Icon für den jeweiligen
Benutzer dargestellt wird.
Der .NET Typename für den Enum Typ, der die Rechte *aller* folgenden Knoten repräsentiert.
Folgende Build-In Typen sind vordefiniert:
IDU.cardo3.Api.Buildin.YesNo;
IDU.cardo3.Api.Buildin.SelectInsertUpdateDeleteExecute
IDU.cardo3.Api.Buildin.SelectInsertUpdateDelete;
Der .NET Typename für die als Tag abgelegten Daten zu einem Sicherheitsknoten.
Wenn ein Tag gespeichert werden soll, muss ein TagType definiert werden.
Der Anzeigetitel dieses Rechtethemas.
Die Rechte für dieses Thema.
Der Key der Knoten innerhalb der Stufe muss eindeutig sein.
Hinweis: Es kann hier nicht zwischen Groß-/Kleinschreibung unterschieden werden.
Der innerhalb dieser Anwendung eindeutige Schlüssel für dieses Rechtethema.
Bei den Schlüsseln wird nicht zwischen Groß-/Kleinschreibung unterschieden.
Der Schlüssel darf nur aus den Zeichen a-Z, 0-9 und . bestehen und muss mit einem Buchstaben beginnen.
Hinweis für die Sortierung während der Anzeige in der Verwaltungskonsole.
Css-Klasse(n) für Anwendungs-Icon, Bsp.:"iduit-core-icon-fa iduit-core-icon-fa-commenting-o"
Optionale Beschreibung der Anwendung
Optionales Css, z.B. für IconClassName, ohne Style-Tags
JavaScript-Code, der ein Objekt beschreiben muss, was dem Interface Cardo3ApplicationWrapperBase.ICustomerWellknowTypeHandler entspricht.
Der Code wird im cardo4 Kontext ausgeführt. Wenn diese Methode verwendet wird, dann muss auch registerWktHandler des Cardo324ApplicationProxy von der cardo3 Anwendung aufgerufen werden.
Der Name der Eigenschaft in dem Feature, dass vorhanden sein muss, damit die Anwendung auf dieses Feature reagiert.
Der Eigenschaftsname ist case-sensitiv.
Wenn das Element vorhanden ist, muss auch showInCardo4 true sein.
Der Titel dieses Rechts.
Ein Tag ist ein beliebiges Objekt, welches einem Knoten zugewiesen werden kann.
Das Objekt wird mittels XML (De)Serialisierung verwendet.
Die Daten müssen vom Typ TagTypeFullName des Themas sein.
Definiert weitere Unterknoten.
Der innerhalb dieses Knotens eindeutige Schlüssel für dieses Recht.
Bei den Schlüsseln wird nicht zwischen Groß-/Kleinschreibung unterschieden.
Der Schlüssel darf nur aus den Zeichen a-Z, 0-9 und . bestehen und muss mit einem Buchstaben beginnen.
Hinweis für die Sortierung während der Anzeige in der Verwaltungskonsole.
Default ist der Standardwert, kein spezielles Verhalten.
In diesem Ordner dürfen Benutzer eigene Knoten erstellen.
Die Unterknoten werden bei Updates nicht angefasst.
Nur zulässig an Ordnern unterster Ebenen.
Diesen Ordner bei Updates ignorieren.
Die Anwendung wird nicht in der Endanwenderoberfläche mit aufgelistet (bei registrierten Anwendungen aber zum Start mit angeboten).
Die Anwendung steht erst einmal allen Benutzern zur Verfügung.
Rechte für den Start werden nicht ausgewertet.
Die Anwendung erhält eine Konfiguration in der festgelegt werden kann, welche Benutzer diese Anwendung starten dürfen.
Die Anwendung implementiert IApplication (FullTypeName muss belegt sein). Vor der Anzeige wird die Methode "AccessibleForCurrentUser" der Schnittstelle IApplication aufgerufen.
Die (optionale) URL zu einem 16x16 Pixel großen Bild, für das Fenster.
Die Startbreite des Fensters in Pixeln.
Die Starthöhe des Fensters in Pixeln.
Die Mindestbreite des Fensters in Pixeln.
Die Mindesthöhe des Fensters in Pixeln.
Gibt an, ob das Fenster in der Größe veränderbar sein soll.
Startwert in X-Richtung in Pixeln.
Startwert in Y-Richtung in Pixeln.
Startmodus des Fensters, normal, minimiert oder maximiert.
Das Fenster wird mit StartHeight/StartWidth geöffnet.
Das Fenster wird maximiert geöffnet.
Das Fenster wird minimiert geöffnet.
Gibt an, ob die Statusbar des cardo Windows ausgeblendet werden soll.
Hier gibt es die Möglichkeit eine Hilfeseite in die Anwendung zu integrieren. Diese ist dann über den Hilfebutton im Fenstertitel erreichbar.
Die komplette URL zur Hilfeseite der Anwendung.
Die ID der ITN - Hilfeseite für diese Anwendung.
Schaltet einen weiteren Link in das Anwendungsfenster der das ChangeLog (Ordner .idu, Datei ApplicationDescription.xml) anzeigt.
Eine optionale Beschreibung, z.B. welche Einschränkungen gelten, oder welche speziellen
Eigenschaften an dieser Ebene erwartet werden.
Der eindeutige Tag dieser Ebene. Der cardo Betreuer muss für eine Ebene im administrativen Baum
dazu die Eigenschaft "Anwendungsname der Ebene" entsprechend diesem Wert vergeben.
Der Tag sollte immer in Großschreibung angegeben werden.
Art der Übereinstimmung für LayerTags (Anwendungsspezifischer Ebenenname).
Der an der Ebene definierte LayerTag muss mit dem hier angegebenen Wert genau übereinstimmen (Groß-/Kleinschreibung wird nie berücksichtigt).
Der an der Ebene definierte LayerTag beginnt mit dem hier definierten Wert (Groß-/Kleinschreibung wird nie berücksichtigt).
Der an der Ebene definierte Layertag enthält die hier angegebene Zeichenfolge (Groß-/Kleinschreibung wird nie berücksichtigt).