GISX 3 - Administratordokumentation : Dialogdefinition

Allgemeines

Die Dialogdefinition gliedert sich in mehrere Unterbereiche:

  • Dialogdefinition: Die Maske an sich selbst, inklusive Maskenkomponenten, Tabellen, Bilder etc.
  • Formdefinition: Maskenkomponente zur Anzeige von Attributen ("Card") eines Objekts
  • Tabellendefinition: Tabellenkomponente zur Auflistung mehrerer Objekte
  • Bildergaleriedefinition : Bildergaleriekomponente

Mit der Dialogdefinition kann mittels einer xml-Datei der Dialog an sich selbst definiert werden, dessen Komponenten und es können Formdefinitionen importiert werden.
Die Formdefinition ermöglicht es mittels einer xml-Datei den Inhalt dieser zu definieren und kann dann im Anschluss bei Bedarf mittels einer Dialogdefinition importiert und somit verwendet werden. 

Aufbau einer Dialogdefinition

Dialogdefinitionen erfolgen in XML. Es empfiehlt sich folgende Deklaration:

<?xml version="1.0" encoding="UTF-8"?>
<Dialog xmlns="http://www.geograt.de/namespaces/gisx3/dialogdefinition/1.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
</Dialog> 

Dialogdefinitionen werden im Unterverzeichnis "dialogs" abgelegt und müssen die Dateiendung ".xml" besitzen. Es gelten die allgemeinen Hinweise zur Benamung.

Beispiel für eine Dialogdefinition:

<?xml version="1.0" encoding="UTF-8"?>
<Dialog xmlns="http://www.geograt.de/namespaces/gisx3/dialogdefinition/1.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<title>Showcase</title>
    <layout>
  		<gridColumns>6</gridColumns>
    </layout>
	<component id="componentIdA">
		<referencedForm>
			<formId>components.commoninformation</formId>
		</referencedForm>
	</component>
	<component>
		<referencedForm>
			<formId>Components.oTHerINFormation</formId>
			<requestId>
				<attribute>
					<attribute>TestAttribute</attribute>
					<parent>ComponentIdA</parent>
				</attribute>
			</requestId>
			<requestTheme><constant><value>SomeConstant</value></constant></requestTheme>
		</referencedForm>
	</component>
	<component id="componentida">
		<referencedTable>
			<tableId>components.tableDefinition</tableId>
			<parameter>
				<name>verbindung</name>
				<type>
					<attribute>
						<attribute>C09</attribute>
					</attribute>
				</type>
			</parameter>
		</referencedTable>
	</component>
	<component>
		<referencedImageGallery>
			<imageGalleryId>components.aImageGallery</imageGalleryId>
		</referencedImageGallery>
	</component>
	<component id="innerForm">
		<form>
			<title>Inline Form</title>
			<content>
				<field>
					<name>Test</name>
					<content>
						<featureAttribute>
							<name>C09</name>
						</featureAttribute>
					</content>
				</field>
			</content>
		</form>
	</component>
</Dialog>

Es gilt:

  • <layout><gridColumns> := OPTIONALAnzahl der verfügbaren Spalten (Default: 4)
  • <component id=""> := Definition einer Komponente in einem Dialog. Für jede Komponentendefinition ist ein neuer <component> Block zu erstellen.
    Zusätzlich wird die Komponente mit einem zugehörigen Attribut "id" versehen, dass die Komponente mit einer eindeutigen id versieht. Diese wird für Referenzierungen verwendet.  

Die Komponentendefinitionen können entweder importiert werden oder direkt im Dialog definiert werden.

An direkte Komponentendefinition sind derzeit Formdefinitionen, Tabellendefinitionen sowie Bildgaleriedefinitionen möglich. 

  • <referencedForm> | <referencedTable> | <referencedImageGallery> := Import einer FormdefinitionTabellendefinition oder Bildgaleriedefinition
    • <formId> | <tableId> | <imageGalleryId> := Die Id einer Form, einer Tabelle oder einer Bildergalerie. Groß-/Kleinschreibung spielt bei der Id der Komponentendefinition keine Rolle.
    • <parent> := Optionale Angabe. Angabe der Komponenten-Id des Elternteils, auf dem sich diese Komponente bezieht, d.h. die Grundlage der in dieser Komponente dargestellten Daten.
    • <title> := Optionale Angabe eines Titels. 
Icon

Es ist möglich für Themendefinition einen Standarddialog anzugeben. Mehr Informationen hierzu an dieser Stelle.

Attachments:

DatePattern.PNG (image/png)
DecimalFormat.PNG (image/png)