Histórico da Página

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.

...

• 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:@10.172.212.51:1521:AMAZONAS",    
    "username": "DCS_ALBER",
    "password": "DCS_ALBER"
  },
  "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
  • id (Opcional):
  • dataBaseType
  • productName
  • url
  • username
  • password
• integrations: Nome do Catalogo de Schemas que será configurado (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):
• clearOldEvents (Opcional):
• clearOthersProductConnectionSchema (Opcional): 

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