Wiki source code of Abfragen erstellen

Last modified by Jannis Klein on 2024/10/21 14:47

version	line-number	content
1.1	1	{{aagon.floatingbox/}}
	2
9.1	3	(% class="wikigeneratedid" id="HDurchlaufdesWizardszumErstelleneinerAbfrage" %)
	4	Eine Abfrage können Sie zentral über die Abfrageverwaltung (//Client Management// > //Abfrageverwaltung//) oder über die Ribbonleiste unter dem Reiter //Abfrageaktionen //erstellen. Wenn Sie die Abfrage in einem bestimmten Ordner sortiert haben möchten, können Sie diesen zunächst auswählen und dort die neue Abfrage hinzufügen. Klicken Sie dafür auf den Button //Hinzufügen//. Es öffnet sich ein Wizard, der Sie durch die notwenigen Schritte zur Erstellung der Abfrage leitet.
1.1	5
9.1	6	(% class="wikigeneratedid" %)
	7	Es besteht außerdem die Möglichkeit, eine Abfrage ohne Zuhilfenahme des Assistenten zu erstellen. Wählen Sie hierzu den Expertenmodus. Um Clients in der Abfrage zu selektieren bzw. deren Client Details zu öffnen, muss die Client-ID zusätzlich abgefragt werden. Durch die direkte Eingabe des SQL-Codes ist es Ihnen außerdem möglich, auf die Stored Procedures der ACMP Datenbank zuzugreifen und diese auszuführen. Stored Procedures sind Anweisungen im Datenbanksystem, über die komplette Abläufe von Befehlen vom Client aufgerufen werden können.
1.1	8
9.1	9	= Abfrage mit dem Wizard erstellen =
	10
	11	== Allgemeine Eigenschaften ==
	12
1.1	13	Wählen Sie einen Zielordner aus ([[image:Auswählen Icon.png\|\|height="18" width="20"]]) und vergeben Sie einen Namen für Ihre Abfrage. Optional können Sie der Abfrage auch eine Beschreibung hinzufügen, falls Sie weitere Informationen für sich oder Ihre Kollegen hinterlegen wollen. Diese Beschreibung kann künftig dabei helfen, die richtige Abfrage zu wählen. Danach muss die Basis der Abfrage ausgewählt werden. Diese entscheidet über die zur Verfügung stehenden Abfragewerte, die für die weiteren Schritte essentiell sind. Sollten Sie also eine Clients-basierte Abfrage erstellen wollen, werden Ihnen andere Felder zur Verfügung gestellt, als bei einer Abfragebasis, die sich auf die Grundlagen //Kostenstelle// oder //Verträge// beziehen.
	14
	15	{{aagon.infobox}}
	16	Beachten Sie, dass Sie keine Felder aus fremden Kategorien wählen können, wenn diese nicht von seitens ACMPs freigegeben wurden. Sie erhalten diese Einträge auch nicht, wenn Sie sie explizit über die Suchleiste eingeben.
	17	{{/aagon.infobox}}
	18
	19	Aktivieren Sie nur die Option [[//Erweiterte Abfrage erzeugen//>>doc:.Erweiterte Abfragen erstellen.WebHome]], wenn Sie eine komplexere, durch SQL-Statements detaillierte Abfrage erstellen möchten, beispielsweise auch mit Hilfe des SQL-Assistenten.. Klicken Sie ansonsten auf //Weiter >//.
	20
	21	{{aagon.infobox}}
	22	Aufgrund der komplexen Datenbankstruktur von ACMP empfehlen wir Ihnen nur eine erweiterte Abfrage zu erstellen, wenn Sie über entsprechendes Wissen verfügen.
	23	{{/aagon.infobox}}
	24
	25	{{figure}}
6.1	26	[[image:65_Abfrageverwaltung_Abfrage erstellen Allgemein_926.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	27
	28	{{figureCaption}}
	29	Neue Abfrage erstellen (Allgemein)
	30	{{/figureCaption}}
	31	{{/figure}}
	32
9.1	33	== Felder auswählen ==
1.1	34
	35	Auf der nächsten Seite des Wizards müssen Sie die Felder auswählen, die Sie abfragen möchten. Die verfügbaren Felder sind nach Kategorien sortiert. Je nach gewählter Basis der Abfrage, werden Ihnen also nur ausgewählte und nicht alle Felder angezeigt. Ziehen Sie die gewünschten Werte per Drag-and-Drop in den rechten Dialogabschnitt und ordnen Sie diese dort an. Alternativ dazu können Sie auch das Suchfeld nutzen, wodurch alle Felder mit Ihrem Suchbegriff gefiltert ausgegeben werden. Die Felder unterscheiden sich zwischen [[SingleValue-Felder>>doc:.Filteroptionen anwenden.WebHome]] ([[image:image-20240702131956-1.png]]) und [[MultiValue-Felder>>doc:.Filteroptionen anwenden.WebHome]] ([[image:image-20240702132604-3.png]]).
	36
	37	{{figure}}
6.1	38	[[image:65_Abfrageverwaltung_Felder auswählen_926.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	39
	40	{{figureCaption}}
	41	Abfrage erstellen (Felder auswählen)
	42	{{/figureCaption}}
	43	{{/figure}}
	44
	45	Neben den einzelnen Feldern, die Sie auswählen können, haben Sie auch die Möglichkeit die Sortierung der Ergebnisse zu beeinflussen. Hierzu müssen Sie das entsprechende Kästchen neben dem Feld markieren; durch mehrfaches Klicken können Sie so mithilfe der Pfeilrichtungen entscheiden, wie das Feld sortiert wird. Setzen Sie einen Haken, sollten Sie die Daten entweder in Rohform (Raw) oder sich in Großbuchstaben ausgeben lassen wollen. Klicken Sie erneut auf //Weiter >//, um auf die nächste Seite zu gelangen.
	46
	47	{{aagon.infobox}}
	48	Je größer (und komplexer) die Abfrage ist, desto länger wird die Aufbereitung der Daten in Anspruch nehmen.
	49	{{/aagon.infobox}}
	50
9.1	51	== Filter auswählen ==
1.1	52
	53	Um sich die Ergebnisse der Abfrage noch spezifischer ausgeben zu lassen, können Sie auf der nachfolgenden Seite Filter verwenden. Mit den Operatoren und Bedingungen, die Sie hier hinterlegen können, lassen sich die Abfrageergebnisse eingrenzen. Ihnen stehen folgende Operatoren zur Verfügung:
	54
	55	(% style="width:980px" %)
	56	\|Operator\|(% style="width:895px" %)Beschreibung
	57	\|ODER\|(% style="width:895px" %)Mit dem Operator ODER können Sie Bedingungen schaffen, nach denen entweder der Wert X oder Wert Y als Feld genutzt werden soll. Beispiel: Wenn Sie beispielsweise eine Abfrage erstellen wollen, wo das Betriebssystem Windows 10 ODER Windows 11 läuft.
	58	\|UND\|(% style="width:895px" %)Das UND können Sie verwenden, wenn Sie Bedingungen schaffen möchten, in denen mehrere Werte zutreffen sollen. Beispiel: Sie möchten nur Clients aus einer bestimmten Domäne mit dem Betriebssystem Windows 10 filtern. Hier würden nur Clients innerhalb der Ergebnisliste angezeigt werden, wo beide Bedingungen (Domäne und das Betriebssystem) erfüllt sind.
	59	\|NICHT\|(% style="width:895px" %)Sollten Sie NICHT als Bedingung auswählen, schließen Sie Werte aus der Abfrage aus (z.B. können Sie alle Clients in einer Abfrage aufrufen, außer Clients mit einem bestimmten Betriebssystem). Mit dem Verneinungsoperator können einzelne Filter verneint werden.
	60
	61	Ziehen Sie das gewünschte Feld, nach dem gefiltert werden soll, in das rechte Feld und fügen Sie anschließend Ihre Kriterien in der aufkommenden Eingabemaske ein.
	62
	63	{{figure}}
6.1	64	[[image:65_Abfrageverwaltung_Filter auswählen_814.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	65
	66	{{figureCaption}}
	67	Filter für die Abfrage auswählen (Beispiel einer verknüpften UND-Bedingung)
	68	{{/figureCaption}}
	69	{{/figure}}
	70
	71	Je nach Typ lassen sich auch mehrere Werte miteinander verknüpfen, womit Sie individuelle Bedingungen schaffen können. Dank der Verknüpfung mehrerer Werte und der dadurch geschaffenen Bedingungen (z.B. Bedingung nach dem Muster X ODER (Y UND Z)), sind auch Kombinationen aus bestehenden Bedingungen möglich. Ziehen Sie hierzu eine Bedingung auf eine bereits bestehende UND-Bedingung. Beide Werte werden in eine zusammengesetzte UND-Bedingung gesetzt. Ziehen Sie anschließend einen weiteren Wert auf die UND-Option, so entsteht ein ODER-Kontext zu den bereits bestehenden Werten. Wenn die Einträge außerhalb der Bedingung gezogen werden, werden Sie einfach als zwei einzelne Filter registriert. Sollten Sie Einträge editieren wollen, können Sie per Doppelklick geöffnet und per Entf-Taste gelöscht werden. Im nachfolgenden Beispiel sehen Sie, wie so ein Filter aussieht. Hierbei wird nach dem Computernamen und einer primären IP-Adresse gefiltert.
	72
	73	{{aagon.infobox}}
	74	Es muss sich bei den Werten für die Filter nicht um die bereits ausgewählten Werte handeln. Sie können also beispielsweise sich nur den Computernamen anzeigen lassen, auch wenn Sie nach den IP-Adressen Ihrer Clients filtern.
	75	{{/aagon.infobox}}
	76
9.1	77	Nachdem Sie die Filter ausgewählt haben, klicken Sie auf //Weiter >//, um fortzufahren.
1.1	78
9.1	79	== Gruppierung von Tabellen ==
	80
	81	Je nach gewählten Abfragefeldern, kann ein weiterer Schritt im Wizard erfolgen. Sollten Sie ein Abfragefeld vom Typ MultiValue ([[image:image-20240702132604-3.png]] ) ausgewählt haben, ist eine 1:n-Beziehung möglich. Dies bedeutet, dass die Ausrichtung das Ergebnis beeinflussen kann. Das ist dann der Fall, wenn Sie ein oder mehrere Felder ausgewählt haben, die einem Client mehrere Ergebnisse zuordnen können, z.B. die Anzahl der Drucker. Die Logik dahinter lautet, dass ein Drucker von mehreren Clients ausgewählt werden kann. Im Arbeitsalltag steht oft nur einer für eine komplette Etage zur Verfügung, weshalb sich mehrere Mitarbeiter diesen teilen müssen. Wird das Ergebnis also beispielsweise nach Clients ausgerichtet, so werden die Clients aufgelistet und die Mehrfachergebnisse in einem Unterformular dargestellt. Wenn Sie den Drucker als Ausrichtung auswählen, werden alle Drucker aufgelistet und die Clients in einem Unterformular gelistet.
	82
1.1	83	Wählen Sie den Tabelleneintrag aus, nach dem Ihre Abfrage sortiert werden soll und klicken Sie auf //Weiter >//.
	84
	85	{{figure}}
6.1	86	[[image:65_Abfrageverwaltung_Angeordnet nach_666.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	87
	88	{{figureCaption}}
	89	Anordnung der Abfrage
	90	{{/figureCaption}}
	91	{{/figure}}
	92
9.1	93	== Sicherheit und Berechtigungen ==
	94
1.1	95	Die nächste Seite im Wizard ermöglicht es Ihnen Sicherheitseinstellungen vorzunehmen. Geben Sie an, welcher Benutzer bzw. welche Gruppe bestimmte Rechte an dieser Abfrage hat.
	96	Um einer Gruppe oder einem Benutzer ein Recht an der Abfrage zu vergeben, müssen Sie diese zunächst zur Auswahl hinzufügen, indem Sie die entsprechende Checkbox aktivieren. Per Standard sind sowohl für die Gruppen als auch Benutzer alle Rechte gewährt.
	97
	98	(% style="width:1337px" %)
	99	\|Sicherheitsoption\|(% style="width:1184px" %)Beschreibung
	100	\|Bearbeiten\|(% style="width:1184px" %)Der Benutzer oder die Gruppe hat das Recht, die Abfrage zu bearbeiten. Hierzu zählen auch die Ausführung und die Sichtbarkeit der Abfrage.
	101	\|Ausführen\|(% style="width:1184px" %)Das Recht //Ausführen //beinhaltet auch das Einsehen der Abfrageergebnisse, sowie die Ausführung der Abfrage. Ist die Ansicht deaktiviert, so ist die Abfrage für den Benutzer oder die Gruppe nicht sichtbar. Die aktivierte Option beinhaltet automatisch auch immer die Sichtbarkeit.
	102	\|Sichtbar\|(% style="width:1184px" %)Ein Benutzer oder eine Gruppe, die lediglich die Abfrage sehen darf, kann sie weder bearbeiten noch ausführen.
	103
	104	Sie können weitere Benutzer oder Gruppen über den //Hinzufügen //Button ergänzen, ebenso wie Sie über //Entfernen //hinterlegte löschen können. Markieren Sie dafür den Eintrag und bestätigen Sie die Sicherheitsabfrage.
6.1	105	Die hier hinterlegten Benutzer und Gruppen können Sie in der [[Benutzerverwaltung>>doc:ACMP.67.ACMP-Solutions.System.Benutzerverwaltung.WebHome]] abrufen.
1.1	106
	107	Als mögliche Rechteoptionen stehen Ihnen das Erlauben, Verbieten und Neutral zur Verfügung:
	108
	109	* Ein Verbot nimmt hierbei die höchste Priorität ein. Beispiel: Sollten Sie einer Gruppe das Ausführen einer Abfrage verbieten, es aber zeitgleich einem expliziten Nutzer dieser Gruppe erlauben, so kann dieser Benutzer die Abfrage trotzdem nicht ausführen. Das liegt an der Rechtepriorität der Gruppe, die auch im Einzelfall eine höhere Gewichtung hat, als ein einzelner Benutzer.
	110
	111	* Ein neutrales Recht orientiert sich immer an anderen vergebenen Rechten. Beispiel: Wird einem Benutzer durch eine Gruppe etwas erlaubt und Sie räumen ihm ein neutrales Recht ein, hat er dieses Recht durch die Gruppe erhalten.
	112
	113	{{figure}}
6.1	114	[[image:65_Abfrageverwaltung_Sicherheit_736.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	115
	116	{{figureCaption}}
	117	Rechte der Benutzer und Gruppen verwalten
	118	{{/figureCaption}}
	119	{{/figure}}
	120
9.1	121	Fahren Sie mit Ihren Arbeiten fort, klicken Sie auf //Weiter >//, um in den letzten Schritt zur Erstellung einer Abfrage zu gelangen.
1.1	122
11.1	123	== Abfrage-Icon ==
9.1	124
	125	Unter //Abfrage-Icon //können Sie für Ihre Abfrage ein passendes Icon vergeben. Verwenden Sie eines der mitgelieferten oder laden Sie ein eigenes hoch. Beachten Sie, dass die Icons im .bmp- oder ico-Format vorliegen müssen und nicht die Größe von 16x16 Pixel überschreiten dürfen, da ansonsten nur ein Teilstück der Ursprungsdatei genutzt werden kann. Möchten Sie wieder ein Standard Icon auswählen, klicken Sie auf [[image:image-20240702132944-4.png]] .
	126
1.1	127	{{figure}}
6.1	128	[[image:65_Abfrageverwaltung_Abfrage-Icon_666.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	129
	130	{{figureCaption}}
	131	Abfrage-Icon zuweisen
	132	{{/figureCaption}}
	133	{{/figure}}
	134
9.1	135	Beenden Sie den Wizard und erstellen Sie die Abfrage, indem Sie auf //Fertig //klicken. Die Abfrage steht Ihnen nun in der Abfrageverwaltung zur Verfügung.
1.1	136
	137	{{aagon.infobox}}
	138	Wenn Sie mit der neu erstellten Abfrage inventarisierte Geräte als Asset importieren wollen, können Sie mit dem Export fortfahren.
	139	{{/aagon.infobox}}