Version: 26.1

Function Button

Mit dem Function Button kann ein Knopf eingefügt werden der diverse verschiedene fest eingebaute Funktionen ausführen kann. Eine einzelne Funktionen finden sie weiter unten.

Oft wird dieser Knopf benutzt um Spaltenwerte von anderen Tabellen in den aktuellen Datensatz zu kopieren.

Bitte beachten

Die Update Funktion beim Funktion Button geht nur wenn man Update Rechte auf die Tabelle hat auf die upgedated wird. Das Gleiche gilt für die Lösch Funktion.

Der Knopf ist nur im "Datensatz Anzeige Modus" verfügbar.

Hiermit können auch Workflow abgebildet werden d.h. es können mehrere Funktionen nacheinander in der angegebenen Reihenfolge ausgeführt werden.

z.B. wählen eine Feature in der Grafik und zuweisen eines Wertes dea Features zum aktuellen Datensatz.

Wählen Sie bei "Funktionsname" die gewünschte Funktion. Danach geben Sie bei "Parameter" ggf Parameter zu der Funktion ein.

Steuerelement spezifische Eigenschaften

Eigenschaft	Beschreibung
Commands	Ein Command/Funktion (siehe unten)
Kommentar	Hier können Sie eigene Kommentare hinzufügen um das Steuerelement leichter zu identifizieren wenn Sie mehrere Function Buttons verwenden.
Knopf Beschriftung	Die Beschriftung direkt auf dem Steuerelement
Knopf Bild	Ein Icon kann als Ergänzung zum Text hinzugefügt werden.

Variablen Namen

Variable Namen sind in Eckigen Klammern an zu geben. Der Name {ME} ist reserviert und symbolisiert den aktuellen Datensatz (das Feature).

Beispiel:

{ME.FID}

gibt die FID des Datensatzes zurück. Dies sind die wirklichen Werte der Datenbank. Die können auch gesetzt werden.

Die im Formular dargestellten Werte bekommen Sie durch Angabe der Feldnamen in eckigen Klammern. Diese können nur gelesen werden. Beispiel: {FID}

Beachten Sie das in den Formularen z.B. bei Kennungslistenwerte oft nicht der wirkliche Datenbankwert steht sondern ein aufgelöster Wert einer anderen Tabelle.

Beispiel: In der Datenbank hat das Feld ID_BAUM_TYPE den Wert 17. Im Formular wird aber der Klartext dargestellt also der VALUE Wert (Buche) aus der Tabelle BAUM_TYPE wo die ID= 17 ist.

d.h.
{ME.ID_BAUM_TYPE} gibt den Wert 17 zurück.
ID_BAUM_TYPE {ID_BAUM_TYPE} gibt den Wert 'Buche' zurück.

In vielen Fällen arbeitet man mit Featuren, also Objekten die wiederum Eigenschaften haben. Dann wird zuerst der Name der Feature Variable angegeben plus Punkt plus der Feldname. Beispiel {ME.ID_BAUM_TYPE}

Bei Geometrien stehen erweiterte Funktionen zum lesen zur Verfügung. X/Y - Punkt/Zentrums Koordinaten Length = Länge einer Linie/Fläche Area = Fläche

Beispiele:

{ME.GEOM.X}
{ME.GEOM.Y}
{ME.GEOM.LENGTH}
{ME.GEOM.AREA}

Koordinaten können mit dem Ausdruck "TRANSFORMTO" transformiert werden.

Der EPSG Code des Ziel Koordinatensystems wird in Klammern angegeben.

Beispiele:

{ME.GEOM.X.TRANSFORMTO(4326)}  
{ME.GEOM.Y.TRANSFORMTO(4326)}  
{ME.GEOM.TRANSFORMTO(4326)}  

Variablen die mit

