Merge pull request #3964 from GogoVega/french-translation-of-nodes

Add French translation of nodes
This commit is contained in:
Nick O'Leary 2023-03-03 15:18:20 +00:00 committed by GitHub
commit f54f500e2b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
36 changed files with 3016 additions and 0 deletions

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -0,0 +1,44 @@
<!--
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="range">
<p>Associe une valeur numérique à une plage différente.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">nombre</span></dt>
<dd>La charge utile <i>doit</i> être un nombre. Tout le reste essaiera d'être
analysé en un nombre et rejeté si cela échoue.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">nombre</span></dt>
<dd>La valeur mappée à la nouvelle plage.</dd>
</dl>
<h3>Détails</h3>
<p>Ce noeud mettra à l'échelle linéairement la valeur reçue. Par défaut, le résultat
n'est pas contraint à la plage définie dans le noeud.</p>
<p><i>L'échelle et la limite à la plage cible</i> signifient que le résultat ne sera jamais en dehors
de la plage spécifiée dans la plage cible.</p>
<p><i>Mettre à l'échelle et envelopper dans la plage cible</i> signifie que le résultat sera
être enveloppé dans la plage cible.</p>
<p>Par exemple, une entrée 0 - 10 mappée sur 0 - 100.</p>
<table style="outline-width:#888 solid thin">
<tr><th width="80px">mode</th><th width="80px">entrée</th><th width="80px">sortie</th></tr>
<tr><td><center>échelle</center></td><td><center>12</center></td><td><center>120</center></td></tr>
<tr><td><center>limite</center></td><td><center>12</center></td><td><center>100</center></td></tr>
<tr><td><center>enveloppe</center></td><td><center>12</center></td><td><center>20</center></td></tr>
</table>
</script>

View File

@ -0,0 +1,58 @@
<!--
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="template">
<p>Définit une propriété basée sur le modèle fourni.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>msg <span class="property-type">objet</span></dt>
<dd>Un objet msg contenant des informations pour remplir le modèle.</dd>
<dt class="optional">template <span class="property-type">chaîne de caractères</span></dt>
<dd>Un modèle à remplir à partir du message <code>msg.payload</code>. S'il n'est pas configuré dans le panneau d'édition,
cela peut être défini comme une propriété de msg.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>msg <span class="property-type">objet</span></dt>
<dd>un msg avec une propriété définie en remplissant le modèle configuré avec les propriétés du msg entrant.</dd>
</dl>
<h3>Détails</h3>
<p>Par défaut, cela utilise le format <i><a href="http://mustache.github.io/mustache.5.html" target="_blank">mustache</a></i>,
mais cela peut être désactivé si nécessaire.</p>
<p>Par exemple, lorsqu'un modèle de :
<pre>Bonjour {{payload.name}}. Aujourd'hui nous sommes le {{date}}</pre>
<p>reçoit un message contenant :
<pre>{
date: "Lundi",
payload: {
name: "Kevin"
}
}</pre>
<p>La propriété résultante sera :
<pre>Bonjour Kevin. Aujourd'hui nous sommes le lundi</pre>
<p>Il est possible d'utiliser une propriété du contexte de flux ou du contexte global. Utiliser simplement <code>{{flow.name}}</code> ou
<code>{{global.name}}</code>, ou pour le stockage persistant <code>store</code>, utiliser <code>{{flow[store].name}}</code> ou
<code>{{global[store].name}}</code>.
<p><b>Remarque : </b>Par défaut, <i>moustache</i> échappera toutes les entités non alphanumériques ou HTML dans les valeurs qu'il remplace.
Pour éviter cela, utiliser des accolades <code>{{{triple}}}</code>.</p>
<p>Si vous devez utiliser <code>{{ }}</code> dans votre contenu, vous pouvez modifier les caractères
utilisé pour marquer les sections de modèle. Par exemple, pour utiliser <code>[[ ]]</code>
à la place, ajouter la ligne suivante en haut du modèle :</p>
<pre>{{=[[ ]]=}}</pre>
<h4>Utilisation des variables d'environnement</h4>
<p>Le noeud de modèle peut accéder aux variables d'environnement en utilisant la syntaxe :</p>
<pre>Ma couleur préférée est {{env.COLOUR}}.</pre>
</script>

View File

@ -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="delay">
<p>Retarde chaque message traversant le noeud ou limite la vitesse à laquelle ils peuvent passer.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">delay <span class="property-type">nombre</span></dt>
<dd>Définit le délai, en millisecondes, à appliquer au message. Cette
option ne s'applique que si le noeud est configuré pour autoriser le message à
remplacer l'intervalle de délai configuré par défaut.</dd>
<dt class="optional">rate <span class="property-type">nombre</span></dt>
<dd>Définit la valeur du débit en millisecondes entre les messages.
Ce noeud écrase la valeur de taux (rate) existante définie dans la configuration du noeud
lorsqu'il reçoit le message contenant la valeur <code>msg.rate</code> en millisecondes.
Cette option ne s'applique que si le noeud est configuré pour autoriser le message à
remplacer l'intervalle de taux par défaut configurée.</dd>
<dt class="optional">reset</dt>
<dd>Si le message reçu a cette propriété définie sur n'importe quelle valeur, tous
les messages en suspens détenus par le noeud sont effacés sans être envoyés.</dd>
<dt class="optional">flush</dt>
<dd>Si le message reçu a cette propriété définie sur une valeur numérique, alors autant de messages
sera libéré immédiatement. Si défini sur un autre type (par exemple booléen), alors tous
les messages en attente détenus par le noeud sont envoyés immédiatement.</dd>
<dt class="optional">toFront</dt>
<dd>En mode limite de débit, si le message reçu a cette propriété définie sur booléen <code>true</code>,
alors le message est poussé au début de la file d'attente et sera publié ensuite.
Ceci peut être utilisé en combinaison avec <code>msg.flush=1</code> pour envoyer immédiatement.
</dd>
</dl>
<h3>Détails</h3>
<p>Lorsqu'il est configuré pour retarder les messages, l'intervalle de retard peut être une valeur fixe,
une valeur aléatoire dans une plage ou définie dynamiquement pour chaque message.
Chaque message est retardé indépendamment de tout autre message, en fonction de
l'heure de son arrivée.
</p>
<p>Lorsqu'ils sont configurés pour limiter le débit des messages, leur diffusion est répartie sur
la période configurée. L'état indique le nombre de messages actuellement dans la file d'attente.
Il peut éventuellement supprimer les messages intermédiaires à mesure qu'ils arrivent.</p>
</p>
<p>S'il est défini pour autoriser le remplacement du taux, le nouveau taux sera appliqué immédiatement,
et restera en vigueur jusqu'à ce qu'il soit modifié à nouveau, que le noeud soit réinitialisé ou que le flux soit redémarré.</p>
<p>La limitation de débit peut être appliquée à tous les messages, ou les regrouper selon
leur sujet <code>msg.topic</code>. Lors du regroupement, les messages intermédiaires sont
automatiquement abandonnés. A chaque intervalle de temps, le noeud peut soit libérer
le message le plus récent pour tous les sujets, ou publier le message le plus récent
pour le sujet suivant.
</p>
<p><b>Remarque</b> : En mode limite de débit, la profondeur maximale de la file d'attente peut être définie par une propriété de votre
fichier <i>settings.js</i>. Par exemple <code>nodeMessageBufferMaxLength : 1000</code></p>
</script>

View File

@ -0,0 +1,50 @@
<!--
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="trigger">
<p>Lorsqu'il est déclenché, peut envoyer un message, puis éventuellement un deuxième message, sauf extension ou réinitialisation.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">delay <span class="property-type">nombre</span></dt>
<dd>Définit le délai, en millisecondes, à appliquer au message. Cette option s'applique uniquement si le noeud est configuré pour permettre au message de remplacer l'intervalle de délai configuré par défaut.</dd>
<dt class="optional">reset</dt>
<dd>Si un message est reçu avec cette propriété, tout délai d'expiration ou répétition
actuellement en cours sera effacé et aucun message ne sera déclenché.</dd>
</dl>
<h3>Détails</h3>
<p>Ce noeud peut être utilisé pour créer un délai d'attente dans un flux. Par défaut, lorsque
il reçoit un message, il envoie un message avec une <code>charge utile</code> de <code>1</code>.
Il attend ensuite 250 ms avant d'envoyer un deuxième message avec une <code>charge utile</code> de <code>0</code>.
Cela pourrait être utilisé, par exemple, pour faire clignoter une LED attachée à une broche GPIO du Raspberry Pi.</p>
<p>Les charges utiles de chaque message envoyé peuvent être configurées sur une variété de valeurs, y compris
la possibilité de ne rien envoyer. Par exemple, définir le message initial sur <i>rien</i> et
en sélectionnant l'option pour prolonger la minuterie avec chaque message reçu, le noeud
agira en tant que minuteur de surveillance; n'envoie un message que si rien n'est reçu dans le délai
défini dans l'intervalle.</p>
<p>Si défini sur un type <i>chaîne</i>, le noeud prend en charge la syntaxe moustache.</p>
<p>Le délai entre l'envoi des messages peut être remplacé par <code>msg.delay</code> si cette option est activée dans le noeud. La valeur doit être fournie en millisecondes.</p>
<p>Si le noeud reçoit un message avec une propriété <code>reset</code>, ou une propriété <code>payload</code>
qui correspond à celle configurée dans le noeud, tout délai d'expiration ou répétition actuellement en cours
de progression sera effacé et aucun message ne sera déclenché.</p>
<p>Le noeud peut être configuré pour renvoyer un message à intervalle régulier jusqu'à ce qu'il
soit réinitialisé par un message reçu.</p>
<p>En option, le noeud peut être configuré pour traiter les messages comme s'il s'agissait de flux distincts,
en utilisant une propriété msg pour identifier chaque flux. <code>msg.topic</code> par défaut.</p>
<p>Le statut indique que le noeud est actuellement actif. Si plusieurs flux sont utilisés, l'état
indique le nombre de flux en cours.</p>
</script>

