01. VISÃO GERAL

Para simplificar o processo de configuração e do TOTVS Connector Client, tanto para uma nova instalação, quanto para atualização de versão do produto e schemas, foram implementadas duas novas APIs, conforme descritas a seguir.

02. API Auto Configure

A API de Configuração automática pode ser utilizada para realizar a configuração da aplicação, após uma nova instalação, e até mesmo para configurar novos schemas. O processo consiste desde o sincronismo dos Schemas, criação do ProductConnection, vinculo do ProductConnection com um conjunto de SchemaDefinition, limpeza de registros antigos e deleção de triggers do TCC. Para mais informações consulte o manual do usuário.

Descrição: Configura a aplicação com base nos dados fornecidos.  
URL: /api/v1/autoconfig
Método: POST
Headers:

• Content-Type: application/json
• Authorization: Basic *********************Basic YWRtaW46OVpuTXA1UFBoPjs1dixYcg==

Body:

Exemplo do corpo da requisição, que pode ser utilizada para primeira configuração ou incluir novas integrações.

{
  "productConnection": {
    "dataBaseType": "ORACLE12C",
    "productName": "PIMSCS",
    "url": "jdbc:oracle:thin:@127.0.0.1:1521:AMAZONAS",    
    "username": "USERNAME",
    "password": "PASSWORD"
  },
  "integrations": [
    "meus-abastecimentos"
  ],
  "forceSyncSchema": false,
  "clearOldEvents": true,
  "clearOthersProductConnectionSchema": false
}

ou

Exemplo de corpo da resquisição simplificada que pode ser utilizada quando há a necessidade de habilitar novas integrações e já há um ProductConnection previamente configurado.

{
  "productConnection": {
    "id": "37e7fefa-fb7e-441e-8d58-cd6c8daeaa51"
  },
  "integrations": [
    "minha-borracharia"
  ]
}

Os atributos informados no JSON são:

• productConnection: Dados de Conexão com a base do Produto.
  • id (Opcional): ID do ProductConnection, caso já exista pré-configurado. Opcional. Pode ser enviado no modelo de resquisição simplificada, utilizada quando há a necessidade de habilitar novas integrações e já há um ProductConnection previamente configurado, não sendo necessário enviar os demais dados do ProductConnection.
  • dataBaseType: Tipo de Banco de dados utilizado. Os valores possíveis são: POSTGRESQL, MSSQLSERVER, ORACLE11G, ORACLE12C ou MYSQL
  • productName: Nome do Produto a ser integrado.
    • TOTVS Agro Bioenergia: PIMSCS
    • TOTVS Agro Multicultivo: PIMSMC
    • TOTVS Pesagem: TA-PESAGEM
  • url:  JDBC Url para conexão com a base de dados do Produto. (Ex: jdbc:oracle:thin:@127.0.0.1:1521:AMAZONAS)
  • username: Usuário para conexão com a base de dados do Produto.
  • password: Senha para conexão com a base de dados do Produto.
