Função personalizada: Calcular_Valores_de_Campo

Função personalizada: Calcular_Valores_de_Campo

  • Essa função personalizada pode ser usada para adicionar dois valores e salvar o valor de retorno em um campo personalizado. 

  • A soma será atualizada dinamicamente no campo personalizado depois que essa função for executada. 

Cenário de negócios

Helen é a diretora de Gerenciamento de aquisições de sua organização. Uma vez que o custo de compra individual de todos os materiais é aprovado por Helen, o custo total pode ser calculado e salvo executando esta função. 

Siga estas etapas abaixo para configurar a função.

Antes de executar essa função personalizada, você terá que configurar os argumentos, adicionar valores de campo personalizados (se necessário) e criar conexões. Siga as etapas abaixo para configurar a função. 

1. Configurar os argumentos 


Primeiro, configure  Argument Values (Valores de argumento) para todos os parâmetros usados na função personalizada. Você pode especificar o valor personalizado ou escolher um campo de formulário na lista suspensa. Os campos de formulário capturam valores dinâmicos de campos de cartão correspondentes à função personalizada.     

 

  • orgName : especifique o nome da organização. Estará disponível no URL do Qntrl ( core.qntrl.com/blueprint / <orgName>/<module>). 

  • param1 : digite um valor aqui ou mapeie um campo personalizado. 

  • param2 : digite um valor aqui ou mapeie um campo personalizado. 

  • jobID : escolha o campo do formulário  Card ID (ID do cartão)  aqui. Você também pode especificar o ID do cartão. Estará disponível no URL do cartão ( core.qntrl.com/blueprint/ <org-name>/<job>/<jobID>).


2. Adicionar valores de campo personalizados


Para fornecer valores para campos personalizados no cartão, adicione a sintaxe abaixo à função.  Isso é opcional e pode ser incluído somente se houver a necessidade de fornecer valores aos campos personalizados. 
Sintaxe:
paramMap.put("column_name of the custom field","value of the custom field");


O 'column_name of custom field' pode ser obtido usando APIs:
    1.   Clique no hiperlink para visitar nossa  Documentação da API . 
    2.   Navegue até a guia  Reference (Referência) e selecione  Forms (Formulários)  no painel esquerdo. 
    3.   Execute a função  Get form details (Obter detalhes do formulário)  clicando em  Try Now (Tentar agora) . 
    4.   Escolha sua organização e configure o URL inserindo o ID do formulário. Estará disponível no URL do formulário ( core.qntrl.com/blueprint /<org-name>/<layout>/<formID>). 
    5.   Clique em  Execute (Executar) . 
    6.   Pressione Ctrl+F no teclado e procure o nome do campo personalizado. Você pode encontrar listado como alias_name. 
    7.   Localize o column_name vinculado a este campo personalizado. Ele será listado logo acima do alias_name. 


O column_name pode ser usado na sintaxe especificada acima para adicionar valores de campo personalizados.



3. Fornecer autorização usando conexões


As conexões ajudam a autenticar a chamada de API para escopos específicos do Qntrl e outros aplicativos internos do Zoho usados na função personalizada. 
    1.   Invoque as Conexões para autorizar sua conta Qntrl. 

    • Clique no botão  +Connections (+Conexões) em  Custom Functions (Funções personalizadas) . Uma nova guia será aberta em seu navegador. 

    • Clique em  Add Connection (Adicionar conexão) no canto superior direito.

    • Escolha  Zoho Oauth na guia  Pick Your Service (Escolha seu serviço) .

    • Insira um  Connection Name (Nome de conexão) e selecione o escopo  'Orchestly.job.ALL' para se conectar. 

    2.   Após a autenticação bem-sucedida, inclua os detalhes da conexão no bloco invokeurl da função personalizada.  

      Por exemplo: conexão : "<nome da conexão>"


Depois que as etapas acima forem configuradas, você estará pronto para executar a função personalizada. 



Calcular_Valores_de_Campo faz parte das funções personalizadas pré-definidas do Qntrl disponíveis na Function Gallery (Galeria de funções). No entanto, você também pode escrever suas próprias funções personalizadas no Qntrl.