{U.

beginnen sind benutzerdefinierte Variablen.

List der Funktionen

Benutzerdefinierte Variablen erzeugen (Create User Variables)

Hiermit können Benutzer Definierte Variablen angelegt werden. Diese beginnen immer mit {U. Das "U" steht für "User Defined" (Benutzer Definiert)

Variable Name	Default Value	Bemerkung
{U.NAME}	Hans Maiser	richtig
{U.NAME}	'Hans Maiser'	falsch, Text nicht in '' setzen
{U.HOEHE}	15.123	richtig
{U.HOEHE}	15,123	falsch, Dezimal Trenner muss ein Punkt sein
{U.HOEHE}	15+3	falsch, Formeln sind hier nicht erlaubt
{U.HOEHE}	NULL	falsch, NULL Ist nicht erlaubt. Dazu "Assign" benutzen.

Spezielle, reservierte Variablennamen

Variable Name	Bemerkung
{U.SPATIALFILTER}	Wird von der Funktion "Spatial Filter erzeugen" verwendet
{U.FILTER}	Enthält den aktuellen Filter des Formulars (verfügbar ab Version 25.1.29)
{U.REPORTFILE}	Wird im zusammenhang mit "Bericht erzeugen" verwendet um den Dateinamen zu speichern
{U.SHAPESUBFOLDERNAME}	Wird im zusammenhang mit "Shape Datei erzeugen" als Ordnernamen verwendet.
{U.USERNAME}	Der MapEdit-Anmeldename des aktuell angemeldeten Benutzers. (ab Version 26.1.249). Liefert einen Text. In einem SQL muss der Wert daher in einfache Anführungszeichen gesetzt werden

Werte zuweisen/berechnen (Assign Values)

Hiermit können Variablen fixe Werte oder werte anderer Variablen zugewiesen werden. Sie können hiermit auch Berechnungen durchführen und das Ergebnis einer Variablen zuweisen.

Beispiele:

Target	Source
{ME.NAME}	'Hans Maiser'
{B.NAME}	{A.FID}
{B.NAME}	{A.FID}*15
{B.NAME}	{A.NAME}\|\|'-'\|\|{A.NACHNAME}
{B.HOEHE}	15.123
{B.HOEHE}	NULL

Texte müssen immer in einfach Anführungszeichen gesetzt werden. Richtig: 'Hans Maiser'
Falsch: Hans Maiser

Bei Zahlen ist immer ein Punkt als Dezimal Trenner an zu geben, nicht Komma.
Richtig: 15.1234
Falsch: 15,1234

Bei Source können Formelausdrücke verwendet werden.
Für eine Liste der möglichen Formel Funktionen siehe: Mehr Informationen

Beachten Sie das in diese Fall anders als dort Beschrieben Variablennamen in eckige Klammern geschrieben werden müssen. Also {A.COLUMN} statt COLUMN.

Wenn der Source Wert eine reiner Spaltenname eines Features ist wie

`{A.NAME}`

dann werden die werte direkt zugewiesen, auch NULL Werte.
In allen anderen Fällen werden NULL werte in 0 oder einen leeren Text umgewandelt.

Wenn eine reine Feature Variablen mit "Leeren Featuren" (leerer Datensatz) bei einem "Assign Values" als Source (Quelle) angegeben wird dann wird die Zuweisung ignoriert. (siehe Query Feature)

Beispiele wenn {B} leer ist.

Target	Source	Ergebnis	Hinweis
{ME.LENGTH}	{B.LENGTH}	wird ignoriert	Ganze Zuweisung wird Ignoriert weil {B} leer ist.
{ME.LENGTH}	{B.LENGTH}*15	0 = 0 * 15	Anweisung wird NICHT ignoriert, {B.LENGTH} wird in 0 umgewandelt
{ME.NAME}	{B.NAME}		' Test'

Wert mittels SQL abfragen (Query Value)

Hiermit kann ein Wert mittels SQL in eine Variable geladen werden. Datenbankverbindung, SQL und Variablennamen müssen ausgefüllt werden.

Feature abfragen (Query Feature)

Hiermit kann ein Feature (Datensatz) mittels SQL Where Bedingung in eine Feature Variable geladen werden. Datenbankverbindung und Tabellennamen müssen ausgefüllt werden.

Der "Feature Variable Name" wird vom Programm festgelegt. Unter diesem Namen können die Werte des Features angesprochen werden.

Wenn die Abfrage kein Feature zurückliefert wird der ganze Vorgang abgebrochen. Wenn die Abfrage mehr als ein Feature zurückliefert wird das erste Feature verwendet.

Wenn "Create Empty Feature Variable if query has no result" aktiviert wird, wird wenn kein Feature gefunden wurde der Vorgang nicht abgebrochen und in die Feature Variable wird ein "leeres Feature" (leerer Datensatz) geladen.

Wenn eine Feature Variablen mit "Leeren Featuren" bei einem "Assign Values" als Source (Quelle) angegeben wird dann wird die Zuweisung ignoriert.

Bei "Not found Message" kann eine Fehlermeldung festgelegt werden die ausgegeben werden soll wenn kein Feature gefunden wurde. Diese wird nur angezeigt wenn "Create Empty Feature if query has no result" nicht aktiviert ist.

Feature erzeugen (Create Feature)

Erzeugt ein Feature speichert es aber nicht in der Datenbank.
Das Feature wird erst in die Datenbank gespeichert wenn "Feature speichern/Update Feature" aufgerufen wird.

Ab Version 25.1.29

Wird die Option "Digitize Geometry in Map" eingeschaltet dann wird der Anwender aufgefordert für das Feature eine Geometrie zu digitalisieren.

Bitte beachten

Das Feature hat solange es nicht gespeichert ist keine FID.

Feature löschen (Delete Feature)

Löscht ein Feature. Das feature muss vorab mit "Query Feature" geladen worden sein. Hierbei werden Feature Rules ausgeführt.

Feature löschen mit SQL (Delete Features)

Ab Version 25.1.82

Löscht ein oder mehrere Feature mittels einer SQL Where Bedingung.

Hierbei werden Feature Rules ausgeführt.
Das löschen verwendet den Tabellen Aliasnamen "f". D.h. dieser kann in der Where-Bedingung verwendet werden.

Feature speichern (Update Feature)

Updated (speichert) ein Feature in die Datenbank und aktualisiert den Datensatz. Bei "Feature Variable Name" muss der Variable Name des zu speichernden Features angegeben werden.

Nach dem Update wird der aktuelle Dialog und alle Dialoge welche die Tabelle des aktualisierten Features benutzen aktualisiert.

Bitte beachten

Die Funktion ist nur ausführbar wenn die Tabelle die aktualisiert werden soll auch Update bzw Insert Rechte hat.

Ab 25.1.103

Wenn das Feature eine "Utility Attribut" Feature ist und eine Geometry enthält,
dann wird das Attribut Feature gespeichert und es wird ein Utility Geometry Feature mit der Geometry gespeichert.
Beim Attribut Feature werden FID_ATTR/TABLE_NAME_ATTR gefüllt.

Wenn das Feature eine "Utility Attribut" Feature ist und KEINE Geometry enthält,
dann wird das Attribut Feature gespeichert und KEIN Utility Geometry Feature erzeugt.

Feature eines Views können NICHT gespeichert werden, außer es handelt sich um einen Utility View der dem System bekannt ist der vom Typ "Utility" ist. Wenn das Feature KEINE Geometry hat wird kein Geometry Feature angelegt, ansonsten wird ein Attribut und ein Geometrie Feature erzeugt und in den in der View UI definierten Tabellen abgelegt und beim Attribut Feature werden FID_ATTR/TABLE_NAME_ATTR gefüllt.

Beispiel Utility View:

Feature in Karte wählen (Select Feature in Map)

Hiermit kann ein Feature in der Karte ausgewählt werden. Datenbankverbindung und Tabellennamen müssen ausgefüllt werden.
Der "Feature Variable Name" wird vom Programm festgelegt. Unter diesem Namen können die Werte des Features angesprochen werden.

Feature in Karte anzeigen (Highlight Feature)

Hiermit kann ein Feature das vorab mit "Query Feature" geladen wurde in der Karte gehighlighted werden.

Mehrere Feature in Karte anzeigen (Highlight Features)

Hiermit können ein oder mehrere Features mittels SQL Where Bedingung in der Karte gehighlighted werden.

Datenbankverbindung und Tabellennamen müssen ausgefüllt werden.

SQL ausführen (Execute SQL)

Führt einen SQL Befehl wie DELETE, UPDATE, INSERT etc aus.

Dieser Befehl sollte nur in sehr sehr wenigen Ausnahmefällen benutzt werden da dieser keine Feature Rules auslöst.

Zum Löschen, Anlegen und Updaten von Datensätzen sollten immer die Befehle Create Feature, Delete Feature und Update Feature verwendet werden, diese führen die Feature Rules aus.

Warnung

Vermeiden Sie diesen Befehl auf alle Fälle wenn es geht da keine Feature Rules ausgelöst werden was ggf je nach Fachschale zu inkonsistenten Daten führen kann.

Meldung anzeigen (Show Message)

Hiermit können Daten in einer Meldungsbox ausgegeben werden.

Variablen können benutzt werden.

Beispiel:

FID: {ME.FID}
Name: {A.NAME}
X: {ME.GEOM.X}
Y: {ME.GEOM.Y}

Warnung

Berechnungen und Formeln sind hier nicht zulässig.

Ja/Nein Frage stellen (AskYesNoQuestion)

Hiermit kann ein Dialog angezeigt werden der eine Ja/Nein Frage stellt. Die Antwort (True/False) wird dann in einer Variable abgelegt.

Variablen können in der Textausgabe benutzt werden.

Beispiel:

Wollen Sie weiter machen?
Soll die FID `{ME.FID}` gelöscht werden?
Ist Ihr Name `{A.NAME}` und Ihr Alter `{A.ALTER}`?

Warnung

Berechnungen und Formeln sind hier nicht zulässig.

Eingabe Fenster - Werte eingeben (Input Values)

Zeigt ein Eingabe Fenster an in den Werte eingegeben werden können die Variablen zugewiesen werden.

Geben Sie bei Titel den Titel des Eingabefeldes ein. Wählen Sie bei "Variable Name" den Namen der Variable aus.

Bei "Format Type" kann angegeben werden von welchem Typ das Eingabe Feld sein soll.

Format	Beschreibung
TEXT	Text Wert
NUMBER	Zahlen Wert
CHECKBOX	Ja/Nein Feld (1=Ja, 0= Nein)
DOMAIN(TABLENAME)	Auswahlbox Werte einer Domain Tabelle
DOMAIN(CONNECTION.TABLENAME)	Auswahlbox Werte einer Domain Tabelle
COMBOBOX(A,B,C)	Auswahlbox Manuelle Werte

Generic Formular öffnen (Open Generic Form)

Öffnet ein Generic Formular Form mit einem SQL Filter

Feature in Topology Explorer anzeigen (Show Feature in Topology Explorer)

Öffnet den Topology Explorer und zeigt das bei "Feature Variable Name" angegebene Feature im Topology Explorer an.

Voreingestellt ist als "Feature Variable Name" der Name {ME}. Dies symbolisiert den aktuellen Datensatz (das Feature).

Öffne URL (Open URL)

Öffnet den Browser mit der angegebenen URL.

Bei der URL können als Parameter Spaltennamen in angegeben werden. Der Spaltenname wird dann zur Laufzeit durch den Spaltenwert des Datensatzes ersetzt.

Beispiele:

https://www.mycity.de/key={ME.FID}
https://maps.google.com/maps?q={ME.GEOM.Y.TRANSFORMTO(4326)},{ME.GEOM.X.TRANSFORMTO(4326)}

Bitte beachten

Wenn sie die URL zum öffnen von Karte wie Google Maps und andere verwenden und an die falsche Stelle (oder leicht falsche Stelle) gezoomt wird, dann wurden X und Y verwechselt oder das falsche Koordinatensystem gewählt. Bei den meisten Karten die mit Lat/Lon arbeiten wird EPSG Code 4326 oder 3857 verwendet.

Vorgehen bei Utility Features:

Bei Utility Features hat das Attribut Feature keine Geometrie. In dem Fall muss das Feature das Die Geometrie hat geholt werden und dann in der URL benutzt werden.

Zuerst das Geometrie Feature abfragen:

Tabelle "BUS_STOP_POINT" ist die Tabelle welche die Geometrie enthält.

fid_attr={ME.FID}

ME.FID ist die FID des aktuellen Datensatzes. Also die Fid des Utility Attribut Features.

Mit dem Befehl wird das Feature das die Geometrie hat in die Variable "A" geladen. Den Variablennamen sehen Sie in dem Dialog

Bei "Öffne URL" kann nun die Geometrie von "A" verwendet werden.

Also statt ME.GEOM wird A.GEOM verwendet

https://maps.google.com/maps?q={A.GEOM.Y.TRANSFORMTO(4326)},{A.GEOM.X.TRANSFORMTO(4326)}

Rechts in der Liste sehen Sie auch nochmal zu welcher Tabelle eine Variable gehört.

Email verschicken (Send EMAIL)

Hiermit können Sie ein Email senden. Wird Outlook als Option aktiviert wird die EMAIL vorab in Outlook angezeigt. Diese Option ist nur sinnvoll wenn alle Clients 'Outlook Classic' installiert haben.

Warnung

Die Option sollte nicht eingeschaltet werden wenn das 'neuen' Outlook (Januar 2025) verwendet wird. Microsoft unterstützt mit dem neuen Outlook kein versenden von Anhängen mehr.

In allen Feldern können Variablen verwendet werden.

Beispiel:

FID: {ME.FID}
Name: {A.NAME}
X: {ME.GEOM.X}
Y: {ME.GEOM.Y}

Bitte beachten

Wenn Sie Dateianhänge benutzten dürfen diese bis der Anwender die Email verschickt hat nicht gelöscht werden. Das verschicken muss immer vom Anwender in Outlook Classic ausgelöst werden. Das Programm kann diese nicht automatisiert durchführen.

Detail Zeichenbereich anzeigen/erzeugen

Zeigt einen Detail Zeichenbereich an. Wenn noch kein Detail Zeichenbereich vorhanden ist wird vorab einer erzeugt bzw der Anwender ggf aufgefordert einen anzulegen.

Objekt Gruppierung einfügen (Insert Feature Block)

Fügt Feature Blöcke ein.

Details siehe:
https://help.mapedit.de/docs/dokumentation/MapEdit-AppBuilder/database-connections/FeatureBlock#einrichten-des-formular

Netzverfolgung starten (Start Networktracing)

Startet die Netzverfolgung mit dem bei "Start Feature Variable Name" angegebenen Feature als Start Feature. Geben Sie hier "{ME}" an wenn als Start Feature der aktuelle Datensatz des Generic Formulars benutzt werden soll.

Spatial Filter erzeugen (Create Spatial Filter)

Ab Version 25.1.29

Wird die Funktion ausgeführt wird der Anwender aufgefordert einen rechteckigen Bereich in der Grafik auf zu ziehen. Aus diesem Bereich wird eine Spatial Filter Bedingung erzeugt und der Variable

{U.SPATIALFILTER}

zugewiesen.

Dieser Filter (bzw die Variable) kann dann z.B. beim erzeugen von Berichten oder Shape Export verwendet werden um die Auswahl einzuschränken oder Feature eines Bereiches zu löschen, upzudaten etc.

Es muss eine Datenbankverbindung angegeben werden da der Filter je Datenbanktyp anders aussieht und auch die SRID enthält. Der Filter verwendet fix den Tabellen Aliasnamen "f" für Spalten.

Beispiel für den Inhalt der Variable "{U.SPATIALFILTER}" eines Spatial Filter mit Postgres und SRID 26911

ST_Intersects(f.geom,ST_GeomFromText('POLYGON((650063.154816406 4000139.77038716,650063.154816406 4001006.22261833,651424.722608253 4001006.22261833,651424.722608253 4000139.77038716,650063.154816406 4000139.77038716))',26911)) 

Beispiel:

Es soll ein rechteckigen Bereich in der Grafik gewählt werden und dann mit dem Spatial Filter dieses Bereiches ein Bericht mit allen Bus Linien die in diesem Bereich liegen ausgegeben werden.

Dazu beim Bericht den Aliasnamen "f" einfügen wenn nicht bereits vorhanden.

Dann den Funktion Button erzeugen.

Funktion "Spatial Filter erzeugen" hinzufügen

Funktion "Bericht erzeugen" hinzufügen und bei Filter "{U.SPATIALFILTER}" angeben.

Zeige Demo Video

https://help.mapedit.de/docs/dokumentation/MapEdit-AppBuilder/form-designer/controls/functionbutton#spatial-filter-erzeugen-create-spatial-filter

Bericht erzeugen (Create Report)

Erzeugt einen Bericht und zeigt diesen optional an.

Wenn Sie "Bericht anzeigen" ausschalten wird der Bericht nur gespeichert aber nicht geöffnet.

Bei "Bericht speichern als Dateiname" kann optional ein Dateiname angegeben werden unter dem der Bericht gespeichert werden soll. Wird dies leer gelassen wird der Dateiname vom System erzeugt. Wird kein Pfadname angegeben wird der Temp Pfad des System genutzt. Alte Berichte im Temp Pfad werden alle 10 Tage gelöscht.

Bei Filter kann eine SQL WHERE Bedingung angegeben werden.

Wenn Sie als Filter den aktuellen Filter des Generic Formulars verwenden wollen verwenden Sie ab Version 25.1.29

{U.FILTER}

Wenn der Anwender einen rechteckigen Bereich in der Grafik wählen soll dann tragen Sie bei Filter

{U.SPATIALFILTER}

ein und führen vorab die Funktion "Spatial Filter erzeugen" aus. Die ist jedoch erst ab Version 25.1.29 möglich.

Der Dateiname (egal ob vom System erzeugt oder angegeben) wird in die Variable

{U.REPORTFILE}

geschrieben.

Wenn Sie den Bericht als nächsten Schritt als EMAIL versenden wollen, fügen Sie den Befehl "EMAIL verschicken" hinzu und geben Sie bei "Anhang Dateiname"

{U.REPORTFILE}

an.

Bei Parameter können beliebige Parameter an den Bericht übergeben werden.

Detail siehe:
https://help.mapedit.de/docs/dokumentation/MapEdit-AppBuilder/report-designer/report-link-ribbon#parameters

Shape Datei erzeugen (Create Shape File)

Ab Version 25.1.29

Erzeugt Shape Dateien.

Bei Filter kann eine SQL WHERE Bedingung angegeben werden.
Der Tabellen Alliasnamen für Spalten ist "f."

Wenn Sie als Filter den aktuellen Filter des Generic Formulars verwenden wollen verwenden Sie

{U.FILTER}

Wenn der Anwender einen rechteckigen Bereich in der Grafik wählen soll dann tragen Sie bei Filter

{U.SPATIALFILTER}

ein und führen vorab die Funktion "Spatial Filter erzeugen" aus.

Per default wird die Datei in den Ordner

C:\Users\{Ihr Username}\Documents\MapEdit\Shape\

in einem Unterordner mit dem Datum und Uhrzeit zum Zeitpunkt des Drückens des Funktion Knopfes abgelegt. Dadurch landen, wenn der Befehl mehrfach für verschiedene Tabellen ausgeführt wird, alle Dateien im gleichen Ordner.

Der Name des Unterordners kann optional geändert werden in dem die Variable

{U.SHAPESUBFOLDERNAME}

überschrieben wird.

Weitere Details zum Shape Export siehe auch:
https://help.mapedit.de/docs/dokumentation/MapEdit-AppBuilder/ribbon-definitions/ribboncommands/others/#shape-export

Programm ausführen

Mit dem Befehl Programm ausführen startet ein Function Button ein externes Programm (vergleichbar mit ShellExecute). So lässt sich aus einem Formular heraus z. B. ein Fachverfahren, ein Hilfsprogramm oder ein Dokument öffnen – bei Bedarf mit Werten aus dem aktuellen Datensatz als Übergabeparameter.

Einstellungen

Feld	Beschreibung
Programm / Datei	Pfad zur ausführbaren Datei (`.exe`, `.bat`, `.cmd`). Über die Schaltfläche Durchsuchen kann die Datei direkt ausgewählt werden. Der Pfad kann auch von Hand eingegeben werden und Platzhalter in geschweiften Klammern enthalten (siehe unten).
Argumente	Kommandozeilen-Parameter, die an das Programm übergeben werden. Über den Ausdruckseditor lassen sich Spaltenwerte und Variablen als Platzhalter einfügen, z. B. `{ME.AKTENZEICHEN}`.
Warten, bis das Programm geschlossen wurde	Ist die Option aktiviert, wartet der Function Button, bis das gestartete Programm beendet wurde, und führt erst danach den nächsten Befehl aus. Ist sie deaktiviert, wird das Programm gestartet und der Ablauf sofort fortgesetzt.

Platzhalter

Sowohl im Feld Programm / Datei als auch im Feld Argumente können Platzhalter in geschweiften Klammern verwendet werden. Sie werden vor dem Start durch die aktuellen Werte ersetzt:

{ME.SPALTENNAME} – Wert einer Spalte des aktuellen Datensatzes
{STEUERELEMENTNAME} – aktueller Anzeigewert eines Steuerelements im Formular
{U.FILTER} – der aktuell gesetzte Filter

Beispiel

Feld	Wert
Programm / Datei	`C:\Programme\Viewer\viewer.exe`
Argumente	`"{ME.DOKUMENTPFAD}"`

Hierdurch wird der Viewer mit dem im aktuellen Datensatz hinterlegten Dokumentpfad geöffnet.

Hinweis

Kann das Programm nicht gestartet werden – etwa weil der Pfad falsch ist oder die Datei fehlt –, erscheint eine Fehlermeldung. Der Ablauf des Function Buttons wird anschließend mit dem nächsten Befehl fortgesetzt.
Enthält ein Pfad oder ein Argument Leerzeichen, sollte der Wert in Anführungszeichen gesetzt werden (z. B. "{ME.DOKUMENTPFAD}").

Bitte beachten

Die Option Warten, bis das Programm geschlossen wurde funktioniert nur zuverlässig, wenn das gestartete Programm das geöffnete Fenster selbst offen hält. Manche Programme starten lediglich einen Zwischenprozess (Launcher) oder reichen den Aufruf an eine bereits laufende Instanz weiter und beenden den eigentlich gestarteten Prozess sofort. In diesem Fall kehrt MapEdit sofort zurück und setzt den Ablauf fort, obwohl das Programm sichtbar noch geöffnet ist. Verlassen Sie sich daher bei solchen Programmen nicht darauf, dass auf das tatsächliche Schließen des Fensters gewartet wird.

Wenn ~ dann ~ ansonsten (If ~ Else ~ EndIf)

Hiermit können Bedingungsblöcke gesetzt werden.

Sie können If ~ Else ~ EndIf oder If ~ EndIf verwenden.

Für eine Liste der möglichen Funktionen siehe: Mehr Informationen

Wird bei der Bedingung (Condition) nur der Name einen Feature Variable angegeben, z.B.

`{A}`

Dann liefert die Condition bei einem nicht "Leere Feature" true zurück ansonsten false.

D.h. wenn ein Datensatz vorhanden ist dann wird der Block nach dem IF ausgeführt.

Siehe "Query Feature" für die Beschreibung was "Leere Feature" sind.

Schleife - Loop (Loop Begin/Exit/End)

Hiermit können Schleifen realisiert werden. Sie benötigen immer die drei Elemente Loop Begin, Loop Exit und Loop End.

Bei Loop Exit kann eine Bedingung angegeben werden welche die Schleife verlässt.

Warnung

Vermeiden Sie Endlosschleifen! Zum Schutz wird wenn eine Schleife mehr als 100000 mal durchlaufen wird, ein Meldungsfenster angezeigt und der Benutzer gefragt ob er abbrechen will.

Funktion beenden (Quit)

Beendet die Funktion und verarbeitet ignoriert alle weiteren Befehle.

Bei Condition kann optional eine Abbruch Bedingung eingegeben werden.

Ablauf verfolgen

Im Log Fenster von MapEdit können Sie den Ablauf des Funktionsknopfes verfolgen. Hier sehen Sie auch Werte von Variablen und Berechnungen usw.

Import / Export

Mit den beiden Knöpfen Import und Export kann die Definition an andere via Datei weitergegeben werden.

Beispiel 1

Auswahl eines Feature in der Karte und zuweisen des Wertes des Feature zu einem Feld des aktuellen Datensatzes.

Fügen Sie das Commando "Select Feature in Map" hinzu. Füllen Sie Datenbank Verbindung und Tabelle Name aus. Merken Sie sich den Variablen Namen (in Normalfall "A")

Fügen Sie das Commando "Assign Values" hinzu.

Tragen Sie bei "Target Variable Name" das Ziel ein z.B. {ME.NAME} also das Feld Name des aktuellen Datensatzes und bei "Source Value" ein Feld des mit dem ersten Kommando gewählten Feldes. z.B. {A.LANG_NAME}

Fügen Sie das Commando "Update Feature" hinzu. Tragen Sie bei "Feature Variable Name" den Namen des Feature ein das gespeichert werden soll. In diesem Fall "ME" (Also der aktuelle Datensatz)

Beispiel 2

Kopieren von Spaltenwerten eines in Relation stehenden Features.

Sie haben z.B. einen Dialog auf der Tabelle BAUM. Die Tabelle Baum hat eine Spalte FID_LAGE die auf die Tabelle LAGE zeigt. In der Tabelle LAGE gibt es ein Feld ORT. Den Wert des Feldes LAGE.ORT wollen Sie nun in das Feld BAUM_ORT der Tabelle BAUM kopieren.

Fügen Sie das Commando "Query Feature" hinzu. Füllen Sie Datenbank Verbindung und wählen Sie bei Tabelle "LAGE" aus. Tragen Sie im Filter folgendes ein:

FID={ME.FID_LAGE}

Merken Sie sich den Variablen der Automatisch vergeben wird (in Normalfall "A")

Das Programm holt dann mit dem Filter den Datensatz aus der Tabelle LAGE.
Wenn kein Datensatz gefunden wird dann bricht der ganze Vorgang ab.

Fügen Sie das Commando "Assign Values" hinzu.

Tragen Sie bei "Target Variable Name" das Feld ein in den Sie einen Wert Speichern wollen.

{ME.BAUM_ORT}

ME ist das aktuelle Feature (der aktuelle Datensatz) des Dialoges.

Bei "Source Value" tragen Sie ein

{A.ORT}

Also der Wert der Spalte ORT aus dem vorher mit "Query Feature" geholten Features.

Fügen Sie das Commando "Update Feature" hinzu. Tragen Sie bei "Feature Variable Name" den Namen des Feature ein das gespeichert werden soll. In diesem Fall "ME" (Also der aktuelle Datensatz)

Hinweis

Diese dient nur zum Beispiel, Sie sollten redundante Daten vermeiden und in so einem Fall besser ein SQL Label oder eine Kennungsliste verwenden.

Beispiel 3

Zuweisen von Werten mit Varianten.

Beispiel, die Strom Tabelle EL_FEEDER_LOW (Abgang Niederspannung) hat die Spalten

NAME_NUMBER ein Feld vom Typ Text
FID_CONDUCTOR -> Verweis auf die Tabelle EL_CONDUCTOR (Leitungsabschnitt)
FID_CIRCUIT -> Verweis auf die Tabelle EL_CIRCUIT (Stromkreis)

Die Tabelle EL_CONDUCTOR (Leitungsabschnitt) hat die Spalten

FID
NAME_NUMBER ein Feld vom Typ Text

Die Tabelle EL_CIRCUIT (Stromkreis) hat die Spalten

FID
NAME_NUMBER ein Feld vom Typ Text

Mittels Knopfdruck soll nun das Feld NAME_NUMBER der Tabelle EL_FEEDER_LOW mit dem Wert des Feldes NAME_NUMBER aus der Tabelle EL_CONDUCTOR gefüllt werden wo der Datensatz von EL_CONDUCTOR die FID aus EL_FEEDER_LOW.FID_CONDUCTOR hat.

Wenn jedoch FID_CIRCUIT gefüllt ist soll es den Wert NAME_NUMBER aus der Tabelle EL_CIRCUIT holen und nicht den Wert aus EL_CONDUCTOR nehmen.

Schritt 1)

Holen des EL_CONDUCTOR Features/Datensatzes.

Fügen Sie das Commando "Query Feature" hinzu.
Wählen Sie die Datenbank Verbindung.
Wählen Sie bei Tabelle "EL_CONDUCTOR" aus.
Tragen Sie im Filter folgendes ein:

FID={ME.FID_CONDUCTOR}

Der Feature Variable wurde der automatisch Name {A} zugewiesen.

Schritt 2)

