Executa e retorna o valor de uma função de bloco de programação do tipo cliente ou servidor.

Figura 1 -  Bloco de programação Chamar Bloco

Compatibilidade

• Bloco cliente: cronapi.util.callServerBlockly()

Retorno

Retorna o resultado da função associado ao bloco.

Parâmetros

Os parâmetros passados através da função Chamar Bloco dependem estritamente dos parâmetros existentes na função a ser chamada.

Característica do bloco

Ao clicar no ícone de configuração, a janela Selecionar Bloco de Programação será exibida, através dela associaremos um bloco de programação do tipo servidor.

Figura 2 - Seleção do bloco

1. Ignorar notificação automática de erro ao chamar este bloco: Ao marcar a caixa de seleção, a notificação de exceção padrão do Cronapp não será exibida no navegador. Isso possibilita que o desenvolvedor utilize um bloco try catch e crie uma notificação de exceção própria. Veja mais detalhes no tópico Exemplo 2.

Exemplo 1

A função cliente abaixo (Figura 3) chama a função FuncaoSoma, contida no arquivo de bloco de programação servidor Soma (Figura 3.1). Perceba que ao realizar a associação, o nome do bloco e a função chamada ficarão visíveis no bloco Chamar Bloco. Os parâmetros exibidos no bloco Chamar Bloco ("valor1" e "valor2") fazem referência a função que é chamada (FuncaoSoma).

O retorno da função servidor FuncaoSoma será repassado para o bloco Chamar Bloco, que por sua vez, alimentará a variável resultadoSoma.

Figura 3 - Passagem de parâmetro para a função contida no bloco Soma

Abaixo, a função chamada pelo bloco Chamar Bloco (Figura 3.1).

Figura 3.1 - Função sendo chamada por Chamar Bloco

Por fim, é retornado no console do navegador, o resultado da soma (Figura 3.2).

Figura 3.2 - Resultado Soma

Exemplo 2

Nesse exemplo mostraremos como a funcionalidade Ignorar notificação automática de erro ao chamar este bloco (destaque 1 da figura 2) age. Basicamente ela desabilita a notificação de erro padrão do Cronapp, ela é exibida no canto superior direito da tela em um alert vermelho (figura 4.2). Com isso, o desenvolvedor poderá tratar a exceção ou exibi-la em um formato diferente.

A função servidor da figura 4 irá gerar um erro e notificará o usuário. Esse erro ocorre, pois, estamos tentando obter o valor da posição 5 de uma lista vazia.

Figura 4 - Exemplo de função que gerará erro

A função cliente ChamarBloco (Figura 4.1) executará a função ConteudoLista (figura 4) através do bloco Chamar Bloco dentro de um try catch, caso ocorra um erro, executará o que estiver na entrada de comando catch, nesse exemplo será o bloco Exibe notificação simples.

Figura 4.1 - Bloco Chamar Bloco executando função servidor

Caso o desenvolvedor não habilite a opção Ignorar notificação automática de erro ao chamar este bloco (destaque 1 da figura 2), a aplicação exibirá tanto a notificação padrão do Cronapp (em vermelho) quanto a personalizada pelo desenvolvedor (em rosa).

Figura 4.2 - Notificações personalizada e padrão do Cronapp

Caso o desenvolvedor habilite a opção Ignorar notificação automática de erro ao chamar este bloco (destaque 1 da figura 2), a aplicação não exibirá a notificação padrão do Cronapp e só exibirá a personalizada pelo desenvolvedor (em rosa).

Figura 4.3 - Notificação personalizada