View File

@ -0,0 +1,84 @@
<!--
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="exec">
<p>Exécute une commande système et renvoie sa sortie.</p>
<p>Le noeud peut être configuré pour attendre la fin de la commande ou pour
envoyer sa sortie au fur et à mesure que la commande la génère.</p>
<p>La commande exécutée peut être configurée dans le noeud ou fournie par le
message reçu.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">payload <span class="property-type">chaîne de caractères</span></dt>
<dd>si configuré pour le faire, sera ajouté à la commande exécutée.</dd>
<dt class="optional">kill <span class="property-type">chaîne de caractères</span></dt>
<dd>le type de signal d'arrêt pour envoyer au noeud du processus exec existant.</dd>
<dt class="optional">pid <span class="property-type">nombre|chaîne de caractères</span></dt>
<dd>l'ID de processus d'un noeud exec existant à tuer.</dd>
</dl>
<h3>Sorties</h3>
<ol class="node-ports">
<li>Sortie standard
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères</span></dt>
<dd>la sortie standard de la commande.</dd>
</dl>
<dl class="message-properties">
<dt>rc <span class="property-type">objet</span></dt>
<dd>mode exec uniquement, une copie de l'objet code retourné (également disponible sur le port 3)</dd>
</dl>
</li>
<li>Erreur standard
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères</span></dt>
<dd>l'erreur standard de la commande.</dd>
</dl>
<dl class="message-properties">
<dt>rc <span class="property-type">objet</span></dt>
<dd>mode exec uniquement, une copie de l'objet code retourné (également disponible sur le port 3)</dd>
</dl>
</li>
<li>Code de retour
<dl class="message-properties">
<dt>payload <span class="property-type">objet</span></dt>
<dd>un objet contenant le code retourné, et éventuellement les propriétés <code>message</code>, <code>signal</code>.</dd>
</dl>
</li>
</ol>
<h3>Détails</h3>
<p>Par défaut, utiliser l'appel système <code>exec</code> qui appelle la commande, attend qu'elle se termine, puis
renvoie la sortie. Par exemple, une commande réussie doit avoir un code de retour <code>{ code : 0 }</code>.</p>
<p>Vous pouvez éventuellement utiliser <code>spawn</code> à la place, qui renvoie la sortie de stdout et stderr
pendant l'exécution de la commande, généralement une ligne à la fois. À la fin, il renvoie ensuite un objet
sur le 3ème port. Par exemple, une commande réussie doit renvoyer <code>{ code : 0 }</code>.</p>
<p>Des informations supplémentaires sur les erreurs peuvent être envoyées sur le 3e port <code>msg.payload</code>, comme une chaîne <code>message</code>,
<code>signal</code> chaîne.</p>
<p>La commande qui est exécutée est définie dans le noeud, avec une option pour ajouter <code>msg.payload</code> et un autre ensemble de paramètres.</p>
<p>Les commandes ou les paramètres avec des espaces doivent être placés entre guillemets - <code>"Ceci est un paramètre unique"</code></p>
<p>La charge utile <code>payload</code> renvoyée est généralement une <i>chaîne</i>, sauf si des caractères non UTF8 sont détectés, dans ce cas,
il s'agit d'un <i>tampon</i>.</p>
<p>L'icône d'état et le PID du noeud seront visibles tant que le noeud est actif. Les modifications apportées à cela peuvent être lues par le noeud <code>Status</code>.</p>
<p>L'option <code>Masquer la console</code> masquera la console de processus normalement affichée sur les systèmes Windows.</p>
<h4>Tuer les processus</h4>
<p>L'envoi de <code>msg.kill</code> tuera un seul processus actif. <code>msg.kill</code> doit être une chaîne contenant
le type de signal à envoyer, par exemple, <code>SIGINT</code>, <code>SIGQUIT</code> ou <code>SIGHUP</code>.
La valeur par défaut est <code>SIGTERM</code> si défini sur une chaîne vide.</p>
<p>Si le noeud a plus d'un processus en cours d'exécution, alors <code>msg.pid</code> doit également être défini avec la valeur du PID à tuer.</p>
<p>Si une valeur est fournie dans le champ <code>Timeout</code> alors, si le processus n'est pas terminé lorsque le nombre de secondes spécifié s'est écoulé, le processus sera tué automatiquement</p>
<p>Astuce : si vous exécutez une application Python, vous devrez peut-être utiliser le paramètre <code>-u</code> pour arrêter la mise en mémoire tampon de la sortie.</p>
</script>

View File

@ -0,0 +1,41 @@
<script type="text/html" data-help-name="rbe">
<p>Noeud de rapport par exception (RBE) - ne transmet les données que si la charge utile a changée.
Il peut également bloquer, ou ignorer si la valeur change d'une quantité spécifiée (mode bande morte et bande étroite).</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload
<span class="property-type">nombre | chaîne de caractères | (objet)</span>
</dt>
<dd>Le mode RBE accepte les nombres, les chaînes et les objets simples.
Les autres modes doivent fournir un nombre analysable.</dd>
<dt class="optional">topic <span class="property-type">chaîne de caractères</span>
</dt>
<dd>si spécifié, la fonction fonctionnera sur une base par sujet. Cette propriété peut être définie par configuration.</dd>
<dt class="optional">reset<span class="property-type">tout</span></dt>
<dd>si défini efface la valeur stockée pour le msg.topic spécifié, ou
tous les sujets si msg.topic n'est pas spécifié.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload
<span class="property-type">selon l'entrée</span>
</dt>
<dd>Si elle est déclenchée, la sortie sera la même que l'entrée.</dd>
</dl>
<h3>Détails</h3>
<p>En mode RBE ce noeud bloquera jusqu'au <code>msg.payload</code>,
(ou la propriété sélectionnée) est différente de la précédente.
Si nécessaire, il peut ignorer la valeur initiale, afin de ne rien envoyer au démarrage.</p>
<p>Les modes <a href="https://en.wikipedia.org/wiki/Deadband" target="_blank">Bande morte</a> bloqueront la valeur entrante
<i>sauf si</i> sa variation est supérieure ou égale à &plusmn; la bande morte par rapport à une valeur précédente.</p>
<p>Les modes à bande étroite bloqueront la valeur entrante,
<i>si</i> sa variation est supérieure ou égale à &plusmn; la bande morte par rapport à la valeur précédente.
C'est utile pour ignorer les valeurs aberrantes d'un capteur défectueux par exemple.</p>
<p>En mode bande morte et bande étroite, la valeur entrante doit contenir un nombre analysable et
les deux prennent également en charge % - n'envoie que si/sauf si l'entrée diffère de plus de x % de la valeur d'origine.</p>
<p>La bande morte et la bande étroite permettent une comparaison avec la valeur de sortie valide précédente, donc
en ignorant toute valeur hors plage ou la valeur d'entrée précédente, ce qui réinitialise le point de consigne, permettant ainsi
une dérive graduelle (bande morte) ou un changement progressif (bande étroite).</p>
<p><b>Remarque :</b> Cela fonctionne sur un <code>msg.topic</code> par défaut, bien que cela puisse être changé pour une autre propriété si vous le souhaitez.
Cela signifie qu'un seul noeud de filtre peut gérer plusieurs sujets différents en même temps.</p>
</script>

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,19 @@
<!--
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="tls-config">
<p>Options de configuration pour les connexions TLS.</p>
</script>

View File