Holen des EL_CIRCUIT Features/Datensatzes.

Fügen Sie das Commando "Query Feature" hinzu.
Wählen Sie die Datenbank Verbindung.
Wählen Sie bei Tabelle "EL_CIRCUIT" aus.
Tragen Sie im Filter folgendes ein:

FID={ME.FID_CIRCUIT}

Aktivieren Sie "Create Empty Feature if query has no result"
Dies erzwingt das wenn kein Datensatz gefunden wurde der Vorgang nicht abbricht und stattdessen eine leere Feature Variable im Speicher (nicht in der Datenbank) erzeugt wird.
Der Feature Variable wurde der automatisch Name {B} zugewiesen.

Schritt 3)

Zuweisen der Werte

Fügen Sie das Commando "Assign Values" hinzu.
Drücken Sie Rechts den "Add" Knopf
Wählen Sie bei "Target Variable Name" den Wert

{ME.NAME_NUMBER}

Wählen Sie bei "Source Variable Name" den Wert

{A.NAME_NUMBER}

Dies ist der Wert der in Schritt 1 geholt wurde.
Also der der Wert von NAME_NUMBER der Tabelle EL_CONDUCTOR.

Drücken Sie Rechts den "Add" Knopf
Wählen Sie bei "Target Variable Name" den Wert

