SelCopy

SelCopy(int1, alpha2, alpha3) : int

Selektion kopieren

Details

• int1: Dateinummer
• alpha2: Quellselektion
• alpha3: Zielselektion
• Resultat: int Kopierresultat _rOk Kopieren erfolgreich _rLocked Quellselektion (alpha2) gesperrt _rNoKey Quellselektion (alpha2) nicht vorhanden _rNoRec Datei (int1) nicht vorhanden _rExists Zielselektion (alpha3) bereits vorhanden _rDeadlock Verklemmung ist aufgetreten _rFailed Zugriff auf Selektionsmenge nicht möglich (Clients < 5.8.11 erhalten _rNoRec ).
• Siehe: Verwandte Befehle , SelDelete () , Beispiel

Mit dieser Funktion kann eine bestehende Selektion kopiert werden. Dabei werden nur die Abfragen, nicht aber eventuell vorhandene Ergebnismengen kopiert.

Parameter (int1) enthält dabei die Dateinummer, in der die zu kopierende Selektion definiert ist. Die zu kopierende Selektion wird in Parameter (alpha2) angegeben, in Parameter (alpha3) wird der Name der durch Kopieren neu erstellten Selektion bestimmt.

SelCopy() ermöglicht es, in einer Mehrbenutzerumgebung mehrere Benutzer gleichzeitig identische Selektionen durchführen zu lassen. Dazu wird eine Master-Selektion erstellt, die dann für den jeweiligen Benutzer temporär unter einem anderen Namen kopiert wird. Da bei der Namensvergabe für die Zielselektion auf Eindeutigkeit geachtet werden sollte, empfiehlt es sich, den Namen für die kopierte Selektion beispielsweise aus dem Benutzernamen (siehe _UserName) und der Benutzer-ID (siehe _UserNumber) zusammenzusetzen.

Da bei SelCopy() keine Ergebnismengen mitkopiert werden, muss die neu erstellte Selektion anschließend durchgeführt werden, um eine Ergebnismenge zu erhalten. Die Ergebnismenge der neuen Selektion kann dann mit den für eine Selektionsauswertung und -verarbeitung vorgesehenen Funktionen bearbeitet werden.

info

Der Rückgabewert des Befehls muss ausgewertet werden, um ein fehlerfreies Arbeiten der Prozedur zu kontrollieren.

Beispiel:

// Name der Selektion erzeugen
tSelNew # 'TMP_SEL_' + UserInfo(_UserCurrent);

// Selektion kopieren
tErg # SelCopy(Adr.D.Adressen, 'Kunde', tSelNew);

// Selektion öffnen
tHdlSel # SelOpen();
tErg # tHdlSel->SelRead(Adr.D.Adressen, _SelLock, tSelNew);

// Selektion durchführen
tErg # tHdlSel->SelRun(_SelDisplay);

// Selektion verarbeiten
...
 
tHdlSel->SelClose();                        // Selektion schließen
tErg # SelDelete(Adr.D.Adressen, tSelNew);  // Selektion löschen