You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/fr_FR/changelog.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,12 @@
8
8
9
9
- Support des images d'équipement personnalisées (Jeedom 4.5)
10
10
11
+
# xx/07/2025
12
+
13
+
- Correction de l'erreur d'affichage des options pour un type "HTTP" lors de la création d'une commande alors que le type "script" est sélectionné à ce moment.
14
+
- Traitement différent pour les commandes de type Script : le forçage de l'interpréteur selon une règle propre au plugin et qui est incompatible avec certains systèmes (python3 sous Debian 11+) est conditionné afin que le script soit lancé comme s'il l'était dans un shell sauf si le forçage de l'interpréteur est nécessaire.
15
+
- Mise à jour de la documentation et petites corrections de celle-ci
Copy file name to clipboardExpand all lines: docs/fr_FR/index.md
+18-17Lines changed: 18 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,21 +38,23 @@ Vous retrouvez ici la liste des commandes :
38
38
-**Nom** : Ce champ contient le nom que vous souhaitez donner à votre commande/information.
39
39
-**Icône** : Ce champ permet d’associer une icône à votre nom (dans ce cas Jeedom remplace le nom par l’icône dans le Dashboard).
40
40
-**Type de script** :
41
-
- Le type **http** : permet d’envoyer une requête vers un équipement externe sans forcément attendre un retour de cette commande. L’exemple qui servira de support au type http sera la configuration d’une requête vers une Vera pour allumer une lumière.
42
41
- Le type **script** : sert principalement à lancer des scripts internes à Jeedom. L’exemple qui servira de support au type script sera la configuration du script de monitoring température du raspberry.
42
+
- Le type **http** : permet d’envoyer une requête vers un équipement externe sans forcément attendre un retour de cette commande. L’exemple qui servira de support au type http sera la configuration d’une requête vers une Vera pour allumer une lumière.
43
43
- Le type **XML** : permet de rapatrier des informations encodées en XML depuis un équipement distant. L’exemple qui servira de support au type XML sera la configuration du script pour interroger un Eco-Device.
44
44
- Le type **JSON** : permet de rapatrier des informations encodées en JSON depuis un équipement distant. L’exemple qui servira de support au type JSON sera la configuration du script pour interroger Sickbeard (ou XBMC).
45
45
-**le type** et le **sous-type**
46
46
- Le champ **requête**
47
-
- Ce champ doit contenir la requête en elle-même, ou le chemin du script si le champ "type de script" est script. Le bouton "parcourir" : permet de sélectionner le fichier contenu dans le dossier interne à Jeedom.
47
+
- Ce champ doit contenir la requête en elle-même, ou le chemin du script si le champ "type de script" est script. Le bouton "parcourir" permet de sélectionner le fichier contenu dans le dossier interne à Jeedom.
48
48
49
-
> Ce dossier est accessible en SSH dans ``/var/www/html/plugins/script/data/``. Pour info, la commande SSH pour attribuer les droits ``www-data`` à un fichier est : ``sudo chown www-data:www-data NOMDUSCRIPT.EXTENSION``. A savoir que pour exécuter un script, celui-ci doit avoir les droits www-data.
49
+
> Ce dossier est accessible en SSH dans ``/var/www/html/plugins/script/data/``. Pour info, la commande SSH pour que ``www-data`` soit le propriétaire d'un fichier est : ``sudo chown www-data:www-data NOMDUSCRIPT.EXTENSION``. A savoir que pour exécuter un script, celui-ci doit appartenir à ``www-data``.
50
50
51
51
- Le bouton **Editer** : permet d’éditer à l’aide d’un éditeur de code interne un des fichiers contenus dans le répertoire permettant l’accès au code du fichier.
52
52
- Le bouton **Nouveau** : permet de créer un fichier de commande.
53
53
54
-
> Ne pas oublier de saisir le nom du fichier ainsi que son extension complète sous peine de voir votre superbe script ne pas fonctionner. Sans extension Jeedom ne saura pas reconnaître le langage associé à votre fichier. CF : Généralité
54
+
> Ne pas oublier de saisir le nom du fichier ainsi que son extension complète sous peine de voir votre superbe script ne pas fonctionner. Sans extension Jeedom ne saura pas reconnaître le langage associé à votre fichier. Il est possible de contourner ce fonctionnement en précisant l'interpréteur dans la ligne shebang ou en plaçant l'interpréteur en première position de la ligne de commande, ce point est détaillé plus loin.
55
+
55
56
- Le bouton **Supprimer** : permet de supprimer un fichier de commande.
57
+
56
58
- Le champ **Options** : Champ avec des options variables suivant le choix du type de script.
57
59
-**unité** : unité de la donnée (peut être vide).
58
60
-**min/max** : bornes de la donnée (peuvent être vides).
@@ -61,11 +63,13 @@ Vous retrouvez ici la liste des commandes :
61
63
62
64
> **Important**
63
65
>
64
-
> Il faut éviter, autant que possible, dans le chemin du script ou dans les paramètres de celui-ci les caractères spéciaux. Les caractères autorisés étant : les chiffres, les lettres (majuscule ou minuscule)
66
+
> Il faut éviter les caractères spéciaux, autant que possible, dans le chemin du script ou dans les paramètres de celui-ci. Les caractères autorisés étant : les chiffres, les lettres (majuscule ou minuscule)
65
67
66
68
> **Important**
67
69
>
68
-
> Vous pouvez dans le champs requete (pour http, json, xml) mettre du json, il faut juste le faire preceder de `json::`, exemple `json::{"clef":"valeur"}`
70
+
> Dans le champs requête (pour http, json, xml), vous pouvez mettre du json, il faut juste le faire précéder de `json::`, exemple `json::{"clef":"valeur"}`
71
+
72
+
# Le choix HTTP
69
73
70
74