{ME.NAME_NUMBER}

Wählen Sie bei "Source Variable Name" den Wert

{B.NAME_NUMBER}

Dies ist der Wert der in Schritt 2 geholt wurde. Also der der Wert von NAME_NUMBER der Tabelle EL_CIRCUIT

Wenn in {B} eine "Leere Feature Variable" ist weil es keinen Datensatz in EL_CIRCUIT gab dann wird diese zweite Anweisung vom Programm ignoriert.

D.h. wenn Feature in EL_CONDUCTOR und EL_CIRCUIT vorhanden sind dann wird zuerst NAME_NUMBER aus EL_CONDUCTOR geschrieben und danach der Wert mit NAME_NUMBER aus EL_CIRCUIT ueberschrieben.

Wenn Feature in EL_CONDUCTOR vorhanden ist aber keines in EL_CIRCUIT dann wird NAME_NUMBER aus EL_CONDUCTOR geschrieben und die zweite Zuweisung ignoriert weil EL_CIRCUIT leer ist.

Beachten Sie das bei "Assign Values" die Werte jeweils nur dem im Speicher befindlichen Feature zugewiesen werden aber nicht in der Datenbank gespeichert werden.

Schritt 4)

Fügen Sie das Commando "Update Feature" hinzu. Tragen Sie bei "Feature Variable Name"

