Composant: Transform

Transforme un objet par mapping grâce à un objet transformation.

Exemples

Changer le nom des champs

Prenons cette donnée en exemple :

{ "id" : "2", 
"fields" :
  {
    "city" : "Dar es salaam",
   "contact" : "biobuutz@gmail.com"
  }
}

Si l'on souhaite que les champs city et contact soient renommés en "addressLocality" et en "email", il suffit d'appuyer à droite dans le carré bleu, sur "append" deux fois et de rentrer ceci :

{
"id" : "$.id"
"email" : "$.fields.Contact"
"addressLocality" : "$.fields.City"
}

Vous noterez que pour accéder à un champs il suffit de faire $.champs. Et pour accéder à un objet au sein de notre donnée, il suffit de mettre son nom après un signe "$" et de mettre le nom du champs recherché par la suite : $.objet.champs.

Ce qui donnera comme résultat :

{ "id" : "2", "email" : "biobuutz@gmail.com", "addressLocality" : "Dar es Salaam" }

Réorganiser la donnée

Si l'on souhaite mettre le champs adressLocality dans un objet address, il suffit d'appuyer à droite du Bouton Append et de selectionner un objet. On pourra ensuite y ajouter des champs comme on l'a fait précédemment.

{"id" : "$.id"
 "email" : "$.fields.Contact"
 "address" {
  "addressLocality" : "$.fields.City"
 }
}

donnera donc :

{ "id" : "2",
 "email" : "biobuutz@gmail.com",
  "address" :{
   "addressLocality" : "Dar es Salaam"
  }
}

Modification de la donnée

On peut également réaliser des traitements sur la donnée, comme lui demander si elle contient bien un signe '@' pour une adresse mail, mettre toutes les valeurs d'un champs en minuscule etc.. On commencera alors le traitement par = et on mettra le champs entre {}.

Reprenons cette donnée :

{
 "id" : "2",
 "fields" : {
  "city" : "Dar es Salaam",
  "contact" : "biobuutz@gmail.com"
 }
}

Si l'on souhaite que le champs "Dar es Salaam" apparaisse en minuscule, on peut faire :

{
 "id" : "$.id",
 "email" : "$.fields.Contact",
 "addressLocality" : "={$.fields.City}.toLowerCase()"
}

On obtiendra : { id : "2", fields { city : "dar es salaam", contact : "biobuutz@gmail.com" } }

• Pour mettre un champs par défaut quand la valeur du champs est vide on peut faire : email : ={$.fields.Contact} ? {$.fields.Contact} : 'Autre'
• Pour vérifier si les valeurs d'un champs contiennent un signe '@' et ne pas renvoyer la valeur si il n'y en a pas : email : ={$.fields.Contact}.includes('@') ? {$.fields.Contact} : ''
• Pour donner une valeur constante au champs on peut faire email : marshmallow@gmail.com sans mettre le signe $ !

Mise en garde ⚠️

• les chemins d'accès aux propriétés sont case sensitive

Paramètres

• Conserver les champs de la source: Permet de conserver les anciens champs de la source de données.