@node-red/nodes 3.1.0-beta.1 → 3.1.0-beta.2

package/core/common/20-inject.js

@@ -117,14 +117,21 @@ module.exports = function(RED) {
                         if (p.v) {
                             try {
                                 var exp = RED.util.prepareJSONataExpression(p.v, node);
-                                var val = RED.util.evaluateJSONataExpression(exp, msg);
-                                RED.util.setMessageProperty(msg, property, val, true);
-                            }
-                            catch  (err) {
+                                RED.util.evaluateJSONataExpression(exp, msg, (err, newValue) => {
+                                    if (err) {
+                                        errors.push(err.toString())
+                                    } else {
+                                        RED.util.setMessageProperty(msg,property,newValue,true);
+                                    }
+                                    evaluateProperty(doneEvaluating)
+                                });
+                            } catch (err) {
                                 errors.push(err.message);
+                                evaluateProperty(doneEvaluating)
                             }
+                        } else {
+                            evaluateProperty(doneEvaluating)
                         }
-                        evaluateProperty(doneEvaluating)
                     } else {
                         try {
                             RED.util.evaluateNodeProperty(value, valueType, node, msg, (err, newValue) => {

package/core/common/24-complete.html

@@ -18,7 +18,16 @@
         color:"#c0edc0",
         defaults: {
             name: {value:""},
-            scope: {value:[], type:"*[]"},
+            scope: {
+                value: [],
+                type: "*[]",
+                validate: function (v, opt) {
+                    if (v.length > 0) {
+                        return true;
+                    }
+                    return RED._("node-red:complete.errors.scopeUndefined");
+                }
+            },
             uncaught: {value:false}
         },
         inputs:0,

package/core/common/60-link.html

@@ -1,4 +1,3 @@
-
 <script type="text/html" data-template-name="link in">
     <div class="form-row">
         <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="common.label.name"></span></label>
@@ -272,7 +271,17 @@
         color:"#ddd",//"#87D8CF",
         defaults: {
             name: { value: "" },
-            links: { value: [], type:"link in[]" },
+            links: {
+                value: [],
+                type: "link in[]",
+                validate: function (v, opt) {
+                    if ((this.linkType === "static" && v.length > 0)
+                      || this.linkType === "dynamic") {
+                        return true;
+                    }
+                    return RED._("node-red:link.errors.linkUndefined");
+                }
+            },
             linkType: { value:"static" },
             timeout: {
                 value: "30",

package/core/common/60-link.js

@@ -164,10 +164,10 @@ module.exports = function(RED) {
                     if (returnNode && returnNode.returnLinkMessage) {
                         returnNode.returnLinkMessage(messageEvent.id, msg);
                     } else {
-                        node.warn(RED._("link.error.missingReturn"))
+                        node.warn(RED._("link.errors.missingReturn"));
                     }
                 } else {
-                    node.warn(RED._("link.error.missingReturn"))
+                    node.warn(RED._("link.errors.missingReturn"));
                 }
                 done();
             } else if (mode === "link") {
@@ -248,6 +248,14 @@ module.exports = function(RED) {
             }
         });
 
+        this.on("close", function () {
+            for (const event of Object.values(messageEvents)) {
+                if (event.ts) {
+                    clearTimeout(event.ts)
+                }
+            }
+        })
+
         this.returnLinkMessage = function(eventId, msg) {
             if (Array.isArray(msg._linkSource) && msg._linkSource.length === 0) {
                 delete msg._linkSource;

package/core/sequence/17-split.js

@@ -478,7 +478,7 @@ module.exports = function(RED) {
         var completeSend = function(partId) {
             var group = inflight[partId];
             if (group.timeout) { clearTimeout(group.timeout); }
-            if ((node.accumulate !== true) || group.msg.hasOwnProperty("complete")) { delete inflight[partId]; }
+            if (node.mode === 'auto' || node.accumulate !== true || group.msg.hasOwnProperty("complete")) { delete inflight[partId]; }
             if (group.type === 'array' && group.arrayLen > 1) {
                 var newArray = [];
                 group.payload.forEach(function(n) {

package/core/storage/10-file.js

@@ -117,7 +117,9 @@ module.exports = function(RED) {
                 }
                 if (typeof data === "boolean") { data = data.toString(); }
                 if (typeof data === "number") { data = data.toString(); }
-                if ((node.appendNewline) && (!Buffer.isBuffer(data))) { data += os.EOL; }
+                var aflg = true;
+                if (msg.hasOwnProperty("parts") && msg.parts.type === "string" && (msg.parts.count === msg.parts.index + 1)) { aflg = false; }
+                if ((node.appendNewline) && (!Buffer.isBuffer(data)) && aflg) { data += os.EOL; }
                 var buf;
                 if (node.encoding === "setbymsg") {
                     buf = encode(data, msg.encoding || "none");
@@ -314,7 +316,6 @@ module.exports = function(RED) {
             });
             filename = filename || "";
             var fullFilename = filename;
-            var filePath = "";
             if (filename && RED.settings.fileWorkingDirectory && !path.isAbsolute(filename)) {
                 fullFilename = path.resolve(path.join(RED.settings.fileWorkingDirectory,filename));
             }

package/locales/en-US/messages.json

@@ -119,7 +119,10 @@
         }
     },
     "complete": {
-        "completeNodes": "complete: __number__"
+        "completeNodes": "complete: __number__",
+        "errors": {
+            "scopeUndefined": "scope undefined"
+        }
     },
     "debug": {
         "output": "Output",
@@ -181,8 +184,9 @@
         "staticLinkCall": "Fixed target",
         "dynamicLinkCall": "Dynamic target (msg.target)",
         "dynamicLinkLabel": "Dynamic",
-        "error": {
-            "missingReturn": "Missing return node information"
+        "errors": {
+            "missingReturn": "Missing return node information",
+            "linkUndefined": "link undefined"
         }
     },
     "tls": {

package/locales/en-US/network/21-httprequest.html

@@ -73,7 +73,7 @@
     <h4>Cookie handling</h4>
     <p>The <code>cookies</code> property passed to the node must be an object of name/value pairs.
     The value can be either a string to set the value of the cookie or it can be an
-    object with a single <code>value</code> property.<p>
+    object with a single <code>value</code> property.</p>
     <p>Any cookies returned by the request are passed back under the <code>responseCookies</code> property.</p>
     <h4>Content type handling</h4>
     <p>If <code>msg.payload</code> is an Object, the node will automatically set the content type

package/locales/fr/common/20-inject.html

@@ -0,0 +1,40 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="inject">
+<p>Injecte un message dans un flux manuellement ou à intervalles réguliers. Le message payload
+  (charge utile) peut être de différents types, y compris des chaînes de caractères, des objets JavaScript ou l'heure actuelle.</p>
+<h3>Sorties</h3>
+<dl class="message-properties">
+    <dt>payload<span class="property-type">divers</span></dt>
+    <dd>La charge utile configurée du message.</dd>
+    <dt class="optional">topic <span class="property-type">chaîne de caractères</span></dt>
+    <dd>Une propriété facultative qui peut être configurée dans le noeud.</dd>
+</dl>
+<h3>Détails</h3>
+<p>Le noeud Injecter peut initier un flux avec une valeur de charge utile spécifique.
+  La charge utile par défaut est un horodatage de l'heure actuelle en millisecondes depuis le 1er janvier 1970.</p>
+<p>Le noeud prend également en charge l'injection de chaînes, de nombres, de booléens, d'objets JavaScript ou de valeurs de contexte de flux/global.</p>
+<p>Par défaut, le noeud est déclenché manuellement en cliquant sur son bouton dans l'éditeur. Il peut également être réglé sur
+  injecter à intervalles réguliers ou selon un horaire.</p>
+<p>Il peut également être configuré pour injecter une fois à chaque démarrage des flux.</p>
+<p>L'<i>Intervalle</i> maximum pouvant être spécifiée est d'environ 596 heures / 24 jours. Cependant, si vous regardez des intervalles
+  supérieur à un jour, vous devriez envisager d'utiliser un noeud de planificateur capable de faire face aux pannes de courant et aux redémarrages.</p>
+<p><b>Remarque</b> : Les options <i>"Intervalle entre les heures"</i> et <i>"à une heure précise"</i> utilisent le système cron standard.
+  Cela signifie que pour la première option, vous pouvez envoyer un message à intervalle régulier entre les heures voulues.
+  Si vous voulez envoyer un message toutes les minutes à partir de maintenant, utiliser l'option <i>"intervalle"</i>.</p>
+<p><b>Remarque</b> : Pour inclure une nouvelle ligne dans une chaîne, vous devez utiliser un noeud de fonction pour créer la charge utile.</p>
+</script>

package/locales/fr/common/21-debug.html

@@ -0,0 +1,26 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="debug">
+    <p>Affiche les propriétés des message sélectionnées dans l'onglet de la barre latérale de débogage et éventuellement le journal d'exécution. Par défaut, il affiche <code>msg.payload</code>, mais peut être configuré pour afficher n'importe quelle propriété, le message complet ou le résultat d'une expression JSONata.</p>
+    <h3>Détails</h3>
+    <p>La barre latérale de débogage fournit une vue structurée des messages qui lui sont envoyés, ce qui facilite la compréhension de leur structure.</p>
+    <p>Les objets et tableaux JavaScript peuvent être réduits et développés selon les besoins. Les objets tampon peuvent être affichés sous forme de données brutes ou sous forme de chaîne si possible.</p>
+    <p>À côté de chaque message, la barre latérale de débogage comprend des informations sur l'heure à laquelle le message a été reçu, le noeud qui l'a envoyé et le type du message.
+      Cliquer sur l'identifiant du noeud source révélera ce noeud dans l'espace de travail.</p>
+    <p>Le bouton sur le noeud peut être utilisé pour activer ou désactiver sa sortie. Il est recommandé de désactiver ou de supprimer tous les noeuds de débogage qui ne sont pas utilisés.</p>
+    <p>Le noeud peut également être configuré pour envoyer tous les messages au journal d'exécution, ou pour envoyer un court (32 caractères) au texte d'état sous le noeud de débogage.</p>
+</script>

package/locales/fr/common/24-complete.html

@@ -0,0 +1,29 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="complete">
+    <p>Envoie un message lorsqu'un noeud termine sa gestion d'un message.</p>
+    <h3>Détails</h3>
+    <p>Si un noeud indique au runtime qu'il a fini de gérer un message,
+        ce noeud peut être utilisé pour déclencher un deuxième flux.</p>
+    <p>Par exemple, cela peut être utilisé avec un noeud sans port de sortie,
+        comme le noeud d'envoi d'e-mails, pour continuer le flux.</p>
+    <p>Ce noeud doit être configuré pour gérer l'événement pour les noeuds sélectionnés dans le
+        flux. Contrairement au noeud Catch, il ne fournit pas automatiquement un mode "gérer tout"
+        qui s'applique à tous les noeuds du flux.</p>
+    <p>Tous les noeuds ne déclencheront pas cet événement - cela dépendra s'ils
+        ont été implémentés pour prendre en charge cette fonctionnalité telle qu'introduite dans Node-RED 1.0.</p>
+</script>

package/locales/fr/common/25-catch.html

@@ -0,0 +1,42 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="catch">
+    <p>Capture les erreurs générées par les noeuds sur le même onglet.</p>
+    <h3>Sorties</h3>
+    <dl class="message-properties">
+        <dt>error.message <span class="property-type">chaîne de caractères</span></dt>
+        <dd>le message d'erreur.</dd>
+        <dt>error.source.id <span class="property-type">chaîne de caractères</span></dt>
+        <dd>l'identifiant du noeud qui a lancé l'erreur.</dd>
+        <dt>error.source.type <span class="property-type">chaîne de caractères</span></dt>
+        <dd>le type du noeud qui a lancé l'erreur.</dd>
+        <dt>error.source.name <span class="property-type">chaîne de caractères</span></dt>
+        <dd>le nom, s'il est défini, du noeud qui a lancé l'erreur.</dd>
+    </dl>
+    <h3>Détails</h3>
+    <p>Si un noeud génère une erreur lors du traitement d'un message, le flux sera généralement
+      arrêté. Ce noeud peut être utilisé pour intercepter ces erreurs et les gérer avec un
+      flux dédié.</p>
+    <p>Par défaut, le noeud interceptera les erreurs générées par n'importe quel noeud sur le même onglet. Alternativement
+      il peut être ciblé sur des noeuds spécifiques ou configuré pour ne détecter que les erreurs qui
+      n'ont pas déjà été capturés par un noeud de capture "ciblé".</p>
+    <p>Lorsqu'une erreur est générée, tous les noeuds Catch correspondants recevront le message.</p>
+    <p>Si une erreur est générée dans un sous-flux, l'erreur sera gérée par n'importe quel
+      noeud Catch dans le sous-flux. S'il n'en existe pas, l'erreur sera propagée
+      jusqu'à l'onglet sur lequel se trouve l'instance de sous-flux.</p>
+   <p>Si le message a déjà une propriété <code>error</code>, il est copié dans <code>_error</code>.</p>
+</script>

package/locales/fr/common/25-status.html

@@ -0,0 +1,34 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="status">
+    <p>Signale les messages d'état des autres noeuds sur le même onglet.</p>
+    <h3>Sorties</h3>
+    <dl class="message-properties">
+        <dt>status.text <span class="property-type">chaîne de caractères</span></dt>
+        <dd>le texte d'état.</dd>
+        <dt>status.source.type <span class="property-type">chaîne de caractères</span></dt>
+        <dd>le type de noeud qui a signalé l'état.</dd>
+        <dt>status.source.id <span class="property-type">chaîne de caractères</span></dt>
+        <dd>l'identifiant du noeud qui a signalé l'état.</dd>
+        <dt>status.source.name <span class="property-type">chaîne de caractères</span></dt>
+        <dd>tle nom, s'il est défini, du noeud qui a signalé l'état.</dd>
+    </dl>
+    <h3>Détails</h3>
+   <p>Ce noeud ne produit pas de <code>payload</code>.</p>
+   <p>Par défaut, le noeud signale l'état de tous les noeuds sur le même onglet de l'espace de travail.
+    Il peut être configuré pour signaler de manière sélective l'état des noeuds individuels.</p>
+</script>

package/locales/fr/common/60-link.html

@@ -0,0 +1,66 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="link in">
+    <p>Crée des liens virtuelles entre les flux.</p>
+    <h3>Détails</h3>
+    <p>Le noeud peut être connecté à n'importe quel noeud <code>Link out</code> qui existe sur n'importe quel onglet.
+      Une fois connectés, ils se comportent comme s'ils étaient câblés ensemble.</p>
+    <p>Les fils entre les noeuds de lien ne s'affichent que lorsqu'un noeud de lien est sélectionné.
+      S'il y a des fils vers d'autres onglets, un noeud virtuel est affiché et permet si on clique dessus 
+      d'accéder à l'onglet approprié.</p>
+    <p><b>Remarque</b> : Impossible de créer des liens entrant ou sortant d'un sous-flux.</p>
+</script>
+
+<script type="text/html" data-help-name="link out">
+    <p>Créer des liens virtuels entre les flux.</p>
+    <h3>Détails</h3>
+    <p>Ce noeud peut être configuré pour envoyer des messages à tous les noeuds <code>Link in</code>
+      auxquels il est connecté, ou pour renvoyer une réponse au noeud <code>Link call</code>
+      qui a déclenché le flux.</p>
+    <p>En mode 'envoyer à tous', les fils entre les noeuds de liaison ne sont affichés que lorsque
+      le noeud est sélectionné. S'il existe des fils vers d'autres onglets, un noeud virtuel
+      s'affiche sur lequel il est possible de cliquer pour passer à l'onglet approprié.</p>
+    <p><b>Remarque</b> : Impossible de créer des liens entrant ou sortant d'un sous-flux.</p>
+</script>
+
+<script type="text/html" data-help-name="link call">
+    <p>Appelle un flux qui commence par un noeud <code>Link in</code> et transmet la réponse.</p>
+    <h3>Entrées</h3>
+    <dl class="message-properties">
+      <dt class="optional">target<span class="property-type">chaîne de caractères</span></dt>
+      <dd>Lorsque l'option <b>Type de lien</b> est définie sur 'Cible dynamique', définisser <code>msg.target</code> sur le nom du
+         noeud <code>Link in</code> que vous souhaitez appeler.</dd>
+    </dl>
+    <h3>Détails</h3>
+    <p>Ce noeud peut être connecté à un noeud <code>Link in</code> qui existe sur n'importe quel onglet.
+      Le flux connecté à ce noeud doit se terminer par un noeud <code>Link out</code> configuré
+      en mode 'retour'.</p>
+    <p>Lorsque ce noeud reçoit un message, il est transmis au noeud <code>Link in</code> connecté.
+      Il attend alors une réponse qu'il envoie ensuite.</p>
+    <p>Si aucune réponse n'est reçue dans le délai configuré, 30 secondes par défaut, le noeud
+      déclenchera une erreur qui peut être détectée à l'aide du noeud <code>Catch</code>.</p>
+    <p>Lorsque l'option <b>Type de lien</b> est définie sur 'Cible dynamique', <code>msg.target</code> peut être utilisé pour appeler un
+      noeud <code>Link in</code> par nom ou identifiant.
+    <ul>
+      <li>S'il existe un noeud <code>Link in</code> avec le même identifiant, il sera appelé</li>
+      <li>S'il existe au moins deux noeuds <code>Link in</code> portant le même nom, une erreur sera générée</li>
+      <li>Un noeud <code>Link call</code> ne peut pas appeler un noeud <code>Link in</code> à l'intérieur d'un sous-flux</li>
+    </ul>
+    </p>
+    Le flux connecté à ce noeud doit se terminer par un noeud <code>Link out</code> configuré
+     en mode 'retour'.</p>
+</script>

package/locales/fr/common/90-comment.html

@@ -0,0 +1,22 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="comment">
+    <p>Un noeud d'annotations, que vous pouvez utiliser pour ajouter des commentaires à vos flux.</p>
+    <h3>Détails</h3>
+    <p>Le panneau d'édition accepte la syntaxe Markdown. Le texte sera rendu dans
+      ce panneau latéral d'information.</p>
+</script>

package/locales/fr/common/98-unknown.html

@@ -0,0 +1,28 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="unknown">
+    <p>Ce noeud est d'un type inconnu de votre installation de Node-RED.</p>
+    <h3>Détails</h3>
+    <p><i>Si vous déployez avec le noeud dans cet état, sa configuration sera préservée, mais
+      le flux ne démarrera pas tant que le type manquant ne sera pas installé.</i></p>
+    <p>Utiliser l'option <code>Menu - Gérer la palette</code>
+      pour rechercher et installer des noeuds, ou <b>npm install &lt;module&gt;</b> pour
+      installer, tous les modules manquants et redémarrer Node-RED et réimporter les noeuds.</p>
+    <p>Il est possible que ce type de noeud soit déjà installé, mais qu'il manque une dépendance. Vérifier au démarrage de Node-RED
+      le log pour tous les messages d'erreurs associés au type de noeud manquant.</p>
+    <p>Sinon, vous devez contacter l'auteur du flux pour obtenir une copie du type de noeud manquant.</p>
+</script>

package/locales/fr/function/10-function.html

@@ -0,0 +1,64 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="function">
+    <p>Une fonction JavaScript à exécuter sur les messages reçus par le noeud.</p>
+    <p>Les messages sont transmis sous la forme d'un objet JavaScript appelé <code>msg</code>.</p>
+    <p>Par convention, il aura une propriété <code>msg.payload</code> contenant
+      le corps du message.</p>
+    <p>La fonction est censée renvoyer un objet message (ou plusieurs objets message), mais peut choisir
+      de ne rien retourner pour stopper un flux.</p>
+    <p>L'onglet <b>Au démarrage</b> contient du code qui sera exécuté à chaque démarrage du noeud.
+      L'onglet <b>À l'arrêt</b> contient le code qui sera exécuté lorsque le noeud sera arrêté.</p>
+    <p>Si le code 'Au démarrage' renvoie un objet Promise (promesse), le noeud ne commencera pas à gérer les messages
+      jusqu'à ce que la promesse soit résolue.</p>
+    <h3>Détails</h3>
+    <p>Voir la <a target="_blank" href="http://nodered.org/docs/writing-functions.html">documentation en ligne</a>
+      pour plus d'informations sur les fonctions d'écriture.</p>
+    <h4>Envoi de messages</h4>
+    <p>La fonction peut envoyer les messages qu'elle souhaite transmettre aux noeuds suivants
+      dans le flux, soit avec <code>return msg</code> soit appeler la fonction <code>node.send(messages)</code>.</p>
+    <p>Il peut renvoyer/envoyer :</p>
+    <ul>
+      <li>un seul objet de message - transmis aux noeuds connectés à la première sortie</li>
+      <li>un tableau d'objets de message - transmis aux noeuds connectés aux sorties correspondantes</li>
+    </ul>
+    <p>Remarque : Le code 'Au démarrage' est exécuté lors de l'initialisation des noeuds. Par conséquent, si <code>node.send</code> est appelé dans l'onglet Au démarrage, les noeuds suivants peuvent ne pas être en mesure de recevoir le message.</p>
+    <p>Si un élément du tableau est lui-même un tableau de messages, plusieurs
+      messages sont envoyés à la sortie correspondante.</p>
+    <p>Si null est renvoyé, seul ou en tant qu'élément du tableau, aucun
+      message n'est envoyé.</p>
+    <h4>Journalisation et gestion des erreurs</h4>
+    <p>Pour enregistrer des informations ou signaler une erreur, les fonctions suivantes sont disponibles :</p>
+      <ul>
+          <li><code>node.log("Message pour le journal")</code></li>
+          <li><code>node.warn("Attention")</code></li>
+          <li><code>node.error("Erreur")</code></li>
+      </ul>
+    </p>
+    <p>Le noeud Catch peut également être utilisé pour gérer les erreurs. Pour invoquer un noeud Catch,
+      passer <code>msg</code> comme deuxième argument à <code>node.error</code> :</p>
+    <pre>node.error("Erreur",msg);</pre>
+    <h4>Accéder aux informations sur les noeuds</h4>
+    <p>Les propriétés suivantes sont disponibles pour accéder aux informations sur le noeud:</p>
+    <ul>
+        <li><code>node.id</code> - identifiant du noeud</li>
+        <li><code>node.name</code> - nom du noeud</li>
+        <li><code>node.outputCount</code> - nombre de sorties du noeud</li>
+    </ul>
+    <h4>Utilisation des variables d'environnement</h4>
+    <p>Les variables d'environnement sont accessibles à l'aide de <code>env.get("MA_VAR__ENV")</code>.</p>
+</script>

package/locales/fr/function/10-switch.html

@@ -0,0 +1,49 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="switch">
+    <p>Achemine les messages en fonction de leurs valeurs de propriété ou de leur position dans la séquence.</p>
+    <h3>Détails</h3>
+    <p>Lorsqu'un message arrive, le noeud évaluera chacune des règles définies
+        afin de transmettre le message aux sorties correspondantes.</p>
+    <p>Facultativement, le noeud peut être configuré pour arrêter d'évaluer les règles une fois qu'il en trouve une
+        qui correspond.</p>
+    <p>Les règles peuvent être évaluées par rapport à une propriété du message reçu, une propriété du flux ou 
+        du contexte global, variable d'environnement ou résultat d'une expression JSONata.</p>
+    <h4>Règles</h4>
+    <p>Il existe quatre types de règles :</p>
+    <ol>
+        <li><b>Les règles de valeur</b> sont évaluées par rapport à la propriété configurée</li>
+            Les règles de <li><b>séquence</b> peuvent être utilisées sur les séquences de messages, telles que celles
+            généré par le noeud Diviser</li>
+        <li>Une <b>expression</b> JSONata peut être fournie qui sera évaluée
+            par rapport à l'ensemble du message et correspondra si l'expression renvoie
+            une valeur vraie.</li>
+        <li>Une règle <b>Sinon</b> peut être utilisée si aucune des règles précédentes n'ont eu de correspondances.</li>
+    </ol>
+    <h4>Remarques</h4>
+    <p>Les règles <code>est vrai/faux</code> et <code>est nul</code> effectuent des
+        comparaisons avec ces types. Ils ne convertissent pas les types reçuent avec les types des règles.</p>
+    <p>Les règles <code>est vide</code> et <code>n'est pas vide</code> peuvent être utilisées pour tester la longueur des chaînes, des tableaux et des tampons, ou le nombre de propriétés d'un objet. Aucune règle ne passera si la propriété testée a un <code>booléen</code>, <code>null</code>
+        ou valeur <code>undefined</code>.</p>
+    <h4>Gestion des séquences de messages</h4>
+    <p>Par défaut, le noeud ne modifie pas la propriété <code>msg.parts</code> des messages
+        qui font partie d'une séquence.</p>
+    <p>L'option <b>recréer des séquences de messages</b> peut être activée pour générer de nouvelles séquences de messages
+        pour chaque règle qui correspond. Dans ce mode, le noeud mettra en mémoire tampon l'intégralité de
+        séquence avant d'envoyer les nouvelles séquences. Le paramètre d'exécution <code>nodeMessageBufferMaxLength</code>
+        peut être utilisé pour limiter le nombre de noeuds de messages mis en mémoire tampon.</p>
+</script>

package/locales/fr/function/15-change.html

@@ -0,0 +1,37 @@
+<!--
+  Copyright JS Foundation and other contributors, http://js.foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<script type="text/html" data-help-name="change">
+    <p>Définit, modifie, supprime ou déplace les propriétés d'un message, d'un contexte de flux ou d'un contexte global.</p>
+    <p>Le noeud peut spécifier plusieurs règles qui seront appliquées dans l'ordre dans lequel elles sont définies.</p>
+    <h3>Détails</h3>
+    <p>Les opérations disponibles sont :</p>
+    <dl class="message-properties">
+    <dt>Définir</dt>
+    <dd>définir une propriété. La valeur peut être une variété de types différents, ou
+        peut être tiré d'un message existant ou d'une propriété de contexte.</dd>
+    <dt>Modifier</dt>
+    <dd>rechercher &amp; remplacer des parties de la propriété. Si les expressions régulières
+        sont activées, la propriété "remplacer par" peut inclure des groupes de capture, par
+        exemple <code>$1</code>. Remplacer ne changera le type que s'il y a
+        une correspondance complète.</dd>
+    <dt>Supprimer</dt>
+    <dd>supprimer une propriété.</dd>
+    <dt>Déplacer</dt>
+    <dd>déplacer ou renommer une propriété.</dd>
+    </dl>
+    <p>Le type "expression" utilise le langage de requête et d'expression <a href="http://jsonata.org/" target="_new">JSONata</a>.</p>
+</script>