@ -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="http proxy">
<p>Options de configuration pour le proxy HTTP.</p>
<h3>Détails</h3>
<p>Lors de l'accès à l'hôte dans la liste des hôtes ignorés, aucun proxy ne sera utilisé.</p>
</script>

View File

@ -0,0 +1,160 @@
<!--
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="mqtt in">
<p>Se connecte à un courtier MQTT et s'abonne aux messages du sujet spécifié.</p>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères | tampon</span></dt>
<dd>une chaîne à moins qu'elle ne soit détectée comme un tampon binaire.</dd>
<dt>topic <span class="property-type">chaîne de caractères</span></dt>
<dd>la rubrique MQTT, utilise / comme séparateur de hiérarchie.</dd>
<dt>qos <span class="property-type">nombre</span> </dt>
<dd>0, tirer et oublier - 1, au moins une fois - 2, une fois seulement.</dd>
<dt>retain <span class="property-type">booléen</span></dt>
<dd>true indique que le message a été conservé et peut être ancien.</dd>
<dt class="optional">responseTopic <span class="property-type">chaîne de caractères</span></dt>
<dd><b>MQTTv5</b>: le sujet de réponse MQTT pour le message</dd>
<dt class="optional">correlationData <span class="property-type">tampon</span></dt>
<dd><b>MQTTv5</b>: les données de corrélation pour le message</dd>
<dt class="optional">contentType <span class="property-type">chaîne de caractères</span></dt>
<dd><b>MQTTv5</b>: le type de contenu de la charge utile</dd>
<dt class="optional">userProperties <span class="property-type">objet</span></dt>
<dd><b>MQTTv5</b>: toutes les propriétés utilisateur du message</dd>
<dt class="optional">messageExpiryInterval <span class="property-type">nombre</span></dt>
<dd><b>MQTTv5</b>: le délai d'expiration, en secondes, du message</dd>
</dl>
<h3>Détails</h3>
Le sujet d'abonnement peut inclure des caractères génériques MQTT, + pour un niveau, # pour plusieurs niveaux.</p>
<p>Ce noeud nécessite une connexion à un courtier MQTT pour être configuré. Configurer en cliquant sur
l'icône du crayon.</p>
<p>Plusieurs noeuds MQTT (entrée ou sortie) peuvent partager la même connexion de courtier si nécessaire.</p>
<h4>Abonnement dynamique</h4>
Le noeud peut être configuré pour contrôler dynamiquement la connexion MQTT et ses abonnements. Lorsque cette option est activé, le noeud aura une entrée et pourra être contrôlé en lui transmettant des messages.
<h3>Entrées</h3>
<p>Celles-ci ne s'appliquent que lorsque le noeud a été configuré pour les abonnements dynamiques.</p>
<dl class="message-properties">
<dt>action <span class="property-type">chaîne de caractères</span></dt>
<dd>le nom de l'action que le noeud doit effectuer. Les actions disponibles sont : <code>"connect"</code>,
<code>"disconnect"</code>, <code>"subscribe"</code> and <code>"unsubscribe"</code>.</dd>
<dt class="optional">topic <span class="property-type">chaîne de caractères|objet|tableau</span></dt>
<dd>Pour les actions <code>"subscribe"</code> et <code>"unsubscribe"</code>, cette propriété
donne le sujet. Il peut être défini comme suit :<ul>
<li>une chaîne contenant le filtre de sujet</li>
<li>un objet contenant les propriétés <code>topic</code> et <code>qos</code></li>
<li>un tableau de chaînes ou d'objets pour gérer plusieurs sujets en un</li>
</ul>
</dd>
<dt class="optional">broker <span class="property-type">broker</span> </dt>
<dd>Pour l'action <code>"connect"</code>, cette propriété peut remplacer tout
les paramètres de configuration du courtier individuel, y compris:
<ul>
<li><code>broker</code></li>
<li><code>port</code></li>
<li><code>url</code> - remplace le courtier/port pour fournir une URL de connexion complète</li>
<li><code>nom d'utilisateur</code></li>
<li><code>mot de passe</code></li>
</ul>
<p>Si cette propriété est définie et que le courtier est déjà connecté, une erreur
sera enregistré à moins qu'il n'ait la propriété <code>force</code> définie - auquel cas il sera
déconnecté du courtier, appliquer les nouveaux paramètres et reconnectez-vous.</p>
</dd>
</dl>
</script>
<script type="text/html" data-help-name="mqtt out">
<p>Se connecte à un broker MQTT et publie des messages.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères | tampon</span></dt>
<dd> la charge utile à publier. Si cette propriété n'est pas définie, aucun message ne sera envoyé. Pour envoyer un message vide, définisser cette propriété sur une chaîne vide.</dd>
<dt class="facultatif">topic <span class="property-type">chaîne de caractères</span></dt>
<dd> le sujet MQTT dans laquelle publier.</dd>
<dt class="facultatif">qos <span class="property-type">numéro</span></dt>
<dd>0, tirer et oublier - 1, au moins une fois - 2, une fois et une seule. Par défaut 0.</dd>
<dt class="facultatif">retain <span class="property-type">booléen</span></dt>
<dd>définir sur true pour conserver le message sur le courtier. Faux par défaut.</dd>
<dt class="facultatif">responseTopic <span class="property-type">chaîne de caractères</span></dt>
<dd><b>MQTTv5</b> : le sujet de réponse MQTT pour le message</dd>
<dt class="facultatif">correlationData <span class="property-type">Buffer</span></dt>
<dd><b>MQTTv5</b> : les données de corrélation pour le message</dd>
<dt class="optional">contentType <span class="property-type">chaîne de caractères</span></dt>
<dd><b>MQTTv5</b> : le type de contenu de la charge utile</dd>
<dt class="facultatif">userProperties <span class="property-type">objet</span></dt>
<dd><b>MQTTv5</b> : toutes les propriétés utilisateur du message</dd>
<dt class="facultatif">messageExpiryInterval <span class="property-type">numéro</span></dt>
<dd><b>MQTTv5</b> : le délai d'expiration, en secondes, du message</dd>
<dt class="facultatif">sujetAlias <span class="property-type">numéro</span></dt>
<dd><b>MQTTv5</b> : l'alias de rubrique MQTT à utiliser</dd>
</dl>
<h3>Détails</h3>
<code>msg.payload</code> est utilisé comme charge utile du message publié.
S'il contient un objet, il sera converti en chaîne JSON avant d'être envoyé.
S'il contient un tampon binaire, le message sera publié tel quel.</p>
<p>Le sujet utilisé peut être configuré dans le noeud ou, s'il est laissé vide, peut être défini dans le <code>msg.topic</code>.</p>
<p>De même, la QoS et les valeurs de conservation peuvent être configurées dans le noeud ou, si elles sont laissées
vide, défini dans <code>msg.qos</code> et <code>msg.retain</code> respectivement. Pour effacer un
sujet retenu du courtier, envoyer un message vide à ce sujet avec l'indicateur de conservation défini.</p>
<p>Ce noeud nécessite une connexion à un courtier MQTT pour être configuré. Pour configurer cliquer sur
l'icône du crayon.</p>
<p>Plusieurs noeuds MQTT (entrant ou sortant) peuvent partager la même connexion de courtier si nécessaire.</p>
<h4>Contrôle dynamique</h4>
La connexion partagée par le noeud peut être contrôlée dynamiquement. Si le noeud reçoit
l'un des messages de contrôle suivants, il ne publiera pas non plus la charge utile du message.
<h3>Entrées</h3>
<dl class="message-properties">
<dt>action <span class="property-type">chaîne de caractères</span></dt>
<dd>le nom de l'action que le noeud doit effectuer. Les actions disponibles sont : <code>"connect"</code>,
et <code>"disconnect"</code>.</dd>
<dt class="optional">broker <span class="property-type">broker</span> </dt>
<dd>Pour l'action <code>"connect"</code>, cette propriété peut remplacer tous
les paramètres de configuration du courtier individuel, y compris : <ul>
<li><code>broker</code></li>
<li><code>port</code></li>
<li><code>url</code> - overrides broker/port to provide a complete connection url</li>
<li><code>nom d'utilisateur</code></li>
<li><code>mot de passe</code></li>
</ul>
<p>Si cette propriété est définie et que le courtier est déjà connecté, une erreur
sera enregistré à moins qu'il n'ait la propriété <code>force</code> définie - auquel cas il sera
déconnecté du courtier, appliquer les nouveaux paramètres et reconnectez-vous.</p>
</dd>
</dl>
</script>
<script type="text/html" data-help-name="mqtt-broker">
<p>Configuration d'une connexion à un broker MQTT.</p>
<p>Cette configuration créera une connexion unique au courtier qui peut
être réutilisée par les noeuds <code>MQTT in</code> et <code>MQTT out</code>.</p>
<p>Le noeud générera un ID client aléatoire si aucun n'est défini et le
noeud utilisera une connexion Clean Session. Si un ID client est défini,
il doit être unique pour le courtier auquel vous vous connectez.</p>
<h4>Message au démarrage</h4>
<p>Ceci est un message qui sera publié sur le sujet configuré chaque fois que le
la connexion est établie.</p>
<h4>Message à la fermeture</h4>
<p>Ceci est un message qui sera publié sur le sujet configuré avant que la
connexion soit fermée normalement, soit en redéployant le noeud, soit en s'arrêtant.</p>
<h4>Message à la perte de connexion</h4>
<p>Ceci est un message qui sera publié par le courtier dans le cas où le noeud
perd inopinément sa connexion.</p>
<h4>WebSockets</h4>
<p>Le noeud peut être configuré pour utiliser une connexion WebSocket. Pour ce faire, le Serveur
doit être configuré avec un URI complet pour la connexion. Par exemple :</p>
<pre>ws://example.com:4000/mqtt</pre>
</script>

