Árvore de páginas

Versões comparadas

Chave

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

01. DADOS GERAIS

Produto:

TOTVS Agro

Multicultivo

API Hub


Linha de Produto:

Linha PIMS

Segmento:

Agroindústria

Módulo:

Framework

Função:Todas
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DAGROFRAME-
5295
4835

02. SITUAÇÃO/REQUISITO

Atualizar "hardlock" do License Server (LS) para versão mínima requerida de "3.7.0"

03. SOLUÇÃO

Na camada de arquitetura e integração com License Server, o recurso (técnica) de "hardlock" do License Server (LS) foi alterado para 3.7.0 como sendo esta a versão mínima requerida para uso do TOTVS Agro Multicultivo.

Comunicado realizado via página oficial Ciclo de Vida - TOTVS Agro:

...

Criar a partir das Entidades & Queries a listagem, schema e recuperação de dados dos Objetos de Negócios no TOTVS API Hub, seguindo a ADR010001.

Conector/APIs de "Objetos de Negócio" Smart View (Bioenergia / TOTVS Agro API Hub) - ADR010001

https://arquitetura.totvs.io/architectural-records/ADRs/Framework/ADR010001/#contexto

Melhorias na estrutura:

    • Revisitar nomenclaturas e rotas no API-Hub para não usar "/smartview/" e sim "/business-objects" (deixar agnóstico no API-Hub, sem vínculo) 
    • Implementar segurança (header Authorization) no API-Hub para "/business-objects/" para dois níveis de autenticação: 1. via credenciais padrão do API-Hub (assim como já acontece nas demais APIs do Bioenergia) e, caso dê 401 (ou token expirado, enfim), seguir para o modelo 2. via T-Provider & Keycloak (únido modelo que seria chamado pelo Smart View)
    • Trocar "isEnableSmartView" para "isBusinessObject" (no modelo de dados) - revisar colunas (banco de dados) para não usar palavra "smart_view", por exemplo, "enable_smart_view"
    • Incrementar APIs de Objetos de Negócio (ON) para que, além do modelo de Entidades (Entity), também se permita usar o conceito de ON para o modelo Consulta (Query);
    • Revisitar abordagem de "v1" e/ou "versão de API de release" para permitir uma recuperação mais dinâmica e inteligente das APIs e suas versões;
    • Concatenar, no nome do objeto de negócio, a versão, por exemplo "Fazenda (v1)", "Fazenda (v2)" ...
    • Quando for utilizar/implementar modelo Query, avaliar uso de nova tabela "query_filters" ou evoluir "query_fields" - objetivo: melhor controlar/catalogar os possíveis filters de APIs GET do tipo Query, para serem utilizadas como filters ou parameters (objetos de negócio)
    • Implementar POST na camada de abstração para chamar GET (da API Padrão, seja Entity ou Query, e depois EntryPoint), para properties =[], filters = [] e parametros = [] ou com filtros utilizados no GET da API Padrão (por exemplo, ?codigoTurma=123)

03. SOLUÇÃO


04. DEMAIS INFORMAÇÕES

Não se aplica.

05. ASSUNTOS RELACIONADOS

Arquitetura e Tecnologia - TOTVS Agro API Hub

Smart View (TReports) & TOTVS AgroAtualização Hard-Lock License Server versão 3.7.0 (release 12.1.2512 TOTVS Agro)