71
75
@@ -190,27 +194,24 @@ Action : Lancez le script, via un équipement virtuel, lié à votre script !
190
194
191
195
Le plus sympa mais pas le plus simple à expliquer.
192
196
193
-
**Prérequis : savoir développer un script en php, python, perl ou ruby.**
197
+
**Prérequis : savoir développer un script**
194
198
195
199
>**IMPORTANT**
196
200
>
197
-
> L'extension de votre script doit absolument correspondre à son type. En effet Jeedom se base sur l'extension du script pour l'exécutable à lancer
198
-
>
199
-
> Si le nom de votre fichier ne contient pas :
200
-
>
201
-
> - .php .py .pl .rb
202
-
>
201
+
> - Si le script en première position de la ligne de commande contient une ligne shebang, le plugin script lancera un shell qui l’exécutera en se basant sur la directive de la 1ère ligne (shebang).
202
+
> - Si le premier élément de la ligne de commande est un exécutable reconnu par le système, par exemple `/usr/bin/python3`, le plugin script lancera un shell qui exécutera cette ligne de commande.
203
+
> - Si le script en première position de la ligne de commande ne contient pas de ligne shebang ET que le premier élément de la ligne de commande n'est pas un exécutable reconnu par le système, l'extension de votre script doit absolument correspondre à son type. En effet le plugin script se base alors sur l'extension du script pour l'exécutable à lancer.
203
204
204
-
Le plugin script lancera un shell qui l’exécutera en se basant sur la directive de la 1ère ligne ( shebang ).
205
-
Exemple :
205
+
Dans ce dernier cas, si le nom de votre fichier ne termine pas par .php .py .pl ou .rb, le plugin script lancera un shell qui l’exécutera comme en ligne de commande.
206
206
207
-
```bash
207
+
Exemples de ligne shebang :
208
+
209
+
```
208
210
#!/bin/csh -f
209
211
#!/bin/ksh
210
212
#!/usr/bin/env python3
211
213
#!/usr/bin/env php
212
214
#!/usr/bin/env node
213
-
etc ...
214
215
```
215
216
216
217
Le script de monitoring température du Raspberry va servir d’exemple pour l’utilisation du type de script : Script
0 commit comments