{ME}

ein.

Dies Speichert nun das im Speicher befindliche Feature "ME" in die Datenbank.

Beispiel 4 - Mit IF ~ ELSE ~ ENDIF

gleich wie Beispiel 4 nur mit Verwendung einer IF Anweisung.

Folgend Sie Beispiel 3 und führen Sie nur die Schritte 1 und 2 aus.

Schritt 3)

Fügen Sie ein "IF" hinzu.
Geben Sie bei "Statement" folgendes ein

{B}

Die IF Funktion prüft ob {B} (also das Feature EL_CIRCUIT) einen Datensatz enthält (ein "nicht leeres Feature"). Sprich ob die Abfrage in Schritt 2 ein Feature zurück geliefert hat.

Wenn ja werden alle nachfolgenden Schritt bis zu einer ELSE oder ENDIF Anweisung ausgeführt.

Schritt 4)

Zuweisen des Wertes

Fügen Sie das Commando "Assign Values" hinzu.
Drücken Sie Rechts den "Add" Knopf
Wählen Sie bei "Target Variable Name" den Wert

{ME.NAME_NUMBER}

Wählen Sie bei "Source Variable Name" den Wert

{B.NAME_NUMBER}

Dies ist der Wert der in Schritt 2 geholt wurde.
Also der der Wert von NAME_NUMBER der Tabelle EL_CIRCUIT

