YOrm Erläuterungen zu Collection-, Query- und Dataset-Methoden #1459

alxndr-w · 2023-11-26T14:50:29Z

No description provided.

alxndr-w · 2023-11-26T14:52:33Z

@gharlan Copilot hat mir noch einige mehr Methoden vorgeschlagen, die ich allerdings nicht auf ihr Vorhandensein oder auf Halluzinationen überprüft habe. Bitte gerne nochmal auf sachliche Richtigkeit überprüfen. Ich habe jeden Satz inhaltlich mit meinem Wissen überprüft, erkannte Fehler korrigiert - mir sind keine weiteren Fehler aufgefallen.

gharlan · 2023-12-05T09:40:46Z

docs/04_yorm.md

+- `getIds()`: Gibt die IDs aller Datensätze in der Sammlung zurück.
+- `getTable()`: Gibt die Tabelle zurück, zu der die Sammlung gehört.
+- `getTableName()`: Gibt den Namen der Tabelle zurück, zu der die Sammlung gehört.
+- `getUniqueValue()`: Gibt einen eindeutigen Wert für die Sammlung zurück.


Der Satz klingt für mich, als würde die Methode eine Art Hash für die gesamte Sammlung liefern.
Tatsächlich übergibt man aber einen Feldnamen an die Methode, und die Methode prüft dann, ob der Wert in dem Feld bei allen Elementen der Sammlung gleich ist. Wenn ja, wird der Wert geliefert, ansonsten null.

Selbst benötigt man die Methode eher nicht. Sie wird genutzt, wenn man mehrere Datensätze gleichzeitig bearbeitet. Für die Entscheidung, ob in dem jeweiligen Formularfeld ein Wert initial gesetzt wird (weil für alle Datensätze gleich) oder ob das Feld leer gelassen wird (weil unterschiedliche Werte).

Weiß nicht, wie man es in einem Satz besser beschreiben kann.

gharlan · 2023-12-05T09:42:57Z

docs/04_yorm.md

+- `implode()`: Fügt die Werte aller Datensätze in der Sammlung zu einem String zusammen.
+- `isEmpty()`: Überprüft, ob die Sammlung leer ist.
+- `isValid()`: Überprüft, ob alle Datensätze in der Sammlung gültig sind.
+- `isValueUnique()`: Überprüft, ob ein bestimmter Wert in der Sammlung eindeutig ist.


Die Methode gehört mit zu getUniqueValue (siehe oben, wird intern in getUniqueValue genutzt für den Check). Die Beschreibung hier passt aber denke ich so.

gharlan · 2023-12-05T09:43:48Z

docs/04_yorm.md

+- `getTable()`: Gibt die Tabelle zurück, zu der die Sammlung gehört.
+- `getTableName()`: Gibt den Namen der Tabelle zurück, zu der die Sammlung gehört.
+- `getUniqueValue()`: Gibt einen eindeutigen Wert für die Sammlung zurück.
+- `getValues()`: Gibt die Werte aller Datensätze in der Sammlung zurück.


Zu einem bestimmten Key. Also die Werte eine Spalte.

gharlan · 2023-12-05T09:47:23Z

docs/04_yorm.md

+- `map()`: Wendet eine Funktion auf alle Datensätze in der Sammlung an.
+- `populateRelation()`: Füllt ein Relationsfeld für alle Datensätze in der Sammlung.
+- `save()`: Speichert alle Datensätze in der Sammlung.
+- `setData()`: Lädt Daten in alle Datensätze in der Sammlung.


Das passt nicht, glaube ich. Man tauscht damit eher die Datensätze in der Sammlung aus. Man hat danach also eine Collection mit den an setData übergebenen Datensätzen. Die vorherigen Datensätze bleiben unberührt, sind nur nicht mehr in dem Collection-Objekt.
(Ist mehr eine interne Methode)

gharlan · 2023-12-05T09:49:04Z

docs/04_yorm.md

+- `shuffle()`: Mischelt die Datensätze in der Sammlung.
+- `slice()`: Gibt einen Teil der Datensätze in der Sammlung zurück.
+- `sort()`: Sortiert die Datensätze in der Sammlung.
+- `split()`: Teilt die Sammlung in zwei Teile


Nicht in zwei Teile, sondern in die gewünschte Anzahl. split(5) würde also 5 Teile liefern.

gharlan · 2023-12-05T10:08:49Z

docs/04_yorm.md

+  - `query()`: Führt die Abfrage aus und gibt ein `rex_yform_manager_query` Objekt zurück.
+  - `queryOne()`: Führt die Abfrage aus und gibt ein `rex_yform_manager_query` Objekt für den ersten Datensatz zurück.
+- Save (Entspricht `INSERT` oder `UPDATE` in SQL.)
+  - `save()`: Speichert die Daten, die der Abfrage hinzugefügt wurden.


Gibt es in der Query-Klasse nicht.

Suggested change

- `save()`: Speichert die Daten, die der Abfrage hinzugefügt wurden.

gharlan · 2023-12-05T10:10:00Z