View File

@ -0,0 +1,100 @@
<!--
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="http in">
<p>Crée un point de terminaison HTTP pour créer des services Web.</p>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload</dt>
<dd>Pour une requête GET, cette propriété contient un objet de tous les paramètres de chaîne de requête.
Sinon, contient le corps de la requête HTTP.</dd>
<dt>req<span class="property-type">objet</span></dt>
<dd>Un objet de requête HTTP. Cet objet contient plusieurs propriétés qui
fournir des informations sur la demande.
<ul>
<li><code>body</code> - le corps de la requête entrante. Le format
dépendra de la demande.</li>
<li><code>headers</code> - un objet contenant les en-têtes de requête HTTP.</li>
<li><code>query</code> - un objet contenant les paramètres de chaîne de requête.</li>
<li><code>params</code> - un objet contenant tous les paramètres de routage.</li>
<li><code>cookies</code> - un objet contenant les cookies de la requête.</li>
<li><code>files</code> - s'il est activé dans le noeud, un objet contenant
tous les fichiers téléchargés dans le cadre d'une requête POST.</li>
</ul>
</dd>
<dt>res<span class="property-type">objet</span></dt>
<dd>Un objet de réponse HTTP. Cette propriété ne doit pas être utilisée directement;
le noeud <code>Réponse HTTP</code> documente comment répondre à une requête.
Cette propriété doit rester attachée au message transmis au noeud de réponse.</dd>
</dl>
<h3>Détails</h3>
<p>Le noeud écoutera sur le chemin configuré les requêtes d'un type particulier.
Le chemin peut être entièrement spécifié, tel que <code>/user</code>, ou inclure
des paramètres nommés qui acceptent n'importe quelle valeur, comme <code>/user/:name</code>.
Lorsque des paramètres nommés sont utilisés, leur valeur réelle dans une requête est accessible sous <code>msg.req.params</code>.</p>
<p>Pour les requêtes qui incluent un corps, tel qu'un POST ou un PUT, le contenu de
la demande est rendue disponible en tant que <code>msg.payload</code>.</p>
<p>Si le type de contenu de la requête peut être déterminé, le corps sera analysé pour
tout type approprié. Par exemple, <code>application/json</code> sera analysé en
tant que représentation d'objet JavaScript.</p>
<p><b>Remarque</b> : ce noeud n'envoie aucune réponse à la requête. Le flux
doit inclure un noeud de réponse HTTP pour terminer la requête.</p>
</script>
<script type="text/html" data-help-name="http response">
<p>Renvoie les réponses des requêtes reçues d'un noeud d'entrée HTTP.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères</span></dt>
<dd>Le corps de la réponse.</dd>
<dt class="optional">statusCode <span class="property-type">nombre</span></dt>
<dd>S'il est défini, il est utilisé comme code d'état de réponse. Par défaut : 200.</dd>
<dt class="optional">headers <span class="property-type">objet</span></dt>
<dd>Si défini, fournit les en-têtes HTTP à inclure dans la réponse.</dd>
<dt class="optional">cookies <span class="property-type">objet</span></dt>
<dd>Si défini, peut être utilisé pour définir ou supprimer les cookies.</dd>
</dl>
<h3>Détails</h3>
<p>Les <code>statusCode</code> et <code>headers</code> peuvent également être définis dans
le noeud lui-même. Si une propriété est définie dans le noeud, elle ne peut pas être remplacée
par la propriété de message correspondante.</p>
<h4>Gestion des cookies</h4>
<p>La propriété <code>cookies</code> doit être un objet de paires nom/valeur.
La valeur peut être soit une chaîne pour définir la valeur du cookie avec des
options par défaut, soit il peut être un objet d'options.</p>
<p>L'exemple suivant définit deux cookies - l'un appelé <code>name</code> avec
une valeur de <code>nick</code>, l'autre appelée <code>session</code> avec un
valeur de <code>1234</code> et une expiration fixée à 15 minutes.</p>
<pre>
msg.cookies = {
name: 'nick',
session: {
value: '1234',
maxAge: 900000
}
}</pre>
<p>Les options valides incluent :</p>
<ul>
<li><code>domain</code> - (Chaîne) nom de domaine pour le cookie</li>
<li><code>expires</code> - (Date) date d'expiration en GMT. S'il n'est pas spécifié ou défini sur 0, crée un cookie de session</li>
<li><code>maxAge</code> - (Chaîne) date d'expiration par rapport à l'heure actuelle en millisecondes</li>
<li><code>path</code> - (Chaîne) chemin du cookie. Par défaut à /</li>
<li><code>value</code> - (Chaîne) la valeur à utiliser pour le cookie</li>
</ul>
<p>Pour supprimer un cookie, définisser sa valeur <code>value</code> sur <code>null</code>.</p>
</script>

View File