D.h. wenn Feature EL_CIRCUIT nicht leer war wird die NAME_NUMBER aus EL_CIRCUIT zugewiesen.

Schritt 5)

Fügen Sie das Commando "Else" hinzu.

Schritt 6)

Zuweisen des Wertes

Fügen Sie das Commando "Assign Values" hinzu.
Drücken Sie Rechts den "Add" Knopf
Wählen Sie bei "Target Variable Name" den Wert

{ME.NAME_NUMBER}

Wählen Sie bei "Source Variable Name" den Wert

{A.NAME_NUMBER}

Dies ist der Wert der in Schritt 2 geholt wurde.
Also der der Wert von NAME_NUMBER der Tabelle EL_CONDUCTOR

D.h. wenn Feature EL_CIRCUIT leer war wird die NAME_NUMBER aus EL_CONDUCTOR zugewiesen.

Schritt 7)

Fügen Sie das Commando "EndIf" hinzu.

Schritt 8)

Fügen Sie das Commando "Update Feature" hinzu. Tragen Sie bei "Feature Variable Name"

{ME}

ein.

Dies Speichert nun das im Speicher befindliche Feature "ME" in die Datenbank.

Steuerelement spezifische Eigenschaften​

Variablen Namen​

List der Funktionen​

Benutzerdefinierte Variablen erzeugen (Create User Variables)​