docs/04_yorm.md

+  - `getTableName()`: Gibt den Namen der Tabelle zurück, auf die sich die Abfrage bezieht.
+- Where (Entspricht `WHERE` in SQL.)
+  - `resetWhere()`: Setzt die WHERE-Bedingung der Abfrage zurück.
+  - `setWhereOperator()`: Setzt den Operator für die WHERE-Bedingung der Abfrage.


Also wie die where-Bedingungen verknüpft werden (AND oder OR).

Suggested change

- `setWhereOperator()`: Setzt den Operator für die WHERE-Bedingung der Abfrage.

- `setWhereOperator()`: Setzt den Operator für die WHERE-Bedingung der Abfrage. (AND oder OR)

docs/04_yorm.md

gharlan · 2023-12-05T10:13:09Z

docs/04_yorm.md

+
+- `create($table, array $data = [])`: Erstellt einen neuen Datensatz in der angegebenen Tabelle und gibt ein `rex_yform_manager_dataset` Objekt für diesen Datensatz zurück.
+- `get($table, $id)`: Gibt ein `rex_yform_manager_dataset` Objekt für den Datensatz mit der angegebenen ID in der angegebenen Tabelle zurück.
+- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Array von `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.


Nicht als Array, sondern als Collection-Objekt.
Where und Sortierung können nicht angegeben werden.

Suggested change

- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Array von `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.

- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Collection an `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.

Bleiben noch die falschen Params..

Suggested change

- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Array von `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.

- `getAll($table)`: Gibt alle Datensätze in der angegebenen Tabelle als Collection an `rex_yform_manager_dataset` Objekten zurück.

gharlan · 2023-12-05T10:15:45Z

docs/04_yorm.md

+- `getForm()`: Gibt ein YForm-Formular für den aktuellen Datensatz zurück. (EXPERIMENTELL)
+- `getId()`: Gibt die ID des aktuellen Datensatzes zurück.
+- `getMessages()`: Gibt eine Liste der Fehlermeldungen zurück, die beim letzten Speichern des aktuellen Datensatzes aufgetreten sind.
+- `getRaw()`: Gibt die Rohdaten des aktuellen Datensatzes als assoziatives Array zurück.


Das passt nicht. Die Methode ist ähnlich wie get($id), liefert also ein Dataset-Objekt.
Aber anders als get() ruft getRaw den Datensatz noch gar nicht ab, und prüft auch nicht, ob die ID überhaupt existiert.
Wird mehr für interne Zwecke benötigt.

Bzw. man kann es auch nutzen, um einem neuen Datensatz eine fixe ID zu vergeben. Also ::getRaw($id) statt ::create().

Da weiß ich nicht, wie ich das formulieren sollte. Du kannst auch diesen PR einen eigenen Vorschlag

über diesen Button hinzufügen und Reviewen.

Co-authored-by: Gregor Harlan <[email protected]>

YOrm Erläuterungen zu Methoden

5b017fc

gharlan reviewed Dec 5, 2023

View reviewed changes

Update docs/04_yorm.md

c2ea1f1

Co-authored-by: Gregor Harlan <[email protected]>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

YOrm Erläuterungen zu Collection-, Query- und Dataset-Methoden #1459

YOrm Erläuterungen zu Collection-, Query- und Dataset-Methoden #1459

alxndr-w commented Nov 26, 2023

alxndr-w commented Nov 26, 2023

gharlan Dec 5, 2023

gharlan Dec 5, 2023

gharlan Dec 5, 2023

gharlan Dec 5, 2023 •

edited

Loading

gharlan Dec 5, 2023

gharlan Dec 5, 2023

alxndr-w Aug 19, 2024

gharlan Dec 5, 2023

alxndr-w Aug 19, 2024

gharlan Dec 5, 2023

alxndr-w Aug 19, 2024

gharlan Aug 19, 2024

gharlan Dec 5, 2023

gharlan Jan 10, 2024

alxndr-w Aug 19, 2024

	- `setWhereOperator()`: Setzt den Operator für die WHERE-Bedingung der Abfrage.
	- `setWhereOperator()`: Setzt den Operator für die WHERE-Bedingung der Abfrage. (AND oder OR)

	- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Array von `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.
	- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Collection an `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.

	- `getAll($table, $where = null, array $orderBy = [])`: Gibt alle Datensätze in der angegebenen Tabelle als Array von `rex_yform_manager_dataset` Objekten zurück. Optional kann eine WHERE-Bedingung und eine Sortierreihenfolge angegeben werden.
	- `getAll($table)`: Gibt alle Datensätze in der angegebenen Tabelle als Collection an `rex_yform_manager_dataset` Objekten zurück.

YOrm Erläuterungen zu Collection-, Query- und Dataset-Methoden #1459

Are you sure you want to change the base?

YOrm Erläuterungen zu Collection-, Query- und Dataset-Methoden #1459

Conversation

alxndr-w commented Nov 26, 2023

alxndr-w commented Nov 26, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

gharlan Dec 5, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

gharlan Dec 5, 2023 •

edited

Loading