Création d’un enregistrement

Cette fonction est utilisée pour créer un nouvel enregistrement et renvoie son GUID avec un message d’information

• Function: CreateRecord(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>, <Asynchronous Update>)
  • var ObjResult = CreateRecord(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>, <Asynchronous Update>);
  • var NewRecordGUID = ObjResult.RecordGUID;
  • var message = msgInfo;
  • Utiliser l’ID externe: si la valeur est false, vous devez envoyer le GUID des champs de recherche dans les données XML, sinon envoyer la valeur de l’ID externe. De plus, si le paramètre useExternalID n’existe pas dans les paramètres de la fonction, il sera considéré comme défini sur true.
  • Asynchronous Update : Ce paramètre est optionnel et a la valeur true par défaut. Il lance le calcul des règles de partage sur l’enregistrement de manière asynchrone. Lorsque l’appel API s’inscrit dans une série d’actions dépendantes ou lorsque nous avons besoin d’afficher tout de suite l’enregistrement mis à jour à l’utilisateur, alors il est bon de mettre la valeur false à ce paramètre. La valeur false indiquera à Cirrus Shield qu’il faut calculer les règles de partage sur l’enregistrement de manière synchrone.

Format de données XML :

“<Data>”
“<Object Name>”
“<Matching Field Name>”

Value

“</Matching Field Name>”
“<Field Name>”

Value

“</Field Name>”
“<Field Name>”

Value

“</Field Name>”
“</Object Name>”
“</Data>”

• Usage: var 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, true);
var TaskGUID  = ObjResult.RecordGUID;
var message = ObjResult.msgInfo;

• Output:
  • Réussite:
    Un indicateur de réussite est renvoyé avec value = true. Le message suivant s’affiche: “Le nouvel enregistrement est enregistré avec succès”. Le GUID de l’enregistrement créé sera retourné.
  • Échec:
    Un indicateur de réussite est renvoyé avec valeur = false. Un message d’erreur s’affiche.
    Le GUID sera égal à null.