Função personalizada – Criar_Tarefa

Função personalizada – Criar_Tarefa

  • Essa função personalizada pode ser usada para criar um novo cartão em qualquer orquestração.

  • Ela também pode ser configurado para transportar os valores de campo necessários do cartão anterior para o último.  

Cenário de negócios

  • Helen é a diretora de Gerenciamento de aquisições de sua organização. Uma vez que o custo de compra de um material é aprovado por Helen, um novo cartão pode ser criado automaticamente para iniciar o processo de aquisição acionando essa função personalizada.  

  • O custo aprovado (campo personalizado) pode ser incluído no novo cartão criado.   

Você também pode criar cartões repetitivos automaticamente usando a função personalizada Criar_Tarefa. 

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 usar 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>).

  • jobTitle : especifique o título do cartão. 

  • layoutID:  especifique o ID do formulário no qual o cartão deve ser criado. Estará disponível no URL do formulário  ( core.qntrl.com/blueprint /<orgName>/<layout>/<layoutID>).  

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 de 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. Acesse nossa  Documentação da API .
    2. Navegue até a guia  Reference (Referência) e selecione   Forms (Formulários)  no 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 Form ID (ID do formulário). O Form ID (ID do formulário) estará disponível no URL do formulário  ( core.qntrl.com/blueprint/ <orgName>/<layout>/<formID>). 
    5. Clique em  Execute (Executar) . 
    6. Pressione Ctrl+F no teclado e procure o nome do campo personalizado. Você pode encontrá-lo 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. 
      1. Clique no botão  +Connections (+Conexões) em  Custom Functions (Funções personalizadas) . Uma nova guia  será  aberta em seu navegador.  
      2. Clique em  Add Connection (Adicionar conexão) no canto superior direito. 
      3. Escolha  Zoho Oauth na guia Pick Your Service (Escolha seu serviço) . 
      4. 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,  adicione os detalhes da conexão  ao ao bloco invokeurl  da função personalizada. 
      1.   Por exemplo: conexão : "<nome da conexão>"                  

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



Criar_Tarefa 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 .