Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice




Dúvidas básicas

...

Preparamos este guia de perguntas e respostas para resolver de forma rápida e clara as principais dúvidas sobre como funciona a nossa Store no TOTVS Fluig.

...

  • Junte-se aos maiores: O TOTVS TOTVS Fluig faz parte do ecossistema TOTVS, líder absoluta no mercado brasileiro 
  • Exposição e divulgação
  • Acesso a novos clientes: O TOTVS TOTVS Fluig é uma plataforma que possui milhares de clientes, milhões de usuários, além de diversos canais e desenvolvedores especializados na plataforma.
  • Acesso a tecnologia de ponta: O TOTVS TOTVS Fluig fornece toda uma gama de recursos que facilitam o desenvolvimento de soluções e integrações com a plataforma:
    • Recursos de Desenvolvimento:
    • Conhecimento e Comunidade:
      • TOTVS Fluig Academy: Portal de e-learning para capacitação contínua do parceiro. (http://academy.TOTVS Fluig.com/)

      • Fórum TOTVS: Uma comunidade ativa para tirar dúvidas e trocar experiências com outros desenvolvedores e profissionais de negócios. (https://forum.totvs.io/)

      • Webinars Técnicos: Sessões exclusivas para se manter atualizado sobre as novidades da plataforma.

...

A plataforma é muito flexível. Você pode criar e vender diversos tipos de artefatos:

Categoria da SoluçãoDescriçãoObservações
Solução Aplicativo

Aplicações robustas que rodam dentro do TOTVS TOTVS Fluig, utilizando recursos nativos da plataforma (widgets, datasets, processos, layouts, formulários, APIs etc.). São instaladas no ambiente do cliente TOTVS TOTVS Fluig.

  • Aplicativo que usa os componentes nativos do TOTVS TOTVS Fluig.
  • Cliente precisa ter um ambiente TOTVS TOTVS Fluig.
    • Ex.: Aplicativo de gestão com widget + processo + formulários + relatório.
Solução Flows Soluções compostas por processos e formulários prontos, focadas em implantação rápida. Não são aplicativos completos, mas processos prontos para serem instalados e usados com configurações mínimas.
  • Cliente precisa ter TOTVS TOTVS Fluig para instalar o Flow.
    • Ex.: Fluxo de aprovação de férias pronto, Processos para RH, Financeiro, TI etc.
Solução Runner 

É uma Solução aplicativo, porém entregue em uma arquitetura SaaS hospedada na nuvem, comercializada como serviço. O cliente não precisa ter um ambiente TOTVS TOTVS Fluig, pois o aplicativo utiliza o TOTVS TOTVS Fluig apenas como motor (engine) nos bastidores.

  • Um app construído com tecnologia TOTVS TOTVS Fluig, mas oferecido como SaaS.
    • Ex.: Cliente acessa via web, sem instalar TOTVS TOTVS Fluig.

Desenvolvimento e Publicação

...

  • Ideia e regras: Defina o que vai criar e leia as "Diretrizes de Homologação da Store no TOTVS Fluig" no TDN para entender as regras técnicas e de segurança.
  • Desenvolvimento e testes: Crie a Solução no seu ambiente e teste exaustivamente.
  • Envio para homologação: Submeta o pacote da Solução através do portal de Parceiros. Portal do parceiro
  • Análise Review da Solução: Nossa equipe técnica revisará seu código (segurança, performance, etc.). Se necessário, pediremos ajustes.
  • Aprovação e publicação: Após aprovado, você configura as informações comerciais (descrição de marketing, imagens, etc) e sua Solução entra no ar para os clientes.

Onde encontro a documentação técnica e recursos para aprender a desenvolver para o TOTVS Fluig?

...

Para desenvolvedores interessados em distribuir soluções para o TOTVS Fluig foi disponibilizado um exemplo (sample-component) completo no repositório Git Fluig utilizando a estrutura necessária para estes projetos.

Informações

Leia o arquivo README para conhecer os detalhes da estrutura do projeto de um componente da Store.

Além disso, abaixo também estão listadas as principais referências para o desenvolvimento dos componentes da plataforma que compõe um produto distribuído pela Store.

Deck of Cards
iddesenvolvimento
Card
labelWidgets

Documentações

Vídeos

Card
labelLayouts

Documentações

Vídeos

Card
labelLicenças
  • obrigatório que seu componente verifique se o cliente possui uma licença válida para usá-lo.

    • Todo parceiro recebe um SlotID exclusivo para o componente criado.

    • Você deve usar o recurso "Slots" na API de Licenciamento para verificar a disponibilidade no License Server do cliente.

    • O endpoint para consulta é: [protocolo]://[host fluig]/license/api/v1/slots/{SlotID}.
Bloco de código
titleDica
Para ver os detalhes técnicos dessa API, acesse o Swagger no seu ambiente de desenvolvimento: [protocolo]://[host fluig]/license/swagger-ui/#/Slots
Painel
titleOutros canais que podem ajudar você
  • Conhecimento e Comunidade:
    • TOTVS Fluig Academy: Portal de e-learning para capacitação contínua do parceiro. (http://academy.TOTVS Fluig.com/)

    • Fórum TOTVS: Uma comunidade ativa para tirar dúvidas e trocar experiências com outros desenvolvedores e profissionais de negócios. (https://forum.totvs.io/)

    • Webinars Técnicos: Sessões exclusivas para se manter atualizado sobre as novidades da plataforma.

Dica

Não deixe de participar dos encontros do TOTVS Developers:  https://developers.totvs.com/


Qual o passo a passo prático para desenvolver minha Solução?

...

Já sabe o que vai criar e conhece a plataforma? Siga os passos:

  • Instale o TOTVS Fluig: Baixe o instalador no Portal do Cliente (ou solicite via Apoio Parceiros TOTVS Fluig se ainda não tiver acesso). 
  • Comece a Criar: Utilize o exemplo (sample-component)como modelo para garantir a estrutura correta.
  • Gere o Pacote e Instale: Após codificar, gere o arquivo do componente (EAR) e faça o deploy no seu ambiente TOTVS Fluig seguindo a documentação da Central de componentes
  • Teste e Evolua: Teste exaustivamente sua solução até que ela esteja madura.


Minha Solução está pronta. Como faço para submetê-la na Store no TOTVS Fluig?

...

Após o ciclo de desenvolvimento, testes internos e feedback de beta testers, é hora de lançar!

  • Empacote: Garanta que o código-fonte e dependências estejam em um arquivo .ear, na estrutura correta (você pode exportar diretamente pelo Fluig Studio).
  • Capriche na Documentação e Marketing: A vitrine é fundamental. Prepare um texto vendedor, screenshots de alta qualidade, vídeos de demonstração e uma documentação de uso clara e completa. Clientes pesquisam antes de comprar; valorize seu produto!
  • Envie o Formulário: Acesse e envie através do Portal do parceiro o pacote da sua solução para nossa análise.


Como funciona o processo de Review da Solução da Store?

...

Nós queremos que a Store seja um ambiente seguro e confiável para os clientes. Por isso, todas as soluções (novas ou atualizações) passam por um rigoroso eview de Solução: o guia rápido para o parceiro de Soluções antes de serem publicadas.

  • O que analisamos: Instalação, qualidade do código, comportamento no ambiente, segurança, boas práticas e documentação.
  • Objetivo: Garantir o perfeito funcionamento para o cliente e apoiar você com as melhores práticas de desenvolvimento.



Como devo gerenciar as atualizações e versões da minha Solução?

...

Sua solução deve evoluir para corrigir bugs e acompanhar a plataforma TOTVS Fluig.

  • Envio ao Review da Solução: Todas as atualizações (correções ou novos recursos) devem ser submetidas ao processo de Review da Solução. É vetada a distribuição direta para clientes.

  • Versionamento Semântico: Recomendamos seguir o modelo 2.0.0 (MAJOR.MINOR.PATCH).

    • MAJOR: Mudanças incompatíveis na API.

    • MINOR: Novas funcionalidades compatíveis.

    • PATCH: Correções de falhas compatíveis.

  • Release Notes: Toda atualização deve vir acompanhada de notas de lançamento detalhando o que mudou.

  • Release Candidates (RC): O Fluig tem atualizações (MINOR) a cada 2 ou 3 meses. Você receberá acesso antecipado (RC) para testar e garantir que seu app continua compatível antes do lançamento oficial da plataforma.


Existe um checklist do que é obrigatório para cada tipo de Solução?

...

Os requisitos do Review da Solução são divididos em categorias para cobrir todos os aspectos da sua Solução. O processo verifica desde a experiência do usuário até a segurança.

A tabela a seguir apresenta um resumo dos requisitos por categoria. 

Informações
titleNota:

Para consultar a descrição completa de cada requisito, clique aqui.

CategoriaO que o Review da Solução avalia
Documentação de usoGarante que a documentação (recursos, regras, instalação, pré-requisitos, etc.) seja completa, acessível e atualizada para o usuário final e administrador.
DesenvolvimentoVerifica se o código segue as boas práticas do TOTVS Fluig e evita variações técnicas, consultas diretas ao banco, bibliotecas desatualizadas, códigos duplicados e configurações fixas.
SegurançaAssegura que a Solução não exponha vulnerabilidades e que as informações sejam protegidas. Exige o uso de conexões seguras (SSL/TLS) em serviços externos.
DistribuiçãoConfirma se a Solução segue as diretrizes para ser empacotado e publicado.
PrivacidadeGarante que a Solução tenha Termos de uso e Política de privacidade adequados à legislação, com transparência sobre a coleta e tratamento de dados.
TécnicoGarante que o parceiro envie o código-fonte completo e o artefato compilado devidamente.
InstalaçãoVerifica se a instalação é isenta de erros. O instalador deve executar todos os procedimentos (deploy, criação de registros, etc.) e validar permissões/pré-requisitos automaticamente.
OnboardingAssegura que a Solução proporcione um Onboarding rápido e simples, sem exigir configurações manuais ou processos adicionais após a instalação.
UsoGarante que a Solução funcione sem travamentos ou erros, oferecendo boa usabilidade, interface responsiva, mensagens claras e conteúdo sem erros gramaticais.
ProcessosGarante que a Solução Flow esteja configurado corretamente, sem inconsistências.
ConfiguraçãoGarante que a Solução permita ao administrador controlar o acesso e a disponibilidade do app no ambiente.
QAGarante que o parceiro forneça uma licença válida para testes, caso a Solução possua licenciamento adicional, para validação completa.


Se um cliente comprar minha Solução e tiver dúvidas ou encontrar um erro, quem dá suporte?

...

O TOTVS TOTVS Fluig garante que a Store funcione. No entanto, o suporte sobre o uso, configuração ou correção de bugs do seu aplicativo específico específicos da sua solução deve ser fornecido pela sua equipe. Por isso, é fundamental manter seus contatos de suporte sempre atualizados na descrição do produto na lojada solução na Store no TOTVS Fluig.