mirror of https://github.com/node-red/node-red.git
50 lines
3.7 KiB
HTML
50 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>Converte entre uma cadeia de caracteres formatada em CSV e sua representação de objeto JavaScript, em qualquer direção.</p>
|
|
<h3>Entradas</h3>
|
|
<dl class="message-properties">
|
|
<dt>carga útil <span class="property-type"> objeto | matriz | cadeia de caracteres</span></dt>
|
|
<dd>Um objeto JavaScript, matriz ou cadeia de caracteres CSV.</dd>
|
|
</dl>
|
|
<h3>Saídas</h3>
|
|
<dl class="message-properties">
|
|
<dt>carga útil <span class="property-type"> objeto | matriz | cadeia de caractere </span></dt>
|
|
<dd>
|
|
<ul>
|
|
<li>Se a entrada for uma cadeia de caracteres, tenta analisá-la sintaticamente como CSV e cria um objeto JavaScript de pares chave/valor para cada linha. O nó enviará então uma mensagem para cada linha, ou uma única mensagem contendo uma matriz de objetos.</li>
|
|
<li>Se a entrada for um objeto JavaScript, ela tenta construir uma cadeia de caracteres CSV.</li>
|
|
<li>Se a entrada for uma matriz de valores simples, ela cria uma cadeia de caracteres CSV de linha única.</li>
|
|
<li>Se a entrada for uma matriz de matrizes ou de objetos, uma cadeia de caracteres CSV de várias linhas é criada.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<h3>Detalhes</h3>
|
|
<p>O modelo de coluna pode conter uma lista ordenada de nomes de coluna. Ao converter CSV em um objeto, os nomes das colunas
|
|
serão usados como os nomes das propriedades. Como alternativa, os nomes das colunas podem ser obtidos da primeira linha do CSV.</p>
|
|
<p>Ao converter para CSV, o modelo de colunas é usado para identificar quais propriedades extrair do objeto e em que ordem.</p>
|
|
<p>Se o modelo de colunas estiver em branco, você pode usar uma lista de propriedades simples separada por vírgulas fornecida em <code>msg.columns</code> para determinar o que extrair e em que ordem. Se nenhum estiver presente, todas as propriedades do objeto são exibidas no pedido
|
|
em que as propriedades são encontradas na primeira linha.</p>
|
|
<p>Se a entrada for uma matriz, o modelo de colunas será usado apenas para gerar opcionalmente uma linha de títulos de coluna.</p>
|
|
<p>Se a opção 'analisar valores numéricos' estiver marcada, os valores numéricos da cadeia de caracteres serão retornados como números, ou seja, valor médio '1, '1.5', 2'.</p>
|
|
<p>Se a opção 'incluir strings vazias' estiver marcada, strings vazias serão retornadas no resultado, ou seja, valor médio '"1","", 3'.</p>
|
|
<p>Se a opção 'incluir valores nulos' estiver marcada, os valores nulos serão retornados no resultado, ou seja, valor médio '"1",,3'.</p>
|
|
<p>O nó pode aceitar uma entrada de várias partes, desde que a propriedade <code>partes</code> seja definida corretamente, por exemplo, de um nó de entrada de arquivo ou nó de divisão.</p>
|
|
<p>Se forem enviadas várias mensagens de saída, estas terão suas propriedades <code>partes</code> definidas e formarão uma sequência de mensagens completa.</p>
|
|
<p><b>Nota:</b> o modelo de coluna deve ser separado por vírgulas - mesmo se um separador diferente for escolhido para os dados.</p>
|
|
</script>
|