4D Doc Center : CREATE SELECTION FROM ARRAY

Home

4D v14.3

CREATE SELECTION FROM ARRAY


CREATE SELECTION FROM ARRAY ( Tabellenname ; DatensatzArray {; Auswahlname} )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Tabelle zum Erstellen der Auswahl
DatensatzArray	Lange Ganzzahl, Array Boolean	Array der Datensatznummern oder Array der Booleans: Wahr = Datensatz in Auswahl Falsch = Datensatz nicht in Auswahl
Auswahlname	String	Name der zu erstellenden temporären Auswahl Ohne Angabe Befehl auf die aktuelle Auswahl anwenden

Beschreibung

Der Befehl CREATE SELECTION FROM ARRAY erstellt die temporäre Auswahl Auswahlname:

entweder aus einem Array der absoluten Datensatznummern DatensatzArray aus Tabellenname,
oder aus einem Array mit Booleans. In diesem Fall geben die Werte des Array für jeden Datensatz an, ob er in Tabellenname zu Auswahlname gehört (True) oder nicht (False).

Übergeben Sie den Parameter Auswahlname nicht oder einen leeren String, arbeitet der Befehl mit der aktuellen Auswahl, die dann aktualisiert wird.

Verwenden Sie mit diesem Befehl ein Array vom Typ Lange Ganzzahl, entsprechen die Nummern des Array den Datensatznummern in Auswahlname. Ist eine Nummer nicht korrekt (nicht erstellter Datensatz), wird der Fehler -10503 erzeugt.

Hinweis: Stellen Sie sicher, dass das Array keine Zeilen enthält, die denselben Wert haben, denn dann erhalten Sie als Ergebnis eine nicht korrekte Auswahl.

Verwenden Sie mit diesem Befehl ein Array vom Typ Boolean, gibt das N-te Element des Array an, ob der Datensatz mit der Nummer N in Auswahlname (True) ist oder nicht (False) ist. Die Anzahl der Elemente in DatensatzArray muss mit der Anzahl der Datensätze in Tabellenname übereinstimmen. Ist das Array kleiner als die Anzahl der Datensätze, können nur die im Array definierten Datensätze für die Auswahl verwendet werden.

Hinweis: Bei einem Array mit Booleans verwendet der Befehl Elemente der Nummern 0 bis N-1.

Warnung: Eine temporäre Auswahl wird im Speicher erstellt und geladen. Sorgen Sie deshalb vor Ausführen dieses Befehls für ausreichend Speicherplatz.

Fehlerverwaltung

Bei einer ungültigen Datensatznummer (Datensatz wird nicht erstellt) wird der Fehler -10503 generiert. Sie können ihn mit einer Methode abfangen, die über den Befehl ON ERR CALL aufgerufen wird.