Criação de REST API

Extensões da API REST

Crie extensões de API REST para usar dados de sistemas de terceiros (bancos de dados, serviços web, Bonita Engine, etc) em formulários e páginas.

As extensões da API REST podem ser usadas para consultar dados de negócios, APIs do Bonita Engine ou um sistema de informações externo (como um banco de dados, serviço da Web, diretório LDAP…). Eles também ajudam a manter uma separação clara entre o front-end (formulários, páginas e interfaces visíveis para os usuários) e o back-end (processos).

Exemplo

As seções a seguir mostram como criar uma extensão de API REST. Como exemplo, criamos uma extensão de API REST que usa o Bonita BPM Engine para fornecer informações do usuário (nome, sobrenome, endereço de e-mail).

Gerar um novo esqueleto de extensão da API REST

• No menu Desenvolvimento, escolha REST API Extension e, em seguida, New…​.

• Insira um nome, por exemplo, informações do usuário, extensão da API REST.

• Insira uma Descrição, por exemplo, Query Bonita Engine para recuperar informações do usuário.

• Insira um nome de pacote, use para definir o ID do grupo do artefato, por exemplo: com.company.rest.api

• Insira um nome de projeto, por exemplo userInformationRestAPIExtension

• Clique em Avançar.

• Insira o pathTemplate para esta extensão da API REST, por exemplo userInformation. Este será o ponto de
  acesso da API e segue este padrão: {bonita_context}/API/extension/userInformation.

• Como essa extensão da API REST não acessa dados corporativos, você pode desmarcar com segurança a caixa de seleção "Adicionar dependências BDM".

• Defina um nome de permissão para a extensão (substitua o padrão), por exemplo read_user_information. Este é o nome da permissão que os usuários devem ter para ter acesso à extensão (consulte Uso de extensões da API REST)

• Clique em Avançar

• Esta tela define os parâmetros de URL que serão passados ​​para a API. Por padrão, os parâmetros p e c são definidos para habilitar o resultado paginado, isso se aplica bem em nossos exemplos, pois queremos retornar uma lista de usuários.

• Clique em Criar.