> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder/templates.md). # Modelos A Navixy fornece modelos de fluxo de trabalho para transformações comuns disponíveis na camada de Transformação. Cada modelo é uma configuração de fluxo de trabalho do Transformation Builder pré-construída que você pode importar, inspecionar e adaptar ao seu cenário operacional antes de agendá-lo como uma transformação personalizada em `processed_custom_data`. Os modelos são um ponto de partida, não um produto final. Cada modelo é fornecido sem um nó de Saída para que você possa decidir onde e como os resultados são gravados antes de confirmar um agendamento. ## Como usar um modelo As etapas abaixo se aplicam a qualquer modelo nesta página. Os valores específicos do modelo para o nó de Saída e o agendamento estão listados na seção [Modelos disponíveis](#available-templates) . {% stepper %} {% step %} **Baixe o modelo** Encontre a transformação desejada na seção Modelos disponíveis abaixo e baixe o respectivo arquivo YAML. {% endstep %} {% step %} **Abra o Transformation Builder e conecte-se ao seu banco de dados** Inicie o [Transformation Builder](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder.md) e insira sua URL de conexão PostgreSQL. Aguarde o Builder descobrir as tabelas e colunas disponíveis. {% endstep %} {% step %} **Importe o fluxo de trabalho** Clique em **Importar** na barra de ferramentas e selecione o `.yaml` arquivo baixado. O grafo do fluxo de trabalho é carregado com todos os nós e arestas no lugar. {% endstep %} {% step %} **Revise e ajuste o fluxo de trabalho** Inspecione o grafo de nós. A página de cada transformação em [Transformações comuns](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/common-transformations.md) descreve a lógica de processamento e lista as opções de personalização que você pode aplicar nesta etapa. Clique em Executar a qualquer momento para visualizar os resultados com seus dados em tempo real (até 100 linhas). {% endstep %} {% step %} **Adicione um nó de Saída** Um modelo não possui nó de Saída. Adicione um a partir do painel de nós e conecte-o ao nó final no grafo. Use os valores do nó de Saída listados para o seu modelo na seção [Modelos disponíveis](#available-templates) abaixo. Quando agendado, o fluxo de trabalho grava em `processed_custom_data`. Ele produz uma tabela separada da versão integrada mantida pela Navixy em `processed_common_data`. {% endstep %} {% step %} **Agende o fluxo de trabalho** Clique em **Agende** e defina a frequência de execução. Use o agendamento recomendado listado para o seu modelo na seção Modelos disponíveis, ou escolha um intervalo diferente para atender às suas necessidades de relatórios. {% endstep %} {% endstepper %} ## Modelos disponíveis A tabela abaixo lista os modelos disponíveis com os valores de que você precisa para o nó de Saída e o agendamento recomendado. Cada modelo vincula sua página de transformação para detalhes do algoritmo e orientação de personalização, e fornece o arquivo YAML para download. ### Viagens Produz uma linha por viagem de veículo a partir de dados telemáticos brutos, com horários de início e término,\ distância, estatísticas de velocidade e detecção de zona. Consulte a página [Viagens](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/common-transformations/trips.md) para o esquema de saída completo, a descrição do algoritmo e as opções de personalização. {% file src="/files/7f5eb81dbb425f6be0beec259ec1171698be4433" %} Ao adicionar o **nó de Saída**, use a seguinte configuração: | Parâmetro | Valor | | ---------------- | ------------------------------ | | Nome da tabela | `trips` | | Coluna de tempo | `trip_start_time` | | Chave primária | `device_id`, `trip_start_time` | | Modo de gravação | `overwrite` | Agendamento recomendado: `10 */8 * * *` (UTC, a cada 8 horas), correspondendo à frequência de atualização da transformação integrada `processed_common_data.trips` . ### Agregação de dados de sensores Produz agregados por intervalo de tempo das leituras de sensores, com decodificação, calibração de combustível e enriquecimento em linguagem humana aplicados. Consulte a página Agregação de dados de sensores para o esquema de saída completo, a descrição do algoritmo e as opções de personalização. O modelo é fornecido pré-configurado para intervalos de 5 minutos, um cenário comum de personalização para painéis de diagnóstico. Para alterar o tamanho do intervalo, edite o literal do intervalo no nó SQL Personalizado antes de agendar. O valor do intervalo controla tanto o tamanho do intervalo quanto a janela de retrospectiva. {% file src="/files/1475e80dba2920f19a5edb41d7fb880c85d260f2" %} Ao adicionar o **nó de Saída**, use a seguinte configuração: | Parâmetro | Valor | | ---------------- | ----------------------------------------------------- | | Nome da tabela | `sensors_data_by_5min` | | Coluna de tempo | `hour_bucket` | | Chave primária | `device_id`, `hour_bucket`, `sensor_name`, `event_id` | | Particionar por | `DATE(hour_bucket)` | | Modo de gravação | `append` | Agendamento recomendado: `*/5 * * * *` (UTC, a cada 5 minutos), correspondendo ao tamanho de intervalo de 5 minutos pré-configurado no modelo. Se você alterar o intervalo, atualize o agendamento para corresponder, de modo que cada execução leia exatamente a quantidade de dados de um intervalo. ## Próximas etapas * [**Transformações comuns**](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/common-transformations.md): Saiba o que cada transformação produz, como é construída e como personalizar a lógica antes de importar um modelo. * [**Transformation Builder**](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder.md): Referência completa do editor visual de fluxo de trabalho, dos tipos de nó e das opções de execução. * [**Referência do YAML do fluxo de trabalho**](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder/workflow-yaml-reference.md): Especificação do formato YAML usado por esses arquivos de modelo. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder/templates.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.