Modul DB - Versionsgeschichte

Michaelebner: /* #sql_opentvl */

2025-07-16T09:42:36Z

#sql_opentvl

2025-07-14T09:44:15Z

#sql_openvalrows

2025-03-14T18:25:27Z

#sql_openval

2025-03-13T15:33:58Z

#sql_openval

2024-12-31T14:54:04Z

#sql_upsert2

2024-12-31T13:40:58Z

#sql_openval

2024-06-24T15:39:38Z

#sql_openval

2024-05-29T11:44:31Z

#sql_upsert2

2024-05-28T14:41:52Z

#sql_upsert2

2024-05-28T13:46:02Z

#sql_upsert2

← Nächstältere Version		Version vom 16. Juli 2025, 09:42 Uhr
Zeile 213:		Zeile 213:

	'''Beispiel'''		'''Beispiel'''
		+
		+	==#sql_openkvl==
		+
		+	Die Prozedur #sql_openkvl macht aus dem Ergebnis eine SQL-Abfrage eine Kategory-ValueListe (das kann für Lookup-Live-Nachschlagelisten verwendet werden). Die Abfrage benötigt die Spalten ckat, ckey und cvalue.
		+
		+	'''Parameter'''
		+
		+	* clr - ("clear") Wenn Y wird der Text am Anfang geleert; default Y, Funktionen werden ersetzt
		+	* cnd - ("condition") Wenn Y, wird das Statement ausgeführt; default Y, Funktionen werden ersetzt
		+	* db - ("database") Name der Datenbank, auf die sich die Abfrage bezieht
		+	* n - ("nummer") Nummer des Kategorie-Valueliste, in den die Daten geschrieben werden
		+
		+	'''Beispiel'''
		+
		+	#sql select t.tournr as ckat, s.bus_haltestelle_id as ckey, s.land \|\| ' ' \|\| s.plz \|\| ' ' \|\| s.ort \|\| ' - ' \|\| s.beschreibung as cvalue, h.position
		+	#sql from bus_touren t
		+	#sql inner join bus_tour_hs h on h.bus_touren_id = t.bus_touren_id and h.status < 7 and (h.position < 99 or t.tournr between 30000 and 40000)
		+	#sql inner join bus_haltestelle s on s.bus_haltestelle_id = h.haltestelle and s.status = 1 and s.land <> ''
		+	#sql where t.kuerzel = '$FND(s,kuerzel)' and t.datum = to_date('$FND(s,datum)', 'dd.mm.yyyy')
		+	#sql order by 1, 4
		+	#sql_openkvl n=1
		+
		+	Für die Nachschlageliste wird dann wie folgt formuliert:
		+
		+	#grd_lookuplivefill y=kat n=1 k=$PVAL(pl,tournr,lookuplive)
		+

	==#sql_opentvl==		==#sql_opentvl==

@@ Zeile 188: / Zeile 188: @@
 * cnd ("condition") - Wenn Y, wird die Prozedur ausgeführt; default Y, Funktionen werden ersetzt
 * db - ("database") Name der Datenbank, auf die sich die Abfrage bezieht
-* f_ - ("Field") Alle Felder der Datenmenge, die in lokale oder globale Variable geschrieben werden sollen, werden mit einem Prefix aufgeführt. Nach dem Gleichheitszeichen folgt die Nummer der globalen Variable ("Value") oder der Name der globalen Variable.
+* f_ - ("Field") Alle Felder der Datenmenge, die in lokale oder globale Variable geschrieben werden sollen, werden mit einem Prefix aufgeführt. Nach dem Gleichheitszeichen folgt die Nummer der globalen Variable ("Value") oder der Name der globalen Variable. Wenn ein Ausrufezeichen folgt, dann wird das Ergebnis in eine Variable geschrieben, deren Namen gleich dem Feldnamen ist.
 * k - ("key") Um Namenskonflikte zu vermeiden, beginnen Parameter im SQL-Statement entsprechend den Konventionen mit einem k. Bei allen Parametern werden Funktionen ersetzt. Siehe auch das Beispiel.
 * sep - ("separator") Trennzeichen, default ist ein Komma.
@@ Zeile 197: / Zeile 197: @@
   #sql2    from user_user
   #sql2    where status = 7
-  #sql_openvalrows2  f_login=1
+  #sql_openvalrows2  f_login=!
 ==#sql_openvallist==

@@ Zeile 158: / Zeile 158: @@
 '''Parameter'''
 * cnd ("condition") - Wenn Y, wird die Prozedur ausgeführt; default Y, Funktionen werden ersetzt
 * cnt - ("count") Ermittelt die Anzahl der Datensätze, die das SQL-Statement zurück gibt, und schreibt diese in die mit diesem Parameter bezeichneten Variablen oder Value

@@ Zeile 162: / Zeile 162: @@
 * db - ("database") Name der Datenbank, auf die sich die Abfrage bezieht
 * de - ("do empty") Wenn Y, werden die mit f_ bezeichneten Variablen und Values geleert, wenn die Abfrage kein Ergebnis bringt. Default N, Funktionen werden ersetzt.