@ -0,0 +1,96 @@
<!--
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="http request">
<p>Envoie des requêtes HTTP et renvoie la réponse.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">url <span class="property-type">chaîne de caractères</span></dt>
<dd>Si elle n'est pas configurée dans le noeud, cette propriété facultative définit l'url de la requête.</dd>
<dt class="optional">method <span class="property-type">chaîne de caractères</span></dt>
<dd>Si elle n'est pas configurée dans le noeud, cette propriété facultative définit la méthode HTTP de la requête.
Doit être l'une des méthodes suivantes <code>GET</code>, <code>PUT</code>, <code>POST</code>, <code>PATCH</code> or <code>DELETE</code>.</dd>
<dt class="optional">headers <span class="property-type">objet</span></dt>
<dd>Définit les en-têtes HTTP de la requête. REMARQUE : Tous les en-têtes définis dans la configuration du noeud écraseront tous les en-têtes correspondants dans <code>msg.headers</code>.</dd>
<dt class="optional">cookies <span class="property-type">object</span></dt>
<dd>Si défini, peut être utilisé pour envoyer des cookies avec la demande.</dd>
<dt class="optional">payload</dt>
<dd>Envoyé dans le corps de la requête.</dd>
<dt class="optional">rejectUnauthorized</dt>
<dd>Si défini sur <code>false</code>, permet d'effectuer des requêtes vers des sites https qui utilisent
des certificats auto-signés.</dd>
<dt class="optional">followRedirects</dt>
<dd>Si défini sur <code>false</code> empêche la redirection suivante (HTTP 301).<code>true</code> par défaut</dd>
<dt class="optional">requestTimeout</dt>
<dd>Si défini sur un nombre positif de millisecondes, remplacera le paramètre <code>httpRequestTimeout</code> défini globalement.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères | objet | tampon</span></dt>
<dd>Le corps de la réponse. Le noeud peut être configuré pour renvoyer le corps
en tant que chaîne, essayer de l'analyser en tant que chaîne JSON ou laisser-le en tant que
tampon binaire.</dd>
<dt>statusCode <span class="property-type">nombre</span></dt>
<dd>Le code d'état de la réponse, ou le code d'erreur si la demande n'a pas pu être complétée.</dd>
<dt>headers <span class="property-type">objet</span></dt>
<dd>Un objet contenant les en-têtes de réponse.</dd>
<dt>responseUrl <span class="property-type">chaîne de caractères</span></dt>
<dd>Dans le cas où des redirections se sont produites lors du traitement de la demande, cette propriété est l'URL finale redirigée.
Sinon, l'url de la demande d'origine.</dd>
<dt>responseCookies <span class="property-type">object</span></dt>
<dd>Si la réponse inclut des cookies, cette propriété est un objet de paires nom/valeur pour chaque cookie.</dd>
<dt>redirectList <span class="property-type">tableau</span></dt>
<dd>Si la requête a été redirigée une ou plusieurs fois, les informations accumulées seront ajoutées à cette propriété. `location` est la prochaine destination de redirection. `cookies` correspond aux cookies renvoyés par la source de redirection.</dd>
</dl>
<h3>Détails</h3>
<p>Lorsqu'elle est configurée dans le noeud, la propriété URL peut contenir des balises <a href="http://mustache.github.io/mustache.5.html" target="_blank">de style moustache</a>. Celles-ci permettent à
l'url de construire en utilisant les valeurs du message entrant. Par exemple, si l'URL est définie sur
<code>example.com/{{{topic}}}</code>, la valeur du <code>msg.topic</code> sera automatiquement insérée.
L'utilisation de {{{...}}} empêche le style moustache de s'échapper des caractères comme / & etc.</p>
<p>Le noeud peut éventuellement encoder automatiquement <code>msg.payload</code> en tant que paramètres de chaîne de requête pour une requête GET, dans ce cas <code>msg.payload</code> doit être un objet.</p >
<p><b>Remarque</b> : en cas d'exécution derrière un proxy, la variable d'environnement standard <code>http_proxy=...</code> doit être définie et Node-RED redémarré, ou utiliser la configuration du proxy. Si la configuration du proxy a été définie, la configuration a priorité sur la variable d'environnement.</p>
<h4>Utilisation de plusieurs noeuds de requête HTTP</h4>
<p>Afin d'utiliser plus d'un de ces noeuds dans le même flux, des précautions doivent être prises avec
la propriété <code>msg.headers</code>. Le premier noeud définira cette propriété avec
les en-têtes de réponse. Le noeud suivant utilisera alors ces en-têtes pour sa requête - ceci
n'est généralement pas la bonne chose à faire. Si la propriété du <code>msg.headers</code> reste inchangée
entre les noeuds, il sera ignoré par le deuxième noeud. Pour définir des en-têtes personnalisés, le <code>msg.headers</code>
doit d'abord être supprimé ou réinitialisé sur un objet vide : <code>{}</code>.
<h4>Gestion des cookies</h4>
<p>La propriété <code>cookies</code> transmise au noeud doit être un objet de paires nom/valeur.
La valeur peut être soit une chaîne pour définir la valeur du cookie, soit un
objet avec une seule propriété <code>value</code>.<p>
<p>Tous les cookies renvoyés par la requête sont envoyés sous la propriété <code>responseCookies</code>.</p>
<h4>Gestion des types de contenu</h4>
<p>Si <code>msg.payload</code> est un objet, le noeud définira automatiquement le type de contenu
de la requête à <code>application/json</code> et encode le corps en tant que tel.</p>
<p>Pour encoder la demande en tant que données de formulaire, <code>msg.headers["content-type"]</code> doit être défini sur <code>application/x-www-form-urlencoded</code>.< /p>
<h4>Téléchargement de fichier</h4>
<p>Pour effectuer un téléchargement de fichier, <code>msg.headers["content-type"]</code> doit être défini sur <code>multipart/form-data</code>
et le <code>msg.payload</code> passé au noeud doit être un objet avec la structure suivante :</p>
<pre><code>{
"KEY": {
"value": FILE_CONTENTS,
"options": {
"filename": "FILENAME"
}
}
}</code></pre>
<p>Les valeurs de <code>KEY</code>, <code>FILE_CONTENTS</code> et <code>FILENAME</code>
doivent être réglées sur les valeurs appropriées.</p>
</script>

View File

@ -0,0 +1,43 @@
<!--
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="websocket in">
<p>Noeud d'entrée WebSocket.</p>
<p>Par défaut, les données reçues du WebSocket seront dans <code>msg.payload</code>.
Le Socket peut être configuré pour attendre une chaîne JSON correctement formée, dans ce
cas, il analysera le JSON et enverra l'objet résultant en tant que message entier.</p>
</script>
<script type="text/html" data-help-name="websocket out">
<p>Noeud de sortie WebSocket.</p>
<p>Par défaut, <code>msg.payload</code> sera envoyé via le WebSocket. Le Socket
peut être configuré pour encoder l'intégralité de l'objet <code>msg</code> en tant que chaîne JSON et l'envoyer
sur le WebSocket.</p>
<p>Si le message arrivant à ce noeud provient d'un noeud WebSocket entrant, le message
sera renvoyé au client qui a déclenché le flux. Sinon, le message
sera diffusé à tous les clients connectés.</p>
<p>Si vous souhaitez diffuser un message provennant d'un noeud WebSocket entrant, vous
devez supprimer la propriété <code>msg._session</code> dans le flux.</p>
</script>
<script type="text/html" data-help-name="websocket-listener">
<p>Ce noeud de configuration crée un point de terminaison WebSocket Server en utilisant le chemin spécifié.</p>
</script>
<script type="text/html" data-help-name="websocket-client">
<p>Ce noeud de configuration connecte un client WebSocket à l'URL spécifiée.</p>
</script>

View File

@ -0,0 +1,45 @@
<!--
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="tcp in">
<p>Fournit un choix d'entrées TCP. Peut soit se connecter à un port TCP distant,
soit accepter les connexions entrantes.</p>
<p><b>Remarque</b> : Sur certains systèmes, vous aurez peut-être besoin d'un accès root ou administrateur
pour accéder aux ports inférieurs à 1024.</p>
</script>
<script type="text/html" data-help-name="tcp out">
<p>Fournit un choix de sorties TCP. Peut soit se connecter à un port TCP distant,
accepter les connexions entrantes soit répondre aux messages reçus d'un noeud TCP in.</p>
<p>Seul le <code>msg.payload</code> est envoyé.</p>
<p>Si <code>msg.payload</code> est une chaîne contenant un encodage Base64 de donnée binaire,
l'option de décodage Base64 entraînera sa reconversion en binaire
avant d'être envoyé.</p>
<p>Si <code>msg._session</code> n'est pas présent, la charge utile est
envoyé à <b>tous</b> les clients connectés.</p>
<p><b>Remarque</b> : Sur certains systèmes, vous aurez peut-être besoin d'un accès root ou administrateur
pour accéder aux ports inférieurs à 1024.</p>
</script>
<script type="text/html" data-help-name="tcp request">
<p>Un simple noeud de requête TCP - envoie le <code>msg.payload</code> à un port tcp du serveur et attend une réponse.</p>
<p>Se connecte, envoie la "requête" et lit la "réponse". Il peut soit compter un certain nombre de
caractères renvoyés dans un tampon fixe, correspondant à un caractère spécifié avant de revenir,
attendre un délai fixe à partir de la première réponse, puis revenir, s'installer et attender les données, ou envoie puis ferme la connexion
immédiatement, sans attendre de réponse.</p>
<p>La réponse sortira dans <code>msg.payload</code> en tant que tampon, vous pouvez alors utiliser la fonction .toString().</p>
<p>Si vous laissez l'hôte ou le port tcp vide, ils doivent être définis à l'aide des propriétés <code>msg.host</code> et <code>msg.port</code> dans chaque message envoyé au noeud.</ p>
</script>

View File

@ -0,0 +1,31 @@
<!--
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="udp in">
<p>Un noeud d'entrée UDP, qui produit un <code>msg.payload</code> contenant un
tampon, chaîne ou chaîne encodée en base64. Prend en charge la multidiffusion.</p>
<p>Il fournit également <code>msg.ip</code> et <code>msg.port</code> définis sur
l'adresse IP et le port à partir desquels le message a été reçu.</p>
<p><b>Remarque</b> : Sur certains systèmes, vous aurez peut-être besoin d'un accès root ou administrateur pour utiliser
les ports inférieurs à 1024 et/ou diffusés.</p>
</script>
<script type="text/html" data-help-name="udp out">
<p>Ce noeud envoie un <code>msg.payload</code> à l'hôte et au port UDP désigné. Prend en charge la multidiffusion.</p>
<p>Vous pouvez également utiliser <code>msg.ip</code> et <code>msg.port</code> pour définir les valeurs de destination, mais les valeurs configurées statiquement ont priorité.</p>
<p>Si vous sélectionnez la diffusion, définisser l'adresse sur l'adresse IP de diffusion locale ou essayer 255.255.255.255, qui est l'adresse de diffusion globale.</p>
<p><b>Remarque</b> : sur certains systèmes, vous devrez peut-être être root pour utiliser des ports inférieurs à 1024 et/ou de diffusion.</p>
</script>

View File

