m (1 revision) |
|||
Ligne 1 : | Ligne 1 : | ||
= CLC= | = CLC= | ||
<onlyinclude> | <onlyinclude> | ||
− | + | Le fichier d'entrée doit être au format JSONObject et comprendre les paramètres de définition de solution d'un profil spécifique. Le fichier doit être codé au format UTF-8. | |
<verttabber> | <verttabber> | ||
− | + | chaîne= | |
− | + | La structure d'entrée du type « chaîne » est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : "chaîne" |
} | } | ||
} | } | ||
</source><br> | </source><br> | ||
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
Ligne 22 : | Ligne 22 : | ||
<dialog step="Step1"> | <dialog step="Step1"> | ||
<input name="NAME_PARAM1" title="PERSON NAME" default="birit" type="string" required="true"> | <input name="NAME_PARAM1" title="PERSON NAME" default="birit" type="string" required="true"> | ||
− | <description> | + | <description>Entrez le nom de la personne</description> |
</input> | </input> | ||
</dialog> | </dialog> | ||
<dialog step="Step2"> | <dialog step="Step2"> | ||
<input name="NAME_PARAM2" title="PERSON NAME" default="birit" type="string" required="true"> | <input name="NAME_PARAM2" title="PERSON NAME" default="birit" type="string" required="true"> | ||
− | <description> | + | <description>Entrez le nom de la personne</description> |
</input> | </input> | ||
</dialog> | </dialog> | ||
Ligne 38 : | Ligne 38 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier d'entrée du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Etape 1" : { |
"NAME_PARAM1" : "Kate" | "NAME_PARAM1" : "Kate" | ||
}, | }, | ||
− | " | + | "Etape 2" : { |
"NAME_PARAM2" : "John" | "NAME_PARAM2" : "John" | ||
} | } | ||
Ligne 51 : | Ligne 51 : | ||
|-| | |-| | ||
− | + | Booléen= | |
− | + | La structure d'entrée du type « booléen » est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : vrai/faux |
} | } | ||
} | } | ||
</source><br> | </source><br> | ||
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<profile name="Install"> | <profile name="Install"> | ||
<dialog step="Step1"> | <dialog step="Step1"> | ||
<input name="STATUS" title="status" type="boolean" required="true"> | <input name="STATUS" title="status" type="boolean" required="true"> | ||
− | <description> | + | <description>champ d'état</description> |
</input> | </input> | ||
</dialog> | </dialog> | ||
Ligne 79 : | Ligne 79 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier d'entrée du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Etape1" : { |
− | " | + | "ETAT" : vrai |
} | } | ||
} | } | ||
Ligne 89 : | Ligne 89 : | ||
|-| | |-| | ||
− | + | Entier= | |
− | + | La structure d'entrée du type « entier » est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : <integer> |
} | } | ||
} | } | ||
</source><br> | </source><br> | ||
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<profile name="Install"> | <profile name="Install"> | ||
<dialog step="Step1"> | <dialog step="Step1"> | ||
<input name="NUMBER" title="number" type="integer" required="true"> | <input name="NUMBER" title="number" type="integer" required="true"> | ||
− | <description> | + | <description>champ de numéro</description> |
</input> | </input> | ||
</dialog> | </dialog> | ||
Ligne 117 : | Ligne 117 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier d'entrée du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Etape 1" : { |
− | " | + | "NOMBRE" : 132 |
} | } | ||
} | } | ||
Ligne 127 : | Ligne 127 : | ||
|-| | |-| | ||
− | + | Mot de passe= | |
− | + | La structure d'entrée du type « mot de passe » est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : "mot de passe" |
} | } | ||
} | } | ||
</source><br> | </source><br> | ||
− | {{NoteFormat| | + | {{NoteFormat|Les fichiers d'entrée comprenant des données sensibles comme des mots de passe doivent être cryptés à l'aide d'une opération de chiffrement SPD.}} |
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<profile name="Install"> | <profile name="Install"> | ||
<dialog step="Step1"> | <dialog step="Step1"> | ||
<input name="PASSWORD" title="password" type="password" required="true"> | <input name="PASSWORD" title="password" type="password" required="true"> | ||
− | <description> | + | <description>champ de mot de passe</description> |
</input> | </input> | ||
</dialog> | </dialog> | ||
Ligne 157 : | Ligne 157 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Etape 1" : { |
− | " | + | "MOT DE PASSE" : "xyz9846gdkjg" |
} | } | ||
} | } | ||
Ligne 167 : | Ligne 167 : | ||
|-| | |-| | ||
− | + | Sélection unique= | |
− | + | La structure d'entrée du type « sélection unique » avec une balise '''<objectselect>''' est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : { |
− | " | + | "sélection d'objet" : { |
− | " | + | "filtre" : [{ |
− | " | + | "valeur" : "valeur du filtre", |
− | " | + | "nom" : "nom du filtre" |
} | } | ||
] | ] | ||
Ligne 185 : | Ligne 185 : | ||
</source><br> | </source><br> | ||
− | {{NoteFormat|CLC | + | {{NoteFormat|CLC croise les filtres (« ET ») définis dans le fichier SPD et le fichier d'entrée de l'entrée « sélection unique ». Les critères de filtre doivent être différents dans le fichier d'entrée SPD et les noms des filtres doivent être différents dans la même définition de filtre.}} |
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<profile name="Install"> | <profile name="Install"> | ||
<dialog step="Step1"> | <dialog step="Step1"> | ||
<input name="APP_OBJ_SELECT_ONE" title="Application Name" hidden="false" type="selectOne" default=""> | <input name="APP_OBJ_SELECT_ONE" title="Application Name" hidden="false" type="selectOne" default=""> | ||
− | <description> | + | <description>sélectionner l'application</description> |
<objectselect> | <objectselect> | ||
<filter value="CfgApplication" name="type"/> | <filter value="CfgApplication" name="type"/> | ||
Ligne 208 : | Ligne 208 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier d'entrée du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Etape 1" : { |
"APP_OBJ_SELECT_ONE" : { | "APP_OBJ_SELECT_ONE" : { | ||
− | " | + | "sélection d'objet" : { |
− | " | + | "filtre" : [{ |
− | " | + | "valeur" : "SIP_lrm26", |
− | " | + | "nom" : "nom" |
} | } | ||
] | ] | ||
Ligne 226 : | Ligne 226 : | ||
|-| | |-| | ||
− | + | Sélection multiple= | |
− | + | La structure d'entrée du type « sélection multiple » avec une balise '''<objectselect>''' est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : { |
− | " | + | "sélection d'objet" : { |
− | " | + | "filtre" : [{ |
− | " | + | "valeur" : "valeur du filtre", |
− | " | + | "nom" : "nom du filtre" |
} | } | ||
] | ] | ||
Ligne 244 : | Ligne 244 : | ||
</source><br> | </source><br> | ||
− | + | Les filtres définis dans un fichier d'entrée SPD sont associés (« OU ») puis croisés (« ET ») avec les filtres définis dans un fichier SPD d'une entrée de type « sélection multiple ». | |
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<profile name="Install"> | <profile name="Install"> | ||
<dialog step="Step1"> | <dialog step="Step1"> | ||
<input name="APP_OBJ_SELECT_MULTIPLE" title="Application Name" hidden="false" type="selectMultiple" default=""> | <input name="APP_OBJ_SELECT_MULTIPLE" title="Application Name" hidden="false" type="selectMultiple" default=""> | ||
− | <description> | + | <description>sélectionner l'application</description> |
<objectselect> | <objectselect> | ||
<filter value="CfgApplication" name="type"/> | <filter value="CfgApplication" name="type"/> | ||
Ligne 267 : | Ligne 267 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier d'entrée du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Etape 1" : { |
"APP_OBJ_SELECT_MULTIPLE" : { | "APP_OBJ_SELECT_MULTIPLE" : { | ||
− | " | + | "sélection d'objet" : { |
− | " | + | "filtre" : [{ |
− | " | + | "valeur" : "SIP_lrm26", |
− | " | + | "nom" : "nom" |
},{ | },{ | ||
− | " | + | "valeur" : "SIP_lrm27", |
− | " | + | "nom" : "nom" |
} | } | ||
] | ] | ||
Ligne 287 : | Ligne 287 : | ||
</source><br> | </source><br> | ||
− | + | L'opération renvoie deux applications nommées '''SIP_lrm26''' et '''SIP_lrm27'''. | |
|-| | |-| | ||
− | + | Balise de sélection= | |
− | + | La structure d'entrée du type « sélection unique/sélection multiple/booléen » avec une balise '''<selection>''' est décrite ci-après : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Boîte de dialogue" : { |
− | " | + | "Nom d'entrée" : { |
− | " | + | "sélection" : { |
"option" : [{ | "option" : [{ | ||
− | " | + | "valeur" : "valeur de l'option attribuée au paramètre d'entrée", |
− | " | + | "nom" : "nom de l'option affiché dans l'interface utilisateur" |
} | } | ||
] | ] | ||
Ligne 308 : | Ligne 308 : | ||
</source><br> | </source><br> | ||
− | CLC | + | CLC sélectionne les options définies dans le fichier d'entrée SPD. Il n'est possible de spécifier plusieurs options que pour le type d'entrée « sélection multiple ». |
− | ==== | + | ====Exemple==== |
− | =====SPD | + | =====Profil SPD===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<profile name="Install"> | <profile name="Install"> | ||
<dialog step="Application Parameters"> | <dialog step="Application Parameters"> | ||
<input name="DATA_MODEL" title="Binary Version (32-bit or 64-bit)" default="64" type="selectOne" required="true"> | <input name="DATA_MODEL" title="Binary Version (32-bit or 64-bit)" default="64" type="selectOne" required="true"> | ||
− | <description> | + | <description>Ce paramètre définit la version 32 ou 64 bits du programme binaire à déployer. </description> |
<selection> | <selection> | ||
<option name="32" value="32"/> | <option name="32" value="32"/> | ||
Ligne 332 : | Ligne 332 : | ||
</source><br> | </source><br> | ||
− | ===== | + | =====Fichier d'entrée du profil d'installation===== |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
{ | { | ||
− | " | + | "Paramètres de l'application" : { |
− | " | + | "MODELE_DONNEES" : { |
− | " | + | "sélection" : { |
"option" : [{ | "option" : [{ | ||
− | " | + | "valeur" : "64", |
− | " | + | "nom" : "64" |
} | } | ||
] | ] | ||
Ligne 352 : | Ligne 352 : | ||
{{NoteFormat| | {{NoteFormat| | ||
<ul> | <ul> | ||
− | <li> | + | <li>Si le fichier d'entrée ne contient pas de valeur pour un paramètre de définition de solution, la valeur définie dans l'attribut '''par défaut''' de l'élément d'entrée est utilisée.</li> |
− | <li> | + | <li>Si l'attribut '''requis''' d'un élément d'entrée de la définition de solution est défini sur <tt>vrai</tt> en l'absence de valeur d'entrée correspondante dans la définition de solution (valeur par défaut) ou dans le fichier d'entrée, l'exécution de la définition de solution échoue.</li> |
− | <li> | + | <li>Si la valeur de l'attribut '''lecture seule''' d'un élément d'entrée de définition de solution est défini sur <tt>vrai</tt>, la valeur de l'attribut '''par défaut''' est utilisée pour l'exécution si elle est définie. |
− | + | Si la valeur de l'attribut '''lecture seule''' est définie sur vrai, la valeur '''requis''' est définie sur <tt>faux</tt> et que l'attribut '''par défaut''' n'est pas défini, la logique suivante est appliquée pour déterminer la valeur d'entrée : | |
<ol> | <ol> | ||
− | <li> | + | <li>Avec un type d'entrée « booléen », la valeur d'entrée est définie sur <tt>faux</tt>.</li> |
− | <li> | + | <li>Avec les types d'entrée « chaîne » et « mot de passe », la valeur d'entrée est définie sur <tt>""</tt>.</li> |
− | <li> | + | <li>Avec le type d'entrée « nombre entier », l'entrée n'est pas propagée.</li> |
</ol></li> | </ol></li> | ||
− | <li> | + | <li>Si la valeur de l'attribut '''cond''' d'une boîte de dialogue est définie sur faux, cette boîte de dialogue est ignorée par l'outil CLC. |
− | + | Exemple : | |
<source lang="xml" enclose="div"> | <source lang="xml" enclose="div"> | ||
<dialog step="Role input" cond="false"> | <dialog step="Role input" cond="false"> | ||
<input name="ROLE" title="Role" hidden="false" type="selectOne" required="true"> | <input name="ROLE" title="Role" hidden="false" type="selectOne" required="true"> | ||
− | <description> | + | <description>Indiquez le rôle</description> |
<objectselect> | <objectselect> | ||
<filter value="CfgRole" name="type"/> | <filter value="CfgRole" name="type"/> |
Version du juillet 8, 2015 à 19:38
CLC
Le fichier d'entrée doit être au format JSONObject et comprendre les paramètres de définition de solution d'un profil spécifique. Le fichier doit être codé au format UTF-8.
La structure d'entrée du type « chaîne » est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : "chaîne"
}
}
Exemple
Profil SPD
<profile name="Install">
<dialog step="Step1">
<input name="NAME_PARAM1" title="PERSON NAME" default="birit" type="string" required="true">
<description>Entrez le nom de la personne</description>
</input>
</dialog>
<dialog step="Step2">
<input name="NAME_PARAM2" title="PERSON NAME" default="birit" type="string" required="true">
<description>Entrez le nom de la personne</description>
</input>
</dialog>
<execution>
<script>
log('string test' );
</script>
</execution>
</profile>
Fichier d'entrée du profil d'installation
{
"Etape 1" : {
"NAME_PARAM1" : "Kate"
},
"Etape 2" : {
"NAME_PARAM2" : "John"
}
}
La structure d'entrée du type « booléen » est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : vrai/faux
}
}
Exemple
Profil SPD
<profile name="Install">
<dialog step="Step1">
<input name="STATUS" title="status" type="boolean" required="true">
<description>champ d'état</description>
</input>
</dialog>
<execution>
<script>
log('boolean test');
</script>
</execution>
</profile>
Fichier d'entrée du profil d'installation
{
"Etape1" : {
"ETAT" : vrai
}
}
La structure d'entrée du type « entier » est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : <integer>
}
}
Exemple
Profil SPD
<profile name="Install">
<dialog step="Step1">
<input name="NUMBER" title="number" type="integer" required="true">
<description>champ de numéro</description>
</input>
</dialog>
<execution>
<script>
log('number test');
</script>
</execution>
</profile>
Fichier d'entrée du profil d'installation
{
"Etape 1" : {
"NOMBRE" : 132
}
}
La structure d'entrée du type « mot de passe » est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : "mot de passe"
}
}
Exemple
Profil SPD
<profile name="Install">
<dialog step="Step1">
<input name="PASSWORD" title="password" type="password" required="true">
<description>champ de mot de passe</description>
</input>
</dialog>
<execution>
<script>
log('password test');
</script>
</execution>
</profile>
Fichier du profil d'installation
{
"Etape 1" : {
"MOT DE PASSE" : "xyz9846gdkjg"
}
}
La structure d'entrée du type « sélection unique » avec une balise <objectselect> est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : {
"sélection d'objet" : {
"filtre" : [{
"valeur" : "valeur du filtre",
"nom" : "nom du filtre"
}
]
}
}
}
}
Exemple
Profil SPD
<profile name="Install">
<dialog step="Step1">
<input name="APP_OBJ_SELECT_ONE" title="Application Name" hidden="false" type="selectOne" default="">
<description>sélectionner l'application</description>
<objectselect>
<filter value="CfgApplication" name="type"/>
</objectselect>
</input>
</dialog>
<execution>
<script>
log('test select one' );
</script>
</execution>
Fichier d'entrée du profil d'installation
{
"Etape 1" : {
"APP_OBJ_SELECT_ONE" : {
"sélection d'objet" : {
"filtre" : [{
"valeur" : "SIP_lrm26",
"nom" : "nom"
}
]
}
}
}
}
La structure d'entrée du type « sélection multiple » avec une balise <objectselect> est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : {
"sélection d'objet" : {
"filtre" : [{
"valeur" : "valeur du filtre",
"nom" : "nom du filtre"
}
]
}
}
}
}
Les filtres définis dans un fichier d'entrée SPD sont associés (« OU ») puis croisés (« ET ») avec les filtres définis dans un fichier SPD d'une entrée de type « sélection multiple ».
Exemple
Profil SPD
<profile name="Install">
<dialog step="Step1">
<input name="APP_OBJ_SELECT_MULTIPLE" title="Application Name" hidden="false" type="selectMultiple" default="">
<description>sélectionner l'application</description>
<objectselect>
<filter value="CfgApplication" name="type"/>
</objectselect>
</input>
</dialog>
<execution>
<script>
log('test select multiple' );
</script>
</execution>
Fichier d'entrée du profil d'installation
{
"Etape 1" : {
"APP_OBJ_SELECT_MULTIPLE" : {
"sélection d'objet" : {
"filtre" : [{
"valeur" : "SIP_lrm26",
"nom" : "nom"
},{
"valeur" : "SIP_lrm27",
"nom" : "nom"
}
]
}
}
}
}
L'opération renvoie deux applications nommées SIP_lrm26 et SIP_lrm27.
La structure d'entrée du type « sélection unique/sélection multiple/booléen » avec une balise <selection> est décrite ci-après :
{
"Boîte de dialogue" : {
"Nom d'entrée" : {
"sélection" : {
"option" : [{
"valeur" : "valeur de l'option attribuée au paramètre d'entrée",
"nom" : "nom de l'option affiché dans l'interface utilisateur"
}
]
}
}
}
}
CLC sélectionne les options définies dans le fichier d'entrée SPD. Il n'est possible de spécifier plusieurs options que pour le type d'entrée « sélection multiple ».
Exemple
Profil SPD
<profile name="Install">
<dialog step="Application Parameters">
<input name="DATA_MODEL" title="Binary Version (32-bit or 64-bit)" default="64" type="selectOne" required="true">
<description>Ce paramètre définit la version 32 ou 64 bits du programme binaire à déployer. </description>
<selection>
<option name="32" value="32"/>
<option name="64" value="64"/>
</selection>
</input>
</dialog>
<execution>
<script>
log('test selection support' );
</script>
</execution>
Fichier d'entrée du profil d'installation
{
"Paramètres de l'application" : {
"MODELE_DONNEES" : {
"sélection" : {
"option" : [{
"valeur" : "64",
"nom" : "64"
}
]
}
}
}
}
- Si le fichier d'entrée ne contient pas de valeur pour un paramètre de définition de solution, la valeur définie dans l'attribut par défaut de l'élément d'entrée est utilisée.
- Si l'attribut requis d'un élément d'entrée de la définition de solution est défini sur vrai en l'absence de valeur d'entrée correspondante dans la définition de solution (valeur par défaut) ou dans le fichier d'entrée, l'exécution de la définition de solution échoue.
- Si la valeur de l'attribut lecture seule d'un élément d'entrée de définition de solution est défini sur vrai, la valeur de l'attribut par défaut est utilisée pour l'exécution si elle est définie.
Si la valeur de l'attribut lecture seule est définie sur vrai, la valeur requis est définie sur faux et que l'attribut par défaut n'est pas défini, la logique suivante est appliquée pour déterminer la valeur d'entrée :
- Avec un type d'entrée « booléen », la valeur d'entrée est définie sur faux.
- Avec les types d'entrée « chaîne » et « mot de passe », la valeur d'entrée est définie sur "".
- Avec le type d'entrée « nombre entier », l'entrée n'est pas propagée.
- Si la valeur de l'attribut cond d'une boîte de dialogue est définie sur faux, cette boîte de dialogue est ignorée par l'outil CLC.
Exemple :
<dialog step="Role input" cond="false"> <input name="ROLE" title="Role" hidden="false" type="selectOne" required="true"> <description>Indiquez le rôle</description> <objectselect> <filter value="CfgRole" name="type"/> </objectselect> </input> </dialog>