Werte zuweisen/berechnen (Assign Values)​

Wert mittels SQL abfragen (Query Value)​

Feature abfragen (Query Feature)​

Feature erzeugen (Create Feature)​

Feature löschen (Delete Feature)​

Feature löschen mit SQL (Delete Features)​

Feature speichern (Update Feature)​

Feature in Karte wählen (Select Feature in Map)​

Feature in Karte anzeigen (Highlight Feature)​

Mehrere Feature in Karte anzeigen (Highlight Features)​

SQL ausführen (Execute SQL)​

Meldung anzeigen (Show Message)​

Ja/Nein Frage stellen (AskYesNoQuestion)​

Eingabe Fenster - Werte eingeben (Input Values)​

Generic Formular öffnen (Open Generic Form)​

Feature in Topology Explorer anzeigen (Show Feature in Topology Explorer)​

Öffne URL (Open URL)​

Email verschicken (Send EMAIL)​

Detail Zeichenbereich anzeigen/erzeugen​

Objekt Gruppierung einfügen (Insert Feature Block)​

Netzverfolgung starten (Start Networktracing)​

Spatial Filter erzeugen (Create Spatial Filter)​

Bericht erzeugen (Create Report)​

Shape Datei erzeugen (Create Shape File)​

Programm ausführen​