@ -0,0 +1,52 @@
<!--
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="csv">
<p>Convertit une chaîne au format CSV en une représentation d'objet JavaScript, et inversément.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | tableau | chaîne de caractères</span></dt>
<dd>Un objet JavaScript, un tableau ou une chaîne CSV.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | tableau | chaîne de caractères</span></dt>
<dd>
<ul>
<li>Si l'entrée est une chaîne, le noeud essaie de l'analyser en tant que CSV et crée un objet JavaScript de paires clé/valeur pour chaque ligne.
Le noeud enverra alors soit un message pour chaque ligne, soit un seul message contenant un tableau d'objets.</li>
<li>Si l'entrée est un objet JavaScript, le noeud essaie de créer une chaîne CSV.</li>
<li>Si l'entrée est un tableau de valeurs simples, le noeud crée une chaîne CSV sur une seule ligne.</li>
<li>Si l'entrée est un tableau de tableaux ou un tableau d'objets, une chaîne CSV multiligne est créée.</li>
</ul>
</dd>
</dl>
<h3>Détails</h3>
<p>Le modèle de colonne peut contenir une liste ordonnée de noms de colonnes. Lors de la conversion de CSV en objet, les noms de colonne
seront utilisés comme noms de propriété. Alternativement, les noms de colonne peuvent être tirés de la première ligne du CSV.</p>
<p>Lors de la conversion au format CSV, le modèle de colonnes est utilisé pour identifier les propriétés à extraire de l'objet et dans quel ordre.</p>
<p>Si le modèle de colonnes est vide, vous pouvez utiliser une simple liste de propriétés séparées par des virgules fournies dans <code>msg.columns</code> pour
déterminer quoi extraire et dans quel ordre. Si ni l'un ni l'autre n'est présent, toutes les propriétés de l'objet sont sorties dans l'ordre
dans lesquelles les propriétés se trouvent dans la première ligne.</p>
<p>Si l'entrée est un tableau, le modèle de colonnes n'est utilisé que pour éventuellement générer une ligne de titres de colonne.</p>
<p>Si l'option 'analyser les valeurs numériques' est cochée, les valeurs numériques de la chaîne seront renvoyées sous forme de nombres, c'est à dire. valeur médiane '1,"1.5",'2'.</p>
<p>Si l'option 'inclure les chaînes vides' est cochée, les chaînes vides seront renvoyées dans le résultat, c'est à dire. valeur médiane '1,"",3'.</p>
<p>Si l'option 'inclure les valeurs nulles' est cochée, les valeurs nulles seront renvoyées dans le résultat, c'est à dire. valeur médiane '1,,3'.</p>
<p>Le noeud peut accepter une entrée en plusieurs parties tant que la propriété <code>parts</code> est correctement définie, par exemple à partir d'un noeud de fichier d'entrée ou d'un noeud divisé.</p>
<p>Si vous produisez plusieurs messages, leur propriété <code>parts</code> sera définie et formera une séquence de messages complète.</p>
<p>Si le noeud est configuré pour n'envoyer qu'une seule fois les en-têtes de colonne, la définition de <code>msg.reset</code> sur n'importe quelle valeur entraînera le renvoi des en-têtes par le noeud.</p>
<p><b>Remarque</b> : le modèle de colonne doit être séparé par des virgules, même si un séparateur différent est choisi pour les données.</p>
</script>

View File

@ -0,0 +1,36 @@
<!--
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="html">
<p>Extrait des éléments d'un document HTML contenu dans <code>msg.payload</code> à l'aide d'un sélecteur CSS.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne de caractères</span></dt>
<dd>la chaîne html à partir de laquelle extraire les éléments.</dd>
<dt class="optional">select <span class="property-type">string</span></dt>
<dd>s'il n'est pas configuré dans le panneau d'édition, le sélecteur peut être défini comme une propriété du msg.</dd>
</dl>
<h3>Sortie</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">tableau | chaîne de caractères</span></dt>
<dd>le résultat peut être soit un seul message avec une charge utile contenant un tableau des éléments correspondants, soit plusieurs
messages contenant chacun un élément correspondant. Si plusieurs messages sont envoyés, ils auront également des <code>parts</code> (parties) définies.</dd>
</dl>
<h3>Détails</h3>
<p>Ce noeud prend en charge une combinaison de sélecteurs CSS et jQuery. Voir la
<a href="https://github.com/fb55/CSSselect#user-content-supported-selectors" target="_blank">documentation css-select</a> pour plus d'informations
sur la syntaxe prise en charge.</p>
</script>

View File

@ -0,0 +1,54 @@
<!--
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="json">
<p>Convertit une chaîne JSON en une représentation d'objet JavaScript, et inversément.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne de caractères</span></dt>
<dd>Un objet JavaScript ou une chaîne JSON.</dd>
<dt>schema<span class="property-type">object</span></dt>
<dd>Un objet JSON facultatif pour valider la charge utile.
La propriété sera supprimée avant que le <code>msg</code> ne soit envoyé au noeud suivant.
</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne de caractères</span></dt>
<dd>
<ul>
<li>Si l'entrée est une chaîne JSON, elle essaie de l'analyser en un objet JavaScript.</li>
<li>Si l'entrée est un objet JavaScript, elle crée une chaîne JSON. La chaîne peut éventuellement être formatée.</li>
</ul>
</dd>
<dt>schemaError<span class="property-type">tableau</span></dt>
<dd>Si la conversion JSON échoue, le noeud Catch aura une propriété <code>schemaError</code>
contenant un tableau d'erreurs.</dd>
</dl>
<h3>Détails</h3>
<p>Par défaut, le noeud fonctionne sur le <code>msg.payload</code>, mais peut être configuré
pour convertir n'importe quelle propriété du message.</p>
<p>Le noeud peut également être configuré pour assurer un encodage particulier au lieu de basculer
entre les deux. Cela peut être utilisé, par exemple, avec le noeud <code>HTTP in</code>
pour s'assurer que la charge utile soit un objet analysé même si une demande entrante
n'a pas correctement défini son type de contenu pour que le noeud HTTP entrant effectue la conversion.</p>
<p>Si le noeud est configuré pour s'assurer que la propriété est encodée sous forme de chaîne et qu'elle
reçoit une chaîne, aucune autre vérification ne sera effectuée sur la propriété. Cela ne
vérifiera pas que la chaîne soit valide au format JSON et ne la reformatera pas si l'option de format
est sélectionné.</p>
<p>Pour plus de détails sur le schéma JSON, vous pouvez consulter la spécification
<a href="http://json-schema.org/latest/json-schema-validation.html">ici</a>.</p>
</script>

View File

@ -0,0 +1,51 @@
<!--
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="xml">
<p>Convertit une chaîne XML en une représentation d'objet JavaScript, et inversément.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne de caractères</span></dt>
<dd>Un objet JavaScript ou une chaîne XML.</dd>
<dt class="optional">options <span class="property-type">objet</span></dt>
<dd>Cette propriété facultative peut être utilisée pour transmettre l'une des options prises en charge par la sous-jacente
bibliothèque utilisée pour convertir vers et depuis XML. Voir la <a href="https://github.com/Leonidas-from-XIV/node-xml2js/blob/master/README.md#options" target="_blank">documentation de xml2js</a>
pour plus d'informations.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne de caractères</span></dt>
<dd>
<ul>
<li>Si l'entrée est une chaîne, le noeud essaie de l'analyser en tant que XML et crée un objet JavaScript.</li>
<li>Si l'entrée est un objet JavaScript, le noeud essaie de créer une chaîne XML.</li>
</ul>
</dd>
</dl>
<h3>Détails</h3>
<p>Lors de la conversion entre XML et un objet, tous les attributs XML sont ajoutés en tant que propriété nommée <code>$</code> par défaut.
Tout contenu textuel est ajouté en tant que propriété nommée <code>_</code>. Ces noms de propriété peuvent être spécifiés dans la configuration du noeud.</p>
<p>Par exemple, le XML suivant sera converti comme indiqué :</p>
<pre>&lt;p class="tag"&gt;Hello World&lt;/p&gt;</pre>
<pre>{
"p": {
"$": {
"class": "tag"
},
"_": "Hello World"
}
}</pre>
</script>

View File

@ -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="yaml">
<p>Convertit une chaîne au format YAML en une représentation d'objet JavaScript, et inversément.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne de caractères</span></dt>
<dd>Un objet JavaScript ou une chaîne YAML.</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne de caractères</span></dt>
<dd>
<ul>
<li>Si l'entrée est une chaîne YAML, le noeud essaie de l'analyser en un objet JavaScript.</li>
<li>Si l'entrée est un objet JavaScript, le noeud crée une chaîne YAML.</li>
</ul>
</dd>
</dl>
</script>

View File