• integrations: Lista de Catalogos de Schemas que serão configurados (agro-data-client, fito-saas, meus-abastecimentos e minha-borracharia)
  • agro-data-client: Schemas AnoAgricola, Cargo, CentroCusto, Componente, DisponibilidadeEquipamento, DisponibilidadeFuncionario, Cultivar, Cultura, Equipamento, Equipe, Funcionario, GrupoComponente, GrupoInsumo, GrupoOperacao, Instancia, Insumo, LocalProducao1, LocalProducao2, LocalProducao3, LocalProducaoFisico, Operacao, OrdemServicoCampo, PeriodoSafra, UnidadeMedida.
  • fito-saas: ParametroLocal, Instancia, Cultura, Cultivar, AnoAgricola, PeriodoSafra, LocalProducao1, LocalProducao2, LocalProducao3, LocalProducao3Fisico, Variavel, Armadilha, Inspecao, Insumo, UnidadeMedida, GrupoInsumo, InspecaoResultadoCalculado.
    
  • meus-abastecimentos: FechamentoPontoAbastecimento, Material, ApontamentoAbastecimento, UnidadeMedida, Instancia, Funcionario, PontoManutencao, GrupoOperativo, ModeloEquipamento, Marca, BombaAbastecimento, CategoriaOperacional, DisponibilidadeEquipamento, DisponibilidadeFuncionario, ParametroUnidadeAdministrativa, UniAdministrativaTrocaRecurso, Parametro, Equipamento, GrupoOperacao, Operacao, Horimetros, HorarioFechPontoAbast, ConsumoMedio.
    
  • minha-borracharia: Admissibilidade, AdmissibilidadeMed, AfastamentoFerias, Autoridades, AvaliacaoPneusDesmontados, CategoriaOperacional, ClassePriorizacao, DisponibilidadeEquipamento, Empresa, EnvioConsertoReformaPneus, Equipamento, EquipamentoPneu, EquipeManutencao, EstruturaPneu, Funcionario, FuncionarioUsuarioManfro, Grupo, GrupoOperacao, GrupoOperativo, HistoricoPneu, Instancia, LocalPneu, Marca, MedidaPneu, ModeloEquipamento, ModeloLocal, ModeloPneu, MotivoCondenacaoPneu, MotivoManutencaoPneu, OcupacaoPneu, Parametro, Pneu, PneuEmpresa, PontoManutencao, PrestadorServico, UnidadeMedida, Usuario, UsuarioInstancia.
• forceSyncSchema (Opcional): Realiza a sincronização dos Schemas com TOTOVS Connector Server. Opcional. Valor padrão: false
• clearOldEvents (Opcional): Realiza a limpeza de eventos antigos (TCC_EVENT). Opcional. Valor padrão: true
• clearOthersProductConnectionSchema (Opcional): Remove configurações existentes de ProductConnection com SchemaDefinition, configurando apenas os Schemas do catalogo enviado. Opcional. Valor padrão: false

Respostas:
200 (OK): Configuração realizada com sucesso.

{
    "productConnection": {
        "id": "37e7fefa-fb7e-441e-8d58-cd6c8daeaa51",
        "productName": "PIMSCS",
        "productVersion": "12.1.2412",
        "url": "jdbc:oracle:thin:@10.172.212.51:1521:AMAZONAS",
        "username": "USERNAME",
        "dataBaseType": "ORACLE12C",
        "enabled": true
    },
    "schemas": [
        {
            "id": "4038eb61-a927-4b02-9470-c6a7b90ac5f2",
            "idProductConnection": "37e7fefa-fb7e-441e-8d58-cd6c8daeaa51",
            "idSchemaDefinition": "583587b7-a6d3-4383-830c-b37fd84f20ae",
            "versionSchemaDefinition": "12.1.2406.0001",
            "nameSchemaDefinition": "Equipamento",
            "enableStandalone": true,
            "enablePublishRemote": false
        },
        {
            "id": "8730f13f-50ac-4bd9-8576-bb6635a981d6",
            "idProductConnection": "37e7fefa-fb7e-441e-8d58-cd6c8daeaa51",
            "idSchemaDefinition": "22fa732b-c07d-4bb7-b409-f300b1840aca",
            "versionSchemaDefinition": "12.1.27",
            "nameSchemaDefinition": "CategoriaOperacional",
            "enableStandalone": true,
            "enablePublishRemote": false
        },
        {
            "id": "b75499b4-96a0-412b-bd40-c34ed8b221ba",
            "idProductConnection": "37e7fefa-fb7e-441e-8d58-cd6c8daeaa51",
            "idSchemaDefinition": "0946d8b3-a0f3-49d7-bd97-a74af21eda7f",
            "versionSchemaDefinition": "12.1.27",
            "nameSchemaDefinition": "DisponibilidadeEquipamento",
            "enableStandalone": true,
            "enablePublishRemote": false
        }
    ]
}

400 (Bad Request): Falha ao validar as regras de negócio.
401 (Unauthorized): Falha de autenticação.
403 (Forbidden): Falha de autorização.
500 (Internal Server Error): Erro inesperado no sistema.

03. API Update All