1. Accueil
  2. Guide Développeur
  3. Librairie JavaScript
  4. Enregistrements de masse Upsert

Enregistrements de masse Upsert

Cette fonction est utilisée pour insérer des enregistrements en masse et elle renvoie un résultat de message contenant les enregistrements créés / mis à jour et les erreurs.

  • Fonction: UpsertMassRecords(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>)
    • var ObjResult = UpsertMassRecords(<Object Name>, <Matching Field>, <XML Data>, <use ExternalID>);
    • 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.

Format données XML :

<Data>
<Object Name>
<Matching Field Name>
   Value1
</Matching Field Name>
<Field Name>
   Value1
</Field Name>
<Field Name>
   Value1
</Field Name>
</Object Name>
<Object Name>
<Matching Field Name>
   Value2
</Matching Field Name>
<Field Name>
   Value2
</Field Name>
<Field Name>
   Value2
</Field Name>
</Object Name>
</Data>
  • Usage:
var xmlStr = <Data>;
xmlStr += <Contact>;
xmlStr += <Name>;
xmlStr += Elise Alice;
xmlStr += </Name>;
xmlStr += <First_Name>;
xmlStr += Elise;
xmlStr += </First_Name>;
xmlStr += <Last_Name>;
xmlStr += Alice;
xmlStr += </Last_Name>;
xmlStr += <Email>;
xmlStr += elise.alice@gmail.com;
xmlStr += </Email>;
xmlStr += <OwnerId>;
xmlStr += freddy.fares@aliston.fr;
xmlStr += </OwnerId>;
xmlStr += <IsDeleted>;
xmlStr += 0;
xmlStr += </IsDeleted>;
xmlStr += </Contact>;
xmlStr += <Contact>;
xmlStr += <Name>;
xmlStr += John Smith;
xmlStr += </Name>;
xmlStr += <First_Name>;
xmlStr += John;
xmlStr += </First_Name>;
xmlStr += <Last_Name>;
xmlStr += Smith;
xmlStr += </Last_Name>;
xmlStr += <Email>;
xmlStr += john.smith@gmail.com;
xmlStr += </Email>;
xmlStr += <OwnerId>;
xmlStr += freddy_fares@aliston.fr;
xmlStr += </OwnerId>;
xmlStr += <IsDeleted>;
xmlStr += 0;
xmlStr += </IsDeleted>;
xmlStr += </Contact>;
xmlStr += </Data>;

var ObjResult = UpsertMassRecords("Contact", "Email", xmlStrContact, true);
var message = ObjResult.msgInfo;
  • Output:

    • Le message de résultat sera affiché comme suit:
      • Enregistrements de réussite: Matching Field + “ – “ + Record GUID + “ – “ + True
      • Enregistrements échoués: Matching Field + “ – “ + Error Message + “ – “ + False
    • Exemple:
      • « john.smith@gmail.com – OwnerId: Lookup Multi-Relationships Field contains invalid value – False; elise.alice@gmail.com  – 1825492168588921251 – True; »
Cet article vous a-t-il été utile ? Oui Non

Comment pouvons-nous aider ?