--- title: "Sending Data from Node-RED to Tulip with Tulip Nodes" slug: "sending-data-from-node-red-to-tulip-with-tulip-nodes" updated: 2025-03-24T13:36:23Z published: 2025-03-24T13:36:23Z canonical: "support.tulip.co/sending-data-from-node-red-to-tulip-with-tulip-nodes" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Envio de dados do Node-RED para o Tulip com nós do Tulip ## Visão geral Existem três métodos principais para enviar dados do Node-RED (como dados do dispositivo ou do sistema externo) para a Tulip: 1. via Tulip Machine API 2. via API de tabelas da Tulip 3. via Connector Response *Observação: [requer um Connector primeiro, originado da Tulip](/r230/docs/how-to-configure-a-connector). Para otimizar as comunicações pelos métodos 1 e 2, a Tulip criou três Nodes primários: 1. `tulip-tag`: Envia dados para a Machine Attributes API com funcionalidade avançada - **somente para Tulip Edge Device2**. `machine-attribute`: Envia dados para a API de atributos da máquina a partir de qualquer dispositivo3. `tables`: Enviar e receber dados de/para a API de tabelas de qualquer dispositivo Todos os três nós listados acima são pré-instalados nos dispositivos Tulip Edge. Além disso, os nós 2 e 3 acima são publicados na biblioteca Node-RED para download em qualquer dispositivo. Eles podem ser encontrados `aqui{target=_blank}`. --- ## Envio de dados para um atributo de máquina Tulip *Observação: esta seção pressupõe que um atributo de máquina Tulip tenha sido criado. Para obter mais informações, consulte este guia.* ### A partir de um dispositivo Tulip Edge: o `Tulip-tag` Node *O tulip-tag Node é compatível com os dispositivos Tulip Edge que executam a versão 51 ou superior do software.* 1. Para usar o `tulip-tag` Node, primeiro arraste-o para o painel do editor a partir da Paleta. Clique duas vezes no nó para abrir seu painel de configuração. 2. Clique no lápis para adicionar uma nova lista de tags: :::(Warning) (Warning) Only one active Tag List is supported per Edge Device. Be sure to disable any Flows running other Tag Lists before beginning. ::: 3. Clique em **+add** para adicionar uma nova tag. Cada tag tem três partes: um ID, um rótulo e um tipo. 4. **ID da tag**: um identificador semelhante a um código exclusivo para a tag. Uma vez criado, ele não deve ser alterado. Os caracteres válidos são letras, dígitos (não podem começar com um dígito) e sublinhados. Exemplos: `part_count`, `myState1`. 5. **Etiqueta da tag:** a etiqueta legível para a tag. Para renomear a tag, basta atualizar o rótulo, *não* o ID. Exemplo: "Part Count" (Contagem de peças). 6. **Type (Tipo):** O tipo de dados - String, Integer, Float ou Boolean. Deve corresponder ao tipo do atributo de máquina mapeado. Um exemplo de configuração de lista de tags pode ser encontrado abaixo: ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28325%29.png) 1. Depois que todas as tags forem adicionadas, clique em **Add (Adicionar** ) para salvar todas as alterações. Observe que todas as tags mostrarão **Unmapped (Não mapeado** ) - isso é esperado, pois as tags ainda não têm um atributo de máquina Tulip associado. 2. Depois que a lista de tags é criada, há dois métodos para associar o conteúdo do fluxo às entradas da lista. Ambos dependem da caixa de seleção **Tag Config** no nó `tulip-tag`: 3. Se **Tag Config** estiver marcada (true), será necessário um Tag Node para cada Machine Attribute. Conecte o nó ao nó `tulip-tag` e selecione o Atributo de máquina relevante com o menu suspenso **Selecionar tag** do nó de tag. Observe que o nó de tag usará o que for encontrado em `msg.payload` como a entrada pretendida. 4. Se **a configuração de tag** estiver desmarcada (false), será necessário um nó de tag para todos os atributos da máquina. O nó pegará um objeto completo de todos os valores de tag e os mapeará automaticamente para seu respectivo atributo de máquina. Observe que o objeto de entrada deve corresponder *exatamente* à lista de tags, caso contrário, o nó emitirá um erro. Por exemplo, o fluxo abaixo usa um nó `de injeção`. O nó passa o objeto mostrado para o nó de tag, que então mapeia `helloworld1` para o `itemhello` da lista de tags e `helloworld2` para o item `world` da lista de tags: ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28328%29.png) Agora os dados estão sendo enviados com sucesso para a Tulip. As tags podem ser encontradas como fontes de dados de máquina - para associá-las a um atributo de máquina, localize cada uma delas no dispositivo de borda como uma fonte de dados de máquina. A imagem abaixo mostra três Tags presentes em um Edge Device:![How to Send Data to Machines from Edge Devices using Node-RED and Tulip Tags_566767591.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20to%20Send%20Data%20to%20Machines%20from%20Edge%20Devices%20using%20Node-RED%20and%20Tulip%20Tags_566767591%281%29.png) --- ## De qualquer dispositivo com Node-RED: o Node `machine-attr` 1. Para usar o nó `machine-attr`, primeiro navegue até o atributo Machine no Tulip. 2. Clique para abrir as possíveis fontes de dados e selecione "Tulip API". Copie as informações mostradas:![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28331%29.png) 3. **No Node-RED**, adicione um nó Tulip `machine-attr`. Se não tiver sido configurado anteriormente, configure um novo Tulip Authentication (link necessário - copie daqui: https://support.tulip.co/docs/using-node-red-with-the-tulip-api). 4. Cole os dados de atributo de máquina do Tulip no campo **Device Info**. O nó de atributo de máquina agora está configurado. Todos os dados (do mesmo tipo que o Atributo de máquina) presentes em `msg.payload`, uma vez inseridos no Node, aparecerão no Atributo de máquina no Tulip.