Beschreibung:
Erzeugt einen neuen Datensatz und liefert diesen als Objekt vom Typ Record zurück.
Wichtig: Der neu angelegte Record muss nach dem Speichern nicht mit Unlock freigegeben werden (da er ja eben erst erzeugt wurde) und enthält ohne explizites Aufrufen von SetContents…-Methoden die jeweiligen Feldvorbelegungen, Auto-Nummern und andere Sonderfeldfunktionen (Erfassungsbenutzer, Erfassungsdatum, …).
Für ein mit dieser Methode erzeugtes Record Objekt dürfen lediglich die Methoden Lock, Get/SetContents... mit einem (einmaligen) abschließenden Save und einem etwaigen (einmaligen) Unlock verwendet werden. Um andere Methoden des Record Objektes verwenden zu können, muss das Record Objekt freigegeben, neu initialisiert und auf den soeben erzeugten Datensatz positioniert werden.
Die Methode prüft das Ansichtsrecht Datensatz neu anlegen. Im Fehlerfall erhält man keine visuelle Meldung, d. h. im Script muss eine visuelle Benachrichtigung erfolgen, wenn die Methode fehlschlägt.
Die Datensatz-ID steht sofort nach der Ausführung von NewRecord, auch ohne explizites Speichern, zur Verfügung und kann per GetContentsByName abgerufen werden.
Rückgabewert:
Record
Beispiel VBScript:
' Dieses Beispiel basiert auf der Kontakte-Ansicht einer combit_Large-Solution
Dim oRecord : Set oRecord = cRM.CurrentProject.ViewConfigs.ItemByName("Kontakte").CreateRecordSet.NewRecord
Call oRecord.SetContentsByName("Name", "Soleil")
Call oRecord.SetContentsByName("Firstname", "Jean")
Call oRecord.Save()
Set oRecord = Nothing
Beispiel C#-Script:
// Dieses Beispiel basiert auf der Kontakte-Ansicht einer combit_Large-Solution
Record record = cRM.CurrentProject.ViewConfigs.ItemByName("Kontakte").CreateRecordSet().NewRecord();
record.SetContentsByName("Name", "Soleil");
record.SetContentsByName("Firstname", "Jean");
record.Save();
record.Dispose();