> 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 Fluxos de trabalho do Transformation Builder pré-criados para transformações comuns da Navixy. Baixe, importe e adapte-os ao seu cenário 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é-criada 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. Todo modelo vem sem um nó de saída para que você possa decidir onde e como os resultados são gravados antes de confirmá-lo em 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 [Modelos disponíveis](#available-templates) seção. {% stepper %} {% step %} **Baixe o modelo** Encontre a transformação que você quer na seção Modelos disponíveis abaixo e baixe o arquivo YAML dela. {% endstep %} {% step %} **Abra o Transformation Builder e conecte-se ao seu banco de dados** Launch [Transformation Builder](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder.md) e insira a URL de conexão do PostgreSQL. Aguarde o Builder descobrir as tabelas e colunas disponíveis. {% endstep %} {% step %} **Importar o fluxo de trabalho** Clique em **Importar** na barra de ferramentas e selecione o baixado `.yaml` arquivo. O grafo do fluxo de trabalho é carregado com todos os nós e arestas no lugar. {% endstep %} {% step %} **Revisar e ajustar 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 Execute a qualquer momento para visualizar os resultados com base nos seus dados em tempo real (até 100 linhas). {% endstep %} {% step %} **Adicionar um nó de saída** Um modelo não tem nó de saída. Adicione-o a partir do painel de nós e conecte-o ao nó final do grafo. Use os valores do nó de saída listados para o seu modelo na [Modelos disponíveis](#available-templates) seção 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 **Schedule** 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ório. {% 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 a programação recomendada. Cada modelo vincula à sua página de transformação para detalhes do algoritmo e orientações de personalização, e fornece o arquivo YAML para download. ### Viagens Produz uma linha por Trajeto do veículo a partir de dados telemáticos brutos, com horários de início e fim,\ distância, estatísticas de velocidade e detecção de zona. Veja o [Viagens](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/common-transformations/trips.md) página para o esquema completo de saída, a descrição do algoritmo e as opções de personalização. {% file src="/files/cef6361486d723482644462b40055c13f9abda85" %} Ao adicionar o **Nó de saída**, use a seguinte configuração: | Parâmetro | Valor | | ---------------- | --------------------------------- | | Nome da tabela | `Viagens` | | Coluna de tempo | `Trajeto_start_time` | | Chave primária | `device_id`, `Trajeto_start_time` | | Modo de gravação | `overwrite` | Agendamento recomendado: `10 */8 * * *` (UTC, a cada 8 horas), correspondendo à frequência de atualização do recurso integrado `processed_common_data.Viagens` transformação. ### Agregação de dados de sensores Produz agregados por intervalo de tempo das leituras do sensor, com decodificação, calibração de combustível e enriquecimento em linguagem natural aplicados. Veja a página Agregação de dados do sensor para o esquema de saída completo, a descrição do algoritmo e as opções de personalização. O modelo vem 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 de intervalo no nó Custom SQL antes do Agendamento. O valor do intervalo controla tanto o tamanho do intervalo quanto a janela de retrospectiva. {% file src="/files/d454b9cc0f2d2c3cf41758e634cb27a972016e4a" %} 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 do intervalo de 5 minutos pré-configurado no modelo. Se você alterar o intervalo, atualize o agendamento para corresponder, para 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 ela é 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 para o editor visual de fluxo de trabalho, os tipos de nó e as opções de execução. * [**Referência de YAML do fluxo de trabalho**](/docs/analytics/pt-br/iot-query/schema-overview/transformation-layer/transformation-builder/workflow-yaml-reference.md): Especificações do formato YAML usado por estes 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.