Visualizar

Criação de definições de ação

Para associar os campos de entrada da Ação aos campos do Apps, você precisa de uma definição de Ação.

1. Preparando a definição da ação

Antes de adicionar a definição de Ação ao Action Center, você deve criar um esquema JSON para ela. O arquivo deve seguir o padrão do esquema JSON. Você também pode baixar o esquema de amostra, editar e carregar uma versão modificada dele.

1. Comece adicionando uma chave de abertura para indicar o início do objeto JSON.
2. Dentro do objeto JSON, defina as propriedades Name e Description como strings, junto com seus valores.

   {
       "Name": "Sample Definition",
       "Description": "Sample Definition Description"

3. Adicione uma propriedade Allowed Actions como uma matriz de strings para especificar as ações permitidas que você pode realizar no final da ação. Os valores devem ser o equivalente a Aprovar ou Rejeitar.

   "AllowedActions": [
           "Start On-boarding",
           "Request more details"
       ],

4. Adicione uma propriedade Schema e atribua a ela um objeto que siga o padrão do Esquema JSON: http://json-schema.org/draft-07/schema#.

   "Schema": {
           "$schema": "http://json-schema.org/draft-07/schema#",
           "type": "object",

5. Dentro do objeto properties , defina cada propriedade que você deseja incluir no esquema. Para cada propriedade, especifique seu type e description.
   Cada propriedade no Schema é equivalente aos campos de entrada que você adicionará na ação do aplicativo.

   "properties": {
               "employee_id": {
                   "type": "string",
                   "description": "The unique identifier of the employee."
               },
               "first_name": {
                   "type": "string",
                   "description": "The first name of the employee."
               },
               "last_name": {
                   "type": "string",
                   "description": "The last name of the employee."
               },
               "email": {
                   "type": "string",
                   "format": "email",
                   "description": "The email address of the employee."
               },
               "address": {
                   "type": "object",
                   "properties": {
                       "street": {
                           "type": "string",
                           "description": "The street address of the employee."
                       },
                       "city": {
                           "type": "string",
                           "description": "The city where the employee resides."
                       },
                       "state": {
                           "type": "string",
                           "description": "The state where the employee resides."
                       },
                       "zip_code": {
                           "type": "string",
                           "description": "The zip code of the employee's address."
                       },
                       "country": {
                           "type": "string",
                           "description": "The country where the employee resides."
                       }
                   },
                   "required": [
                       "street",
                       "city",
                       "state",
                       "zip_code",
                       "country"
                   ],
                   "description": "The address of the employee."
               },
               "hire_date": {
                   "type": "string",
                   "format": "date",
                   "description": "The date the employee was hired in the format YYYY-MM-DD."
               },
               "salary": {
                   "type": "number",
                   "minimum": 0,
                   "description": "The salary of the employee."
               }
           }

   Se você tiver objetos aninhados, como address, de acordo com este exemplo, defina-os de forma semelhante dentro do objeto properties , especificando seu tipo e propriedades.
6. Se determinadas propriedades forem necessárias, inclua uma matriz required , na qual você lista as propriedades que deseja marcar como obrigatórias na ação.

   "required": [
               "employee_id",
               "first_name",
               "last_name",
               "email",
               "address",
               "salary",
               "hire_date"
           ]

7. Feche o objeto JSON adicionando uma chave de fechamento.

2. Carregamento da definição de ação para o Action Center

Após criar o esquema JSON da definição da ação, você pode carregá-lo no Action Center.

1. Abra o Action Center, navegue até Configurações de administrador e selecione Tenant.
2. Na guia Definições de ação , selecione Adicionar definição de ação.
3. Selecione Baixar exemplo de definição de ação para baixar um exemplo de esquema JSON para ajudar você a preparar a definição de ação.
4. Selecione Importar do arquivo e selecione o arquivo JSON que você preparou anteriormente.
5. Insira um nome e descrição apropriados para a definição da Ação e, em seguida, selecione Criar.

Resultado: agora é possível adicionar a definição da Ação como um Controle para o seu aplicativo de Ação dentro do App Studio.