Projet

Général

Profil

0001-help-shuffle-api-fill.page-for-better-formatting-324.patch

Frédéric Péters, 18 avril 2019 09:12

Télécharger (6,4 ko)

Voir les différences:

Subject: [PATCH] help: shuffle api-fill.page for better formatting (#32434)

 help/fr/api-fill.page | 210 ++++++++++++++++++++++--------------------
 1 file changed, 110 insertions(+), 100 deletions(-)
help/fr/api-fill.page
48 48

  
49 49
  <item>
50 50
  <p>
51
   Les champs de type « Liste » acceptent différentes valeurs selon leur
52
   configuration.
51
   Les champs de type « Liste » et « Liste à choix multiples » acceptent
52
   différentes valeurs selon leur configuration, ceci est décrit dans
53
   <link xref="#fill-list"/>.
53 54
  </p>
54
  <terms>
55
    <item>
56
    <title>liste simple</title>
57
    <p>La valeur doit être une chaîne tirée de la liste.</p>
58
    <listing>
59
    <code>
60
    "data": {
61
       "<var>varname</var>": "Libellé 1",
62
    }
63
    </code>
64
    </listing>
65
    </item>
66
    <item>
67
    <title>source de donnée</title>
68
    <p>La valeur peut être l'identifiant d'une donnée structurée ou si la
69
    donnée structurée complète est transmise, l'identifiant de la donnée dans
70
    une clé suffixée de <code>_raw</code>, le libellé de la donnée dans la clé
71
    normale et éventuellement la donnée structurée complète dans une clé
72
    suffixée de <code>_structured</code></p>
73
    <listing>
74
    <code>
75
    "data": {
76
       "<var>varname</var>": "1"
77
    }
78
    </code>
79
    </listing>
80
    <listing>
81
    <code>
82
    "data": {
83
       "<var>varname</var>": "Libellé 1",
84
       "<var>varname</var>_raw": "1",
85
       "<var>varname</var>_structured": {
86
          "id": "1",
87
          "text": "Libellé 1",
88
          "foo": "bar"
89
       }
90
    }
91
    </code>
92
    </listing>
93
    </item>
94
  </terms>
95
  </item>
96

  
97

  
98
  <item>
99
  <p>
100
   Les champs de type « Liste à choix multiple » acceptent différentes valeurs
101
   selon leur configuration.
102
  </p>
103
  <terms>
104
    <item>
105
    <title>liste simple</title>
106
    <p>La valeur doit être une liste de chaînes tirée de la liste.</p>
107
    <listing>
108
    <code>
109
    "data": {
110
       "<var>varname</var>": ["Libellé 1", "Libellé 2"],
111
    }
112
    </code>
113
    </listing>
114
    </item>
115
    <item>
116
    <title>source de donnée</title>
117
    <p>La valeur peut être une liste d'identifiants d'une donnée structurée ou
118
    si la donnée structurée complète est transmise, la liste des identifiants
119
    de la donnée dans une clé suffixée de <code>_raw</code>, la liste des
120
    libellés de la donnée dans la clé normale et éventuellement la liste des
121
    données structurées complètes dans une clé suffixée de
122
    <code>_structured</code></p>
123
    <listing>
124
    <code>
125
    "data": {
126
       "<var>varname</var>": ["1", "2"]
127
    }
128
    </code>
129
    </listing>
130
    <listing>
131
    <code>
132
    "data": {
133
       "<var>varname</var>": ["Libellé 1", "Libellé 2"],
134
       "<var>varname</var>_raw": ["1", "2"],
135
       "<var>varname</var>_structured": [
136
         {
137
            "id": "1",
138
            "text": "Libellé 1",
139
            "foo": "bar"
140
         },
141
         {
142
            "id": "2",
143
            "text": "Libellé 2",
144
            "foo": "bar2"
145
         }
146
       ]
147
    }
148
    </code>
149
    </listing>
150
    </item>
151
  </terms>
152 55
  </item>
153 56

  
154 57
  <item>
......
274 177

  
275 178
</section>
276 179

  
180
<section id="fill-list">
181
  <title>Transmission des champs « Liste » et « Liste à choix multiple »</title>
182

  
183
  <p>
184
   Pour les champs de type « Liste », si le champ est configuré avec une simple
185
   liste d'options, la valeur doit être une chaîne tirée de la liste.
186
  </p>
187

  
188
   <listing>
189
    <code>
190
    "data": {
191
       "<var>varname</var>": "Libellé 1",
192
    }
193
    </code>
194
   </listing>
195

  
196
   <p>
197
    Si le champ est configuré pour tirer ses options depuis une source de
198
    données, la valeur peut être l'identifiant d'une donnée structurée ou si la
199
    donnée structurée complète est transmise, l'identifiant de la donnée dans
200
    une clé suffixée de <code>_raw</code>, le libellé de la donnée dans la clé
201
    normale et éventuellement la donnée structurée complète dans une clé
202
    suffixée de <code>_structured</code>.
203
   </p>
204

  
205
    <listing>
206
    <title>Identifiant d'une option</title>
207
    <code>
208
    "data": {
209
       "<var>varname</var>": "1"
210
    }
211
    </code>
212
    </listing>
213

  
214
    <listing>
215
    <title>Donnée structurée</title>
216
    <code>
217
    "data": {
218
       "<var>varname</var>": "Libellé 1",
219
       "<var>varname</var>_raw": "1",
220
       "<var>varname</var>_structured": {
221
          "id": "1",
222
          "text": "Libellé 1",
223
          "foo": "bar"
224
       }
225
    }
226
    </code>
227
    </listing>
228

  
229

  
230
  <p>
231
   Pour les champs de type « Liste à choix multiple », si le champ est
232
   configuré avec une simple liste d'options, la valeur doit être une
233
   liste de chaînes tirées de la liste.
234
   </p>
235

  
236
    <listing>
237
    <code>
238
    "data": {
239
       "<var>varname</var>": ["Libellé 1", "Libellé 2"],
240
    }
241
    </code>
242
    </listing>
243

  
244
   <p>
245
    Si le champ est configuré pour tirer ses options depuis une source de
246
    données, la valeur peut être une liste d'identifiants ou,
247
    si la donnée structurée complète est transmise, la liste des identifiants
248
    de la donnée dans une clé suffixée de <code>_raw</code>, la liste des
249
    libellés de la donnée dans la clé normale et éventuellement la liste des
250
    données structurées complètes dans une clé suffixée de
251
    <code>_structured</code>.
252
   </p>
253

  
254
    <listing>
255
    <title>Liste d'identifiants d'options</title>
256
    <code>
257
    "data": {
258
       "<var>varname</var>": ["1", "2"]
259
    }
260
    </code>
261
    </listing>
262

  
263
    <listing>
264
    <title>Listes de données structurées</title>
265
    <code>
266
    "data": {
267
       "<var>varname</var>": ["Libellé 1", "Libellé 2"],
268
       "<var>varname</var>_raw": ["1", "2"],
269
       "<var>varname</var>_structured": [
270
         {
271
            "id": "1",
272
            "text": "Libellé 1",
273
            "foo": "bar"
274
         },
275
         {
276
            "id": "2",
277
            "text": "Libellé 2",
278
            "foo": "bar2"
279
         }
280
       ]
281
    }
282
    </code>
283
    </listing>
284

  
285
</section>
286

  
277 287
</page>
278
-