@ -0,0 +1,172 @@
<!--
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="split">
<p>Divise un message en une séquence de messages.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objet | chaîne | tableau | tampon</span></dt>
<dd>Le comportement du noeud est déterminé par le type du <code>msg.payload</code>:
<ul>
<li><b>chaîne</b>/<b>tampon</b> - le message est divisé en utilisant le caractère spécifié (par défaut : <code>\n</code>), la séquence du tampon ou en longueurs fixes. </li>
<li><b>tableau</b> - le message est divisé en éléments de tableau individuels ou en tableaux de longueur fixe.</li>
<li><b>objet</b> - un message est envoyé pour chaque paire clé/valeur de l'objet.</li>
</ul>
</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>parts<span class="property-type">objet</span></dt>
<dd>Cette propriété contient des informations sur la manière dont le message a été séparé du
message d'origine. Si elle est transmise au noeud <b>join</b>, la séquence peut être
regroupés en un seul message. La propriété a les propriétés suivantes :
<ul>
<li><code>id</code> - un identifiant pour le groupe de messages</li>
<li><code>index</code> - la position au sein du groupe</li>
<li><code>count</code> - si connu, le nombre total de messages dans le groupe. Voir 'mode streaming' ci-dessous.</li>
<li><code>type</code> - le type de message - chaîne/tableau/objet/tampon</li>
<li><code>ch</code> - pour une chaîne ou un tampon, les données utilisées pour diviser le message en chaîne ou en tableau d'octets</li>
<li><code>key</code> - pour un objet, la clé de la propriété à partir de laquelle ce message a été créé. Le noeud peut être configuré pour copier également cette valeur dans d'autres propriétés du message, telles que <code>msg.topic</code>.</li>
<li><code>len</code> - la longueur de chaque message lorsqu'elle est divisée à l'aide d'une valeur de longueur fixe</li>
</ul>
</dd>
</dl>
<h3>Détails</h3>
<p>Ce noeud facilite la création d'un flux qui exécute des actions communes sur
une séquence de messages, à l'aide du noeud <b>join</b>, qui recombine la
séquence en un seul message.</p>
<p>Il utilise la propriété <code>msg.parts</code> pour suivre les parties individuelles
d'une séquence.</p>
<h4>Mode diffusion</h4>
<p>Le noeud peut également être utilisé pour rediffuser un flux de messages. Par exemple, un
périphérique série qui envoie des commandes terminées par une nouvelle ligne peut délivrer un seul message
avec une commande partielle à sa fin. En "mode streaming", ce noeud divisera
le message et enverra chaque segment complet. S'il y a un segment partiel à la fin,
le noeud le conservera et l'ajoutera au prochain message reçu.
</p>
<p>Lorsqu'il fonctionne dans ce mode, le noeud ne définira pas le <code>msg.parts.count</code>
car il ne sait pas combien de messages attendent dans le flux. Cela
signifie qu'il ne peut pas être utilisé avec le noeud <b>join</b> en mode automatique.</p>
</script>
<script type="text/html" data-help-name="join">
<p>Joint des séquences de messages en un seul message.</p>
<p>Trois modes sont disponibles :</p>
<dl>
<dt>automatique</dt>
<dd>Lorsqu'il est associé au noeud <b>split</b>, il joindra automatiquement les messages pour inverser le fractionnement qui a été effectué.</dd>
<dt>manuel</dt>
<dd>Joindre des séquences de messages de différentes manières.</dd>
<dt>réduire la séquence</dt>
<dd>Appliquer une expression à tous les messages d'une séquence pour la réduire à un seul message.</dd>
</dl>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">parts<span class="property-type">objet</span></dt>
<dd>Pour joindre automatiquement une séquence de messages, ils doivent tous avoir
cet ensemble de propriétés. Le noeud <b>split</b> génère cette propriété mais il
peut être créé manuellement. Il a les propriétés suivantes :
<ul>
<li><code>id</code> - un identifiant pour le groupe de messages</li>
<li><code>index</code> - la position au sein du groupe</li>
<li><code>count</code> - le nombre total de messages dans le groupe</li>
<li><code>type</code> - le type de message - chaîne/tableau/objet/tampon</li>
<li><code>ch</code> - pour une chaîne ou un tampon, les données utilisées pour diviser le message en chaîne ou en tableau d'octets</li>
<li><code>key</code> - pour un objet, la clé de la propriété à partir de laquelle ce message a été créé</li>
<li><code>len</code> - la longueur de chaque message lorsqu'il est divisé à l'aide d'une valeur de longueur fixe</li>
</ul>
</dd>
<dt class="optional">complete</dt>
<dd>S'il est défini, le noeud ajoutera la charge utile, puis enverra le message de sortie dans son état actuel.
Si vous ne souhaitez pas ajouter la charge utile, supprimer-la du msg.</dd>
<dt class="optional">reset</dt>
<dd>S'il est défini, le noeud effacera tout message partiellement terminé et ne l'enverra pas.</dd>
<dt class="optional">restartTimeout</dt>
<dd>S'il est défini et que le noeud a un délai d'attente configuré, ce délai d'attente sera redémarré.</dd>
</dl>
<h3>Détails</h3>
<h4>Mode automatique</h4>
<p>Le mode automatique utilise la propriété <code>parts</code> des messages entrants pour
déterminer comment la séquence doit être jointe. Cela lui permet de automatiquement
inverser l'action d'un noeud <b>split</b>.</p>
<h4>Mode manuel</h4>
<p>Lorsqu'il est configuré pour se joindre en mode manuel, le noeud peut joindre des séquences
de messages dans un certain nombre de résultats différents :</p>
<ul>
<li>une <b>chaîne</b> ou un <b>tampon</b> - créé en joignant la propriété sélectionnée de chaque message avec les caractères de jointure ou le tampon spécifiés.</li>
<li>un <b>tableau</b> - créé en ajoutant chaque propriété sélectionnée, ou le message entier, au tableau de sortie.</li>
<li>un <b>objet clé/valeur</b> - créé en utilisant une propriété de chaque message pour déterminer la clé sous laquelle
la valeur requise est stockée.</li>
<li>un <b>objet fusionné</b> - créé en fusionnant la propriété de chaque message sous un seul objet.</li>
</ul>
<p>Les autres propriétés du message de sortie sont extraites du dernier message reçu avant l'envoi du résultat.</p>
<p>Un <i>compteur</i> peut être défini pour le nombre de messages à recevoir avant de générer le message de sortie.
Pour les sorties d'objet, une fois ce nombre atteint, le noeud peut être configuré pour envoyer un message pour chaque message suivant
reçu.</p>
<p>Un <i>temps mort</i> peut être défini pour déclencher l'envoi du nouveau message en utilisant tout ce qui a été reçu jusqu'à présent.
Ce délai peut être redémarré en envoyant un message avec la propriété <code>msg.restartTimeout</code> définie.</p>
<p>Si un message est reçu avec la propriété <code>msg.complete</code> définie, le message de sortie est finalisé et envoyé.
Cela réinitialise tous les compteurs de pièces.</p>
<p>Si un message est reçu avec la propriété <code>msg.reset</code> définie, le message partiellement complet est supprimé et n'est pas envoyé.
Cela réinitialise tous les compteurs de pièces.</p>
<h4>Réduire le mode de séquence</h4>
<p>Lorsqu'il est configuré pour joindre en mode de réduction, une expression est appliquée à chaque
message dans une séquence et le résultat accumulé pour n'envoyer qu'un seul message.</p>
<dl class="message-properties">
<dt>Valeur initiale</dt>
<dd>La valeur initiale de la valeur cumulée (<code>$A</code>).</dd>
<dt>Réduire l'expression</dt>
<dd>Une expression JSONata appelée pour chaque message de la séquence.
Le résultat est transmis au prochain appel de l'expression en tant que valeur cumulée.
Dans l'expression, les variables spéciales suivantes peuvent être utilisées :
<ul>
<li><code>$A</code>: la valeur accumulée, </li>
<li><code>$I</code>: index du message dans la séquence, </li>
<li><code>$N</code>: nombre de messages dans la séquence.</li>
</ul>
</dd>
<dt>Expression de correction</dt>
<dd>Une expression JSONata facultative qui est appliquée après l'expression de réduction
a été appliqué à tous les messages de la séquence.
Dans l'expression, les variables spéciales suivantes peuvent être utilisées :
<ul>
<li><code>$A</code>: la valeur accumulée, </li>
<li><code>$N</code>: nombre de messages dans la séquence.</li>
</ul>
</dd>
<p>Par défaut, l'expression de réduction est appliquée dans l'ordre, du premier
au dernier message de la séquence. Il peut éventuellement être appliqué dans
l'ordre inverse.</p>
<p>$N est le nombre de messages qui arrivent - même s'ils sont identiques.</p>
</dl>
<p><b>Exemple</b> : les paramètres suivants, donnés en tant que séquence de valeurs numériques,
le noeud calculera la valeur moyenne :
<ul>
<li><b>Réduire l'expression</b> : <code>$A+payload</code></li>
<li><b>Valeur initiale</b> : <code>0</code></li>
<li><b>Expression de correction</b> : <code>$A/$N</code></li>
</ul>
</p>
<h4>Stocker des messages</h4>
<p>Ce noeud mettra les messages en mémoire tampon en interne afin de travailler sur plusieurs séquences. Le
paramètre d'exécution <code>nodeMessageBufferMaxLength</code> peut être utilisé pour limiter le nombre de messages
à mettre en mémoire tampon dans le noeud.</p>
</script>

