Variable d'enregistrement

Une variable d'enregistrement contient une ligne de données extraites d'une base de données, d'une feuille de calcul ou d'un tableau dans des paires nom-champ. Les champs peuvent stocker des valeurs de type booléen, date/heure, nombre ou chaîne.

Utilisation d'une variable d'enregistrement

Les variables d'enregistrement sont couramment utilisées dans une action de boucle pour stocker une seule ligne de données récupérées ; vous pouvez accéder à une valeur particulière en spécifiant son nom ou numéro d'index. Le numéro d'index correspond à la position de la paire nom-champ. Le nom est configuré lorsque la variable est initialisée, ou peut être extrait des en-têtes de colonne du tableau source.

Voici un exemple de tableau :

CustomerName Ville
Dana Pittsburgh
Sam Los Angeles
Alex Boston
Dans cet exemple, un robot passe en boucle le tableau précédent et attribue chaque ligne à rCurrentRow. Pour récupérer la valeur de la première colonne de chaque ligne, utilisez le numéro d'index $rCurrentRow[0]$ ou le nom $rCurrentRow{CustomerName}$.
Remarque : Pour récupérer une valeur de date/heure à partir d'une variable d'enregistrement et l'utiliser comme chaîne, concaténez la variable d'enregistrement avec une valeur de chaîne dans le champ d'action.

Schéma

Un schéma est semblable à un modèle pour les champs d'enregistrement. Il définit l'ordre des champs et le type de données qui peuvent être saisies dans chaque champ.

Si vous sélectionnez l'option Définir le schéma lors de la création d'une nouvelle variable d'enregistrement, les conditions suivantes s'appliquent au moment de l'exécution, lorsque le robot récupère une ligne de données et la stocke dans une variable d'enregistrement :
  • Les valeurs récupérées doivent correspondre aux types de données des champs configurés.

    Par exemple, il est possible d'affecter l'ensemble de données [{"name":"Sally"},{"id":002},{"dob":03/05/1989}] à une variable d'enregistrement avec le schéma [{"name":String},{"id":Number},{"dob":Date}].

  • Les attributs de l'ensemble de données doivent suivre le même ordre et respecter la même casse.

    Par exemple, il est impossible d'affecter l'ensemble de données [{"name":"Henry"},{"id":003},{"dob":06/13/2001}] à une variable d'enregistrement avec le schéma [{"id":Number},{"name":String},{"dob":Date}] ou {"Name":String},[{"ID":Number},{"DOB":Date}].

  • Une variable d'enregistrement peut accepter un sur-ensemble des champs configurés si les champs sont dans le même ordre.

    Par exemple, il est possible d'affecter l'ensemble de données [{"name":"Alex"},{"id":004},{"dob":12/10/1995},{"pet":"yes"}] à une variable d'enregistrement avec le schéma [{"name":String},{"id":Number},{"dob":Date}].

  • Une variable d'enregistrement n'accepte pas un sous-ensemble des données.

    Par exemple, il est impossible d'affecter l'ensemble de données [{"id":005},{"dob":05/21/1975}] à une variable d'enregistrement avec le schéma [{"name":String},{"id":Number},{"dob":Date}].

Si le robot détecte une ligne de données qui ne correspond pas au schéma de la variable d'enregistrement, le robot échoue. Cela empêche le robot de transmettre des données incorrectes ou non valides dans l'action suivante.