Enregistrement Upsert | Cirrus Shield Help

Cette fonction est utilisée pour insérer un nouvel enregistrement ou mettre à jour un enregistrement existant en fonction du champ correspondant fourni.

Il vérifiera si la valeur de champ correspondante existe dans le système, si oui, il mettra à jour l’enregistrement sinon il créera un nouvel enregistrement

Fonction: UpsertRecord (<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>, <Asynchronous Update>)
- var ObjResult = UpsertRecord(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>, <Asynchronous Update>);
- var status = ObjResult.msgSuccess;
- var message = ObjResult.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”);

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

var ObjResult = UpsertRecord("Task", "Name", xmlStr, false, true);
var TaskGUID  = ObjResult.msgSuccess;
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éé ou mis à jour sera retourné.
- Échec:
  Un indicateur de réussite est renvoyé avec valeur = false. Un message d’erreur s’affiche.
  Le GUID sera égal à null.

Comment pouvons-nous aider ?