View File

@ -0,0 +1,41 @@
<!--
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="sort">
<p>Une fonction qui trie la propriété du message ou une séquence de messages.</p>
<p>Lorsqu'il est configuré pour trier la propriété du message, le noeud trie les données du tableau pointées par la propriété du message spécifiée.</p>
<p>Lorsqu'il est configuré pour trier une séquence du messages, il réorganisera les messages.</p>
<p>L'ordre de tri peut être :</p>
<ul>
<li><b>ascendant</b>,</li>
<li><b>descendant</b>.</li>
</ul>
<p>Pour les nombres, l'ordre numérique peut être spécifié par une case à cocher.</p>
<p>La clé de tri peut être une valeur d'élément ou une expression JSONata pour trier une valeur de propriété, ou une propriété du message ou une expression JSONata afin de trier une séquence de messages.<p>
<p>Lors du tri d'une séquence du messages, le noeud de tri s'appuie sur les messages reçus pour définir <code>msg.parts</code>. Le noeud fractionné génère cette propriété, mais peut être créé manuellement. Il a les propriétés suivantes :</p>
<p>
<ul>
<li><code>id</code> - un identifiant pour le groupe de messages</li>
<li><code>index</code> - la position au sein du groupe</li>
<li><code>count</code> - le nombre total de messages dans le groupe</li>
</ul>
</p>
<p><b>Remarque</b> : Ce noeud conserve en interne les messages pour son fonctionnement. Afin d'éviter une utilisation inattendue de la mémoire, le nombre maximum de messages conservés peut être spécifié. Par défaut, il n'y a pas de limite sur le nombre de messages.
<ul>
<li><code>nodeMessageBufferMaxLength</code> propriété définie dans <b>settings.js</b>.</li>
</ul>
</p>
</script>

View File

@ -0,0 +1,43 @@
<!--
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="batch">
<p>Crée des séquences de messages en fonction de diverses règles.</p>
<h3>Détails</h3>
<p>Il existe trois modes de création des séquences de messages :</p>
<dl>
<dt>Nombre de messages</dt>
<dd>regroupe les messages en séquences d'une longueur donnée. L'option <b>chevauchement</b>
spécifie combien de messages à la fin d'une séquence doivent être
répété au début de la séquence suivante.</dd>
<dt>Intervalle de temps</dt>
<dd>regroupe les messages qui arrivent dans l'intervalle spécifié. Si aucun message
arrive dans l'intervalle, le noeud peut éventuellement envoyer un message vide.</dd>
<dt>Concaténer des séquences</dt>
<dd>crée une séquence de messages en concaténant les séquences entrantes. Chaque message
doit avoir une propriété <code>msg.topic</code> et une propriété <code>msg.parts</code>
identifiant sa séquence. Le noeud est configuré avec une liste de <code>sujet</code>
afin d'identifier l'ordre des séquences concaténées.
</dd>
</dl>
<h4>Stocker des messages</h4>
<p>Ce noeud stocke les messages en mémoire tampon en interne afin de travailler sur plusieurs séquences. Le
paramètre d'exécution <code>nodeMessageBufferMaxLength</code> peut être utilisé pour limiter le nombre de messages
que mettra le noeud en mémoire tampon.</p>
<p>Si un message est reçu avec la propriété <code>msg.reset</code> définie, les messages mis en mémoire tampon sont supprimés et non envoyés.</p>
</script>

View File

@ -0,0 +1,69 @@
<!--
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="file">
<p>Écrit <code>msg.payload</code> dans un fichier, soit en ajoutant à la fin, soit en remplaçant le contenu existant.
Alternativement, il peut supprimer le fichier.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">filename <span class="property-type">chaîne de caractères</span></dt>
<dd>Le nom du fichier à mettre à jour, peut être soit défini dans la configuration du noeud soit en tant que propriété du message.
Par défaut, il utilisera <code>msg.filename</code> mais cela peut être personnalisé dans le noeud.
</dd>
<dt class="optional">encoding <span class="property-type">chaîne de caractères</span></dt>
<dd>Si l'encodage est configuré pour être défini par msg, cette propriété facultative peut définir l'encodage.</dt>
</dl>
<h3>Sortie</h3>
<p>À la fin de l'écriture, le message d'entrée est envoyé au port de sortie.</p>
<h3>Détails</h3>
<p>Chaque charge utile du message sera ajoutée à la fin du fichier, en ajoutant éventuellement
un caractère de saut de ligne (\n) entre chacun.</p>
<p>Si <code>msg.filename</code> est utilisé, le fichier sera fermé après chaque écriture.
Pour de meilleures performances, utiliser un nom de fichier fixe.</p>
<p>Il peut être configuré pour écraser l'intégralité du fichier plutôt que de l'ajouter. Par exemple,
lors de l'écriture de données binaires dans un fichier, comme une image, cette option doit être utilisée
et l'option d'ajout d'une nouvelle ligne doit être désactivée.</p>
<p>Le codage des données écrites dans un fichier peut être spécifié à partir de la liste des codages.</p>
<p>Alternativement, ce noeud peut être configuré pour supprimer le fichier.</p>
</script>
<script type="text/html" data-help-name="file in">
<p>Lit le contenu d'un fichier sous forme de chaîne ou de tampon binaire.</p>
<h3>Entrées</h3>
<dl class="message-properties">
<dt class="optional">filename <span class="property-type">chaîne de caractères</span></dt>
<dd>Le nom du fichier à lire peut être fourni dans la configuration du noeud ou en tant que propriété du message.
Par défaut, il utilisera <code>msg.filename</code> mais cela peut être personnalisé dans le noeud.
</dd>
</dl>
<h3>Sorties</h3>
<dl class="message-properties">
<dt>payload <span class="property-type">chaîne | tampon</span></dt>
<dd>Le contenu du fichier sous forme de chaîne ou de tampon binaire.</dd>
<dt class="optional">filename <span class="property-type">chaîne de caractères</span></dt>
<dd>Si elle n'est pas configurée dans le noeud, cette propriété facultative définit le nom du fichier à lire.</dd>
</dl>
<h3>Détails</h3>
<p>Le nom du fichier doit être un chemin absolu, sinon il sera relatif au
répertoire de travail du processus Node-RED.</p>
<p>Sous Windows, les séparateurs de chemin peuvent devoir être inversés, par exemple : <code>\\Users\\myUser</code>.</p>
<p>En option, un fichier texte peut être divisé en lignes, produisant un message par ligne, ou un fichier binaire
divisé en blocs de mémoire tampon plus petits - la taille du bloc dépend du système d'exploitation, mais généralement 64k (Linux/Mac) ou 41k (Windows).</p>
<p>Lorsqu'il est divisé en plusieurs messages, chaque message aura un ensemble de propriétés <code>parts</code>,
formant une séquence de message complète.</p>
<p>L'encodage des données d'entrée peut être spécifié à partir de la liste des encodages si le format de sortie est une chaîne.</p>
<p>Les erreurs doivent être détectées et gérées à l'aide d'un noeud Catch.</p>
</script>

View File

@ -0,0 +1,30 @@
<!--
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="watch">
<p>Surveille les modifications d'un répertoire ou d'un fichier.</p>
<p>Vous pouvez saisir une liste de répertoires et/ou de fichiers séparés par des virgules. Vous aurez
besoin de mettre des guillemets "..." autour de tous les répertoires qui contiennent des espaces.</p>
<p>Sous Windows, vous devez utiliser des doubles barres obliques inverses \\ dans tous les noms de répertoire.</p>
<p>Le nom de fichier complet du fichier qui a réellement changé est placé dans <code>msg.payload</code> et <code>msg.filename</code>,
tandis qu'une version sous forme de chaîne de la liste de surveillance est renvoyée dans <code>msg.topic</code>.</p>
<p><code>msg.file</code> contient uniquement le nom court du fichier qui a été modifié.
<code>msg.type</code> contient le type de ce qui a changé, généralement <i>fichier</i> ou <i>répertoire</i>,
tandis que <code>msg.size</code> contient la taille du fichier en octets.</p>
<p>Bien sûr sous Linux, <i>everything</i> est un fichier et peut donc être regardé...</p>
<p><b>Remarque</b> : Le répertoire ou le fichier doit exister pour être surveillé. Si le dossier
ou le répertoire est supprimé, il peut ne plus être surveillé même s'il est recréé.</p>
</script>