Wenn ~ dann ~ ansonsten (If ~ Else ~ EndIf)​

Schleife - Loop (Loop Begin/Exit/End)​

Funktion beenden (Quit)​

Ablauf verfolgen​

Import / Export​

Beispiel 1​

Beispiel 2​

Beispiel 3​

Beispiel 4 - Mit IF ~ ELSE ~ ENDIF​

Steuerelement spezifische Eigenschaften

Variablen Namen

List der Funktionen

Benutzerdefinierte Variablen erzeugen (Create User Variables)

Werte zuweisen/berechnen (Assign Values)

Wert mittels SQL abfragen (Query Value)

Feature abfragen (Query Feature)

Feature erzeugen (Create Feature)

Feature löschen (Delete Feature)

Feature löschen mit SQL (Delete Features)

Feature speichern (Update Feature)

Feature in Karte wählen (Select Feature in Map)

Feature in Karte anzeigen (Highlight Feature)

Mehrere Feature in Karte anzeigen (Highlight Features)

SQL ausführen (Execute SQL)

Meldung anzeigen (Show Message)

Ja/Nein Frage stellen (AskYesNoQuestion)

Eingabe Fenster - Werte eingeben (Input Values)

Generic Formular öffnen (Open Generic Form)

Feature in Topology Explorer anzeigen (Show Feature in Topology Explorer)

Öffne URL (Open URL)

Email verschicken (Send EMAIL)

Detail Zeichenbereich anzeigen/erzeugen

Objekt Gruppierung einfügen (Insert Feature Block)

Netzverfolgung starten (Start Networktracing)

Spatial Filter erzeugen (Create Spatial Filter)

Bericht erzeugen (Create Report)

Shape Datei erzeugen (Create Shape File)

Programm ausführen

Wenn ~ dann ~ ansonsten (If ~ Else ~ EndIf)

Schleife - Loop (Loop Begin/Exit/End)

Funktion beenden (Quit)

Ablauf verfolgen

Import / Export

Beispiel 1

Beispiel 2

Beispiel 3

Beispiel 4 - Mit IF ~ ELSE ~ ENDIF