--- title: "Modelo de dados de monitoramento de máquinas" slug: "product-docs-template-8" updated: 2026-10-22T10:50:19Z published: 2026-10-22T10:50:19Z canonical: "support.tulip.co/product-docs-template-8" --- > ## 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. # Modelo de dados de monitoramento de máquinas Uma decisão comum no monitoramento de máquinas é **saber quando usar as tabelas do Tulip em vez da tabela de atividades da máquina**. **Neste artigo, você aprenderá:*** **Quando usar as tabelas do Tulip*** **Quando usar a tabela de atividade da máquina*** **Os pontos fortes e as limitações de cada uma** ## Tabela de atividade da máquina: Rastreamento de OEE integrado Uma tabela do sistema que a máquina aciona automaticamente para preencher e que registra: - Estado (Em execução, Parada, Offline) - Hora de início, hora de término e duração - Motivo da inatividade - Contagem de peças e contagem de defeitos - Taxa de produção ideal - Campos de atividade personalizados (definidos pelo usuário) ### Pontos fortes - Configuração mínima — associada automaticamente às máquinas Tulip - Otimizado para cálculos de OEE (Disponibilidade, Desempenho, Qualidade) - Funciona perfeitamente com gatilhos de máquina (sem interface) - O Analytics pode consultar diretamente os dados de atividade das máquinas ### Limitações - **Sem acesso à API da Tabela Tulip** — não é possível ler ou gravar programaticamente na tabela de Atividade da Máquina por meio da API - **Não há ID de registro na tabela** — é difícil vincular a outras tabelas - Exportação apenas por meio de arquivo CSV (sem integração em tempo real) ### Use a tabela de atividade da máquina apenas para OEE Se seu **único objetivo** for acompanhar o tempo de operação e de inatividade da máquina e calcular o OEE, use gatilhos de máquina com a Tabela de Atividade da Máquina. Essa é a solução mais simples e econômica. #### Exemplo ![Machine State by Value](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Machine%20State%20by%20Value.png) ## Tabelas Tulip: modelo de dados flexível para casos de uso complexos ### Quando usar as Tabelas Tulip - Você precisa de **campos de dados personalizados** que não estão disponíveis na Tabela de Atividade da Máquina (por exemplo, ID da Ordem de Serviço, Crachá do Operador, SKU) - Você precisa de **operações CRUD** (Criar, Ler, Atualizar, Excluir) por meio de APIs - Você integra dados de máquinas a **outros processos de negócios** (qualidade, estoque, manutenção) - Você deseja **contextualizar os dados da máquina** com ordens de serviço, lotes ou cronogramas de produção ## Use tanto a Tabela de Atividades da Máquina quanto as tabelas Tulip **Tabela de Atividades da Máquina** (por meio de gatilhos da máquina): - Capture mudanças de estado em bruto - Calcule métricas de OEE **Tabela Tulip** (por meio de automações ou gatilhos de aplicativos): - Enriqueça os dados da máquina com o contexto de negócios - Habilitar integrações baseadas em API - Vincular a ordens de serviço, registros de qualidade e outros dados ### Exemplo de arquitetura Observação: “Automação” refere-se às [automações](/r230/docs/automations) do Tulip. ![MM - Data Model for Downtime.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/MM%20-%20Data%20Model%20for%20Downtime.png) Este modelo híbrido oferece: - Painéis de OEE a partir da Tabela de Atividade da Máquina - Análise de causa raiz a partir da Tabela Tulip com acesso à API para ferramentas externas de BI ## Gerenciamento de dados manuais com padrões de retrabalho e refugo **Desafio**: As máquinas relatam automaticamente a contagem de peças, mas o contexto humano (retrabalho, refugo, ajustes manuais) exige entrada manual. Como conciliar as contagens automatizadas das máquinas com as correções manuais? ### Evite corromper os dados da máquina **Não** tente diminuir a contagem de peças da máquina quando um operador registrar um retrabalho. **Por que isso falha**: a máquina não compreende o contexto humano. Se você gravar de volta na máquina, corromperá a fonte de dados brutos. ### Separe as fontes de verdade 1. Deixe que a máquina relate as contagens brutas. 2. Use uma tabela separada para ajustes manuais. 3. Calcule a produção líquida por meio de expressões. #### Exemplo de modelo de dados **Tabela de atividades da máquina** (automática): - Contagem de peças: 104 (saída bruta da máquina) - Defeitos: 0 (a máquina não registra) **Tabela de registro de produção** (Tabela Tulip, via aplicativo): - ID: 12345 - Ordem de trabalho: WO-5678 - ID da máquina: CNC-001 - Peças brutas: 104 (copiadas da máquina ao final da execução) - Contagem de retrabalho: 4 (informação fornecida pelo operador) - Contagem de refugo: 0 - Peças líquidas: 100 (calculado: Total – Retrabalho – Rejeito) - Carimbo de data/hora #### Fluxo de trabalho do aplicativo: 1. O operador inicia uma execução e seleciona uma ordem de trabalho 2. A máquina opera e incrementa a contagem de peças automaticamente 3. O operador percebe que 4 peças precisam de retrabalho e as reenvia para a linha 4. A máquina atualiza a contagem para 104 (a máquina conta 104 peças) 5. O operador encerra a execução, e o aplicativo cria um registro no Log de Produção 6. O aplicativo copia a contagem de peças da máquina (104) para o campo “Total de peças” 7. O operador insere manualmente a “Contagem de retrabalho”: 4 8. O aplicativo calcula as peças líquidas = 104 - 4 = 100 **Análises**: - **OEE da máquina**: utiliza a contagem bruta de peças (104) para o cálculo de desempenho - **Relatórios de produção**: utiliza o número líquido de peças (100) para a produção efetiva **Aprimoramento opcional**: Registrar defeitos em um campo de atividade da máquina para o cálculo da qualidade do OEE: ![write rework count to machine attribute](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/write%20rework%20count%20to%20machine%20attribute.png) Isso permite que a porcentagem de qualidade do OEE reflita a taxa real de defeitos, mantendo as contagens brutas da máquina. ## Leitura complementar - [Crie seu primeiro gatilho de máquina](/r230/docs/create-your-first-machine-trigger) - [Automações](/r230/docs/automations-1) - [Tabelas](/r230/docs/tables) - [Exportar dados de atividade do Tulip](/r230/docs/export-tulip-activity-data) {{snippet.Você encontrou o que estava procurando?}} **OEE (Overall Equipment Effectiveness)** A key performance indicator (KPI) that measures manufacturing productivity by calculating the percentage of planned production time that is truly productive. **OEE** combines three factors: **Availability** (uptime), **Performance** (speed), and **Quality** (good parts produced). **Formula:** OEE = Availability × Performance × Quality **Scale:** Expressed as a percentage, where 100% represents perfect production (manufacturing only good parts, as fast as possible, with no downtime).