2024-09-17 23:03:00 +02:00

55 lines
3.7 KiB
HTML

<!--
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>Konvertuje reťazec vo formáte CSV na reprezentáciu objektu JavaScript a naopak.</p>
<h3>Vstupy</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objekt | pole | reťazec znakov</span></dt>
<dd>JavaScript objekt, pole alebo CSV reťazec.</dd>
</dl>
<h3>Výstupy</h3>
<dl class="message-properties">
<dt>payload<span class="property-type">objekt | pole | reťazec znakov</span></dt>
<dd>
<ul>
<li>Ak je vstup reťazec, uzol sa pokúsi ho analyzovať ako CSV a vytvorí JavaScript objekt s dvojicami kľúč/hodnota pre každý riadok.
Uzol potom odošle buď jednu správu pre každý riadok, alebo jednu správu obsahujúcu pole objektov.</li>
<li>Ak je vstup JavaScript objekt, uzol sa pokúsi vytvoriť reťazec CSV.</li>
<li>Ak je vstup pole jednoduchých hodnôt, uzol vytvorí reťazec CSV na jednom riadku.</li>
<li>Ak je vstup pole polí alebo pole objektov, vytvorí sa viacriadkový reťazec CSV.</li>
</ul>
</dd>
</dl>
<h3>Detaily</h3>
<p>Model stĺpcov môže obsahovať usporiadaný zoznam názvov stĺpcov. Pri konverzii z CSV na objekt budú názvy stĺpcov
použité ako názvy vlastností. Alternatívne môžu byť názvy stĺpcov prevzaté z prvého riadku CSV.
<p>Keď je vybraný analyzátor RFC, model stĺpcov musí byť v súlade so štandardom RFC4180.</p>
</p>
<p>Pri konverzii do formátu CSV sa model stĺpcov používa na identifikáciu vlastností na extrakciu z objektu a v akom poradí.</p>
<p>Ak je model stĺpcov prázdny, môžete použiť jednoduchý zoznam vlastností oddelených čiarkami poskytnutý v <code>msg.columns</code>, aby ste
určili čo extrahovať a v akom poradí. Ak nie prítomné ani jeden ani druhý, všetky vlastnosti objektu výstupom v poradí
v akom sa nachádzajú v prvom riadku.</p>
<p>Ak je vstup pole, model stĺpcov sa používa len na prípadné generovanie riadku s názvami stĺpcov.</p>
<p>Ak je začiarknutá možnosť 'analyzovať číselné hodnoty', číselné hodnoty z reťazca budú vrátené ako čísla.</p>
<p>Ak je začiarknutá možnosť 'zahrnúť prázdne reťazce', prázdne reťazce budú zahrnuté vo výsledku.</p>
<p>Ak je začiarknutá možnosť 'zahrnúť nulové hodnoty', nulové hodnoty budú zahrnuté vo výsledku.</p>
<p>Uzol môže prijať viacdielny vstup pokiaľ je vlastnosť <code>parts</code> správne definovaná, napríklad z uzla vstupného súboru alebo uzla rozdelenia.</p>
<p>Ak produkujete viacero správ, ich vlastnosť <code>parts</code> bude definovaná a vytvorí úplnú sekvenciu správ.</p>
<p>Ak je uzol nakonfigurovaný tak, aby odoslal hlavičky stĺpcov len raz, nastavenie hodnoty na <code>msg.reset</code> spôsobí opätovné odoslanie hlavičiek uzlom.</p>
<p><b>Poznámka</b>: model stĺpcov musí byť oddelený čiarkami aj keď bol pre údaje vybraný iný oddeľovač.</p>
</script>