Create Record

This function is used to create a new record and it returns the GUID of the newly created one and a message info.

  • Function: CreateRecord(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>)
    • var ObjResult = CreateRecord(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>);
    • var NewRecordGUID = ObjResult.RecordGUID;
    • var message = msgInfo;
    • Use External Id: if the value is false, then you must send the GUID of the lookup fields in the XML data otherwise send the external Id value. Also if the parameter useExternalID is not existing in the function parameters, then it will considered as it is set to true.

XML Data Format:

"<Data>"
"<Object Name>"
"<Matching Field Name>"

Value

"</Matching Field Name>"
"<Field Name>"

Value

"</Field Name>"
"<Field Name>"

Value

"</Field Name>"
"</Object Name>"
"</Data>"

  • Usagevar objTask = GetDataByID(GetRecordGUID(),"Task", "Id,Name,Start,End,Description,Location,Attendees,OwnerId,IsDeleted");

var offset = GetTimeZone();
var xmlStr = "<Data>";
xmlStr += "<Task>";
xmlStr += "<Name>";
xmlStr += "Client Meeting";
xmlStr += "</Name>";
xmlStr += "<Start>";
xmlStr += objTask.Start + offset;
xmlStr += "</Start>";
xmlStr += "<End>";
xmlStr += objTask.End + offset;
xmlStr += "</End>";
xmlStr += "<Description>";
xmlStr += objTask.Description;
xmlStr += "</Description>";
xmlStr += "<Location>";
xmlStr += objTask.Location;
xmlStr += "</Location>";
xmlStr += "<Attendees>";
xmlStr += objTask.Attendees;
xmlStr += "</Attendees>";
xmlStr += "<OwnerId>";
xmlStr += objTask.OwnerId;
xmlStr += "</OwnerId>";
xmlStr += "<IsDeleted>";
xmlStr += 0;
xmlStr += "</IsDeleted>";
xmlStr += "</Task>";
xmlStr += "</Data>";

var ObjResult = CreateRecord("Task", "Id", xmlStr, false);
var TaskGUID  = ObjResult.RecordGUID;
var message = ObjResult.msgInfo;

  • Output:
    • Success:
      The following message will be displayed “New record is created successfully.”
      It will return the GUID of the newly created record.
    • Failure:
      An error message will be displayed.
      The GUID will be null.
Was this article helpful to you? Yes No

How can we help?