Mettre à jour un enregistrement

Cette fonction est utilisée pour mettre à jour un enregistrement existant.

• Fonction: Update Record(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>, <Asynchronous Update>)
  • var ObjResult = UpdateRecord(<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 += <Id>;
xmlStr += objTask.Id;
xmlStr += </Id>;
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 += Meeting;
xmlStr += </Description>;
xmlStr += <Location>;
xmlStr += Beirut, Lebanon;
xmlStr += </Location>;
xmlStr += <Attendees>;
xmlStr += objTask.Attendees;
xmlStr += </Attendees>;
xmlStr += <OwnerId>;
xmlStr += objTask.OwnerId;
xmlStr += </OwnerId>;
xmlStr += </Task>;
xmlStr += </Data>;

var ObjResult = UpdateRecord("Task", "Id", xmlStr, false, true);
var status = ObjResult.msgSuccess;
var message = ObjResult.msgInfo;

• Output:
  • Success:
    A success flag is returned with value = true.
    The following message will be displayed “New record is updated successfully.”
  • Failure:
    A success flag is returned with value = false.
    An error message will be displayed..