Criação de Conectores: mudanças entre as edições

De EAPn
Ir para navegação Ir para pesquisar
Linha 23: Linha 23:


</code>
</code>
===Fazendo pelo Bonita===
Seguir o passo a passo do link:https://documentation.bonitasoft.com/bonita/2022.1/api/rest-api-extensions

===Maven===
===Maven===
<code class="terminal-line"> wget https://www-us.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz -P /tmp </code>
<code class="terminal-line"> wget https://www-us.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz -P /tmp </code>

Edição das 16h51min de 5 de maio de 2022

Conectores são pontos de extensão que podem ser adicionados a um processo para estender os recursos do Bonita Runtime. Eles são um pedaço de código com entradas definidas como Expressões e saídas definidas como Operações.

Instalando as ferramentas

Deve-se instalar o Java JDK e Maven na sua máquina.
Maven 3.3+ requer JDK 1.7 ou mais recente.
Abra o terminal Linux (Debian) e execute as seguintes linhas de código:


Instalando OpenJDK

 sudo apt update 
 sudo apt install default-jdk 

Verifique a instalação do OpendJDK com:

java -version

A saída deve ser algo do tipo:
openjdk version "11.0.7" 2020-04-14
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

Fazendo pelo Bonita

Seguir o passo a passo do link:https://documentation.bonitasoft.com/bonita/2022.1/api/rest-api-extensions

Maven

 wget https://www-us.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz -P /tmp 
 sudo tar xf /tmp/apache-maven-*.tar.gz -C /opt 
 sudo ln -s /opt/apache-maven-3.6.3 /opt/maven 
 sudo nano /etc/profile.d/maven.sh 

export JAVA_HOME=/usr/lib/jvm/default-java
export M2_HOME=/opt/maven
export MAVEN_HOME=/opt/maven
export PATH=${M2_HOME}/bin:${PATH}


 sudo chmod +x /etc/profile.d/maven.sh 
 source /etc/profile.d/maven.sh 
 mvn -version 


 Maven home: /opt/maven

Java version: 11.0.7, vendor: Ubuntu, runtime: /usr/lib/jvm/java-11-openjdk-amd64
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "5.4.0-26-generic", arch: "amd64", family: "unix"


Fazendo o build

  mvn archetype:generate \
 -DarchetypeGroupId=org.bonitasoft.archetypes \
 -DarchetypeArtifactId=bonita-rest-api-extension-archetype

Ao executar esse comando, é iniciado o processo de criar a REST API, especificando atributos conforme as perguntas aparecem no terminal. Siga as instruções para cada campo:

  • GroupId e package: digitar org.bonitasoft.archetypes
  • ArtifactId: bonita-rest-api-extension-(qualquer coisa aqui) Não tenho certeza se precisa desse texto em específico ou se pode ser quaisquer palavras separadas por -
  • Version: 1.0-SNAPSHOT Altera o número da versão como preferir
  • BonitaVersion: É a technical Id da versão, verificar qual a technicalId da sua versão abrindo o bonita studio, indo em Help e clicando em sobre
  • Linguagem: Groovy, java ou kotlin, kotlin está dando erro no momento(05/2022)
  • PathTemplate: qualquer coisa desde que seja separado por hífen, exemplo: miguel-thiago-tomas
  • HttpVerb: a função desejada da REST API, a lista das funções aparece no terminal
  • DisplayName: qualquer nome
  • ApiName: nome da sua REST API