gRPC
Descubra mais sobre o componente gRPC e saiba como utilizá-lo na Digibee Integration Platform.
Atualizado
Descubra mais sobre o componente gRPC e saiba como utilizá-lo na Digibee Integration Platform.
Atualizado
O gRPC permite a realização de chamadas a serviços gRPC do tipo unário e client stream via payload ou via arquivo.
Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por expressões Double Braces estão marcados com (DB)
.
Parâmetro | Descrição | Valor padrão | Tipo de dado |
---|---|---|---|
Veja um exemplo de Service Name como “Greeter”:
Veja um exemplo de Method Name como “helloMethod”:
Para usar esse parâmetro, o “descriptor” deve ser gerado primeiro a partir de um arquivo .proto. Para fazer isso, siga os passos abaixo:
Gere o arquivo "descriptor" executando o seguinte comando no diretório corrente que estiver localizado o arquivo .proto:
Arquivo .proto do diretório: Example.proto
Nome do arquivo descriptor a ser gerado: proto.desc
Faça o download do compilador protoc em Protocol Buffer Compiler Installation.
Realize o encode deste arquivo para base64:
Informe o base64 na propriedade Proto Descriptor File.
Espera-se um payload de entrada que será utilizado dentro do parâmetro Payload do componente.
Ao executar um componente SFTP utilizando as operações download, upload ou move, a seguinte estrutura de JSON será gerada:
response: JSON de resposta recebido do serviço gRPC.
success: "true" se houver uma conexão e o script for executado mesmo se retornar erros no stderr.
success: “false” quando a operação falha.
message: mensagem sobre o erro.
exception: informação sobre o tipo de erro ocorrido.
Para entender melhor o fluxo das mensagens na Plataforma, leia a documentação sobre Processamento de mensagens.
Dado o seguinte arquivo .proto:
Primeiramente, é preciso gerar o arquivo “descriptor”:
Dentro do diretório do arquivo, execute o comando:
Com o “descriptor” em mão, gere o base64 do arquivo proto.desc e adicione-o no campo Proto Descriptor File.
Configurações do componente:
Method Type: Unary
URL: localhost:50051
Service Name: Greeter
Method Name: unary
Proto Descriptor File: <BASE64 DO ARQUIVO DESCRIPTOR GERADO ACIMA>
Payload:
Connect Timeout: 30000
Request Timeout: 30000
Fail On Error: desabilitado
Resposta
Dado o arquivo .proto:
Primeiramente, é preciso gerar o arquivo “descriptor”:
Dentro do diretório do arquivo, execute o comando:
Com o “descriptor” em mão, gere o base64 do arquivo proto.desc e adicione-o no campo Proto Descriptor File.
Configurações do componente:
Method Type: Client Stream - via Payload
URL: localhost:50051
Service Name: Greeter
Method Name: clientStream
Proto Descriptor File: <BASE64 DO ARQUIVO DESCRIPTOR GERADO ACIMA>
Payload:
Connect Timeout: 30000
Request Timeout: 30000
Fail On Error: desabilitado
Resposta
Dado o seguinte arquivo .proto:
Primeiramente, é preciso gerar o arquivo “descriptor”:
Dentro do diretório do arquivo, execute o comando:
Com o “descriptor” em mão, gere o base64 do arquivo proto.desc e adicione-o no campo Proto Descriptor File.
Configurações do componente:
Method Type: Client Stream - via Payload
URL: localhost:50051
Service Name: Greeter
Method Name: clientStream
Proto Descriptor File: <BASE64 DO ARQUIVO DESCRIPTOR GERADO ACIMA>
File Name: file.json
File Name: file.json
JSON Path: $.infos[*]
Connect Timeout: 30000
Request Timeout: 30000
Fail On Error: desabilitado
Resposta