Sobre este projeto
it-programming / web-development
Aberto
Categoria TI e Programação
Subcategoria Programação
Qual é o alcance do projeto? Bug ou alteração pequena
Isso é um projeto ou uma posição de trabalho? Um projeto
Tenho, atualmente Eu tenho especificações
Disponibilidade requerida Conforme necessário
Integrações de API Outros (Outras APIs)
Funções necessárias Desenvolvedor, Outro
Outras funções necessárias Realizar integração através de DADOS EXPORTADOS de um Sistema chamado SOC para POWER BI.
Exporta Dados
Exporta dados é um recurso que tem por finalidade facilitar a extração de dados do SOC para fins de integração e em alguns casos pode ser utilizado como um gerador simples de relatórios.
O programa "Exporta Dados" é configurável e envolve um ou mais comandos do banco de dados e disponibiliza este recurso para os usuários.
Todo Relatório ou Interface exige uma série de parâmetros a fim de extrair os dados filtrados conforme a necessidade e em se tratando de uma Interface padrão, estes dados de parâmetros (seleção) são enviados em uma única string em um formato chamado json.
Por motivo de segurança essa string sempre contém alguns campos básicos tipo empresa, código do exporta dados, chave e formato de saída.
String Exemplo:{'empresa':'1234','codigo':'23','chave':'hashdeacesso','tipoSaida':'txt'}
(outros campos podem ser acrescentados conforme necessidade de seleção/filtro)
Empresa é o código da Empresa no SOC, o campo Código é o Código do Exporta Dados e o campo Chave é uma chave gerada automaticamente que deve ser enviada também como parâmetro.
As Empresas que desejam usar esta Interface ou Relatório entra no programa Relatórios Exporta Dados (código do programa 733), acessando:
Menu > Relatórios > Exporta Dados, onde o usuário consegue copiar o recurso disponibilizado.
Esta copia/cria 1 registro Exporta Dados novo para a Empresa, onde na string de teste, já vem configurado os 3 campos básicos descrito + os campos de de seleção se necessário.
Neste momento o usuário pode configurar os demais parâmetros.
Tipos de saídas permitidos: HTML, TXT, CSV, XML, JSON.
Sinalizado na imagem com a letra A.
Na tela de configuração, o usuário define quais tipos serão permitidos para utilização.
Sinalizado na imagem com a letra B.
Possíveis Interfaces (post e/ou Web Service):
Para se usar o Web Service o wsdl pode ser acessado pelo endereço: https://www.soc.com.br/WSSoc/services/ExportaDadosWs?wsdl, utilize a documentção técnica explicativa para usar este.
Para o Post utilize o link https://www.soc.com.br/WebSoc/exportadados?parametro={'empresa':'XXX','codigo':'XX','chave':'XX','tipoSaida':'xml',.....}
Controles de Segurança
IP: se informado o IP da máquina, só será gerado a Interface a partir do IP definido;
Senha: se informar uma senha para o Exporta Dados, colocando neste campo será obrigatório o envio da mesma na String {'empresa':'1234','codigo':'23','chave':'aquiteriaohashdeacesso','tipoSaida':'txt','senha':'senhaAcesso'}
Controla usuário: deverão informar o código do usuário e o id será necessário o envio na string : {'empresa':'1234','codigo':'23','chave':'aquiteriaohashdeacesso','tipoSaida':'txt','usuario':'','identificacao':''}
O código do usuário se encontra na tela de Pessoas (ícone Inclui ou Consulta Usuário), e a identificação é o campo ID de 4 dígitos usado no login.
Sempre será visualizado, abaixo a String de teste, um exemplo da String a ser enviada com seus parâmetros.
Prazo de Entrega: Não estabelecido
Habilidades necessárias