-* f_ - ("Field") Alle Felder der Datenmenge, die in lokale oder globale Variable geschrieben werden sollen, werden mit einem Prefix aufgeführt. Nach dem Gleichheitszeichen folgt die Nummer der globalen Variable ("Value") oder der Name der globalen Variable.
+* f_ - ("Field") Alle Felder der Datenmenge, die in lokale oder globale Variable geschrieben werden sollen, werden mit einem Prefix aufgeführt. Nach dem Gleichheitszeichen folgt die Nummer der lokalen Variable ("Value") oder der Name der globalen Variable. Mit einem Ausrufezeichen ist der Name der globalen Variablen gleich dem Feldnamen.
 * k - ("key") Um Namenskonflikte zu vermeiden, beginnen Parameter im SQL-Statement entsprechend den Konventionen mit einem k. Bei allen Parametern werden Funktionen ersetzt. Siehe auch das Beispiel.
 * row - 0-relativer Index der Reihe, von der die Daten zurückgegeben werden; Default 0, Funktionen werden ersetzt; ist row größer als die Anzahl der Datenreihen, dann werden die Daten der letzten Reihe zurückgegeben

@@ Zeile 296: / Zeile 296: @@
 * nk ("name / numer key") - Name der Variable oder Nummer des Values, in welche(n) der Primärschlüssel eines neu angelegten Datensatzes geschrieben wird
 * t ("table") - Name der Tabelle, in die geschrieben wird. Funktionen werden ersetzt.
 '''Beispiel'''

← Nächstältere Version		Version vom 29. Mai 2024, 11:44 Uhr
Zeile 276:		Zeile 276:

	Die Prüfung, ob es einen Datensatz bereits gibt, erfolgt mittelt der Parameter kf1..kf9. Der Primärschlüssel des Datensatzes (egal, ob neu angelegt oder geändert oder unverändert) wird nach nk geschrieben.		Die Prüfung, ob es einen Datensatz bereits gibt, erfolgt mittelt der Parameter kf1..kf9. Der Primärschlüssel des Datensatzes (egal, ob neu angelegt oder geändert oder unverändert) wird nach nk geschrieben.
		+
		+	Hinweis: #sql_upsert2 nicht innerhalb von Transaktionen einsetzen.

	'''Parameter'''		'''Parameter'''

@@ Zeile 285: / Zeile 285: @@
 * k ("key") - Primärschlüsselspalte der Tabelle. Per default wird der Wert aus dem Tabellennamen abgeleitet. Funktionen werden ersetzt.
 * kf1, kf2... (key field) - Satz von Spalten, anhand derer geprüft wird, ob es bereits einen Datensatz gibt oder nicht
 * n ("name / number") - Name der Variable oder Nummer des Values, in welche(n) die Anzahl der geänderten Datensätze geschrieben wird
 * nk ("name / numer key") - Name der Variable oder Nummer des Values, in welche(n) der Primärschlüssel eines neu angelegten Datensatzes geschrieben wird

@@ Zeile 273: / Zeile 273: @@
 ==#sql_upsert2==
-Die Prozedur #sql_upsert2 schreibt einen Datensatz in eine Datenbanktabelle. Je nach Parameter y wird ein UPDATE- oder ein INSERT-Statement ausgeführt.
+Die Prozedur #sql_upsert2 stellt sich, dass der übergebene Datensatz anschließend in der Datenbank ist. Wenn es ihn noch nicht gibt, wird ein INSERT gemacht, wenn die Daten abweichen, wird ein UPDATE durchgeführt, andernfalls wird nichts weiter unternommen.
 '''Parameter'''
@@ Zeile 282: / Zeile 284: @@
 * hst ("history") - Wenn Y,  wird auch ein Datensatz in die History-Tabelle geschrieben. In den meisten Fällen bedeutungslos, da die History-Tabellen über einen Datenbanktrigger geschrieben werden. Default ist Y.
 * k ("key") - Primärschlüsselspalte der Tabelle. Per default wird der Wert aus dem Tabellennamen abgeleitet. Funktionen werden ersetzt.
 * n ("name / number") - Name der Variable oder Nummer des Values, in welche(n) die Anzahl der geänderten Datensätze geschrieben wird
 * t ("table") - Name der Tabelle, in die geschrieben wird. Funktionen werden ersetzt.
-'''Hinweise'''
+'''Beispiel'''
-'''Beispiel'''
+Mittels kf1 wird geprüft, ob es den ServiceCode bereits gibt. Wenn nein, wird der Datensatz neu angelegt.
-  #upsert  y=i   t=user_group   f_user_group_id=$GUID()   f_type=I   f_path="ig.$DATA(igs,login)"   f_user_user_id=$DATA(igs,user_user_id)   f_status=1
+  #code   f_extType=$XML_DATA(xml,extType)
 ==#sql_migrate==