g_modal ( Next Experience) - Cliente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 19 min. de leitura

    • . g_modal A API permite que você exiba uma janela modal para aprimorar a funcionalidade da aplicação.

    Use esta API para exibir modais em espaços de trabalho.

    Usando esta API, você pode:
    • Exiba campos de tipo de entrada em uma janela modal.
    • Mostre algo em um quadro, como uma página de IU ou link externo.
    • Execute uma ação na confirmação do usuário.
    • Carregue um componente.
    • Use HTML para preencher o conteúdo de um modal.

    g_modal ( Next Experience ALERT(Título da cadeia de caracteres, mensagem da cadeia de caracteres, retorno de chamada da função, objeto de estilo)

    Exibe uma mensagem de alerta relacionada a uma ação de IU.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Opcional. Título a ser exibido no cabeçalho do modal.

    Padrão: Alerta
    mensagem Cadeia de caracteres Mensagem a ser exibida no corpo modal.
    Nota:
    Se você passar apenas um parâmetro, o método o tratará como messageparâmetro.
    retorno de chamada Função Opcional. Função a ser chamada depois que o formulário for enviado e processado no servidor.
    A função de retorno de chamada tem o formulário CallbackFunction (cadeia de caracteres action_verb, cadeia de caracteres sys_id, tabela de cadeia de caracteres, cadeia de caracteres displayValue) em que:
    • action_verbNome da ação de IU executada. Exemplos:
      • SyVerbo_cancel (botão Cancelar)
      • SyVerbo_insert (botão Enviar)
      • SyVerbo_save (botão Salvar)
    • sys_idSys_id do registro afetado.
    • tableNome da tabela que contém o registro.
    • displayValueValor que aparece no formulário.

    Padrão: Sem processamento adicional
    estilo Objeto Opcional. Estilo do botão de confirmação a ser exibido no modal.
    "style": {
  "buttonTitle": "String",
  "buttonType": "String"
}
    Style.buttonTítulo Cadeia de caracteres Opcional. Texto a ser exibido no botão de confirmação.

    Padrão: OK
    ButtonType Cadeia de caracteres Opcional. Tipo de botão de confirmação a ser exibido.

    Padrão: Padrão
    Tabela 2. Retornos
    Tipo Descrição
    Promessa Se for um callbacko parâmetro é passado, retorna promise bem-sucedido, caso contrário, erro.

    Se for um callbacko parâmetro não foi passado, o método sempre retorna sucesso.

    O exemplo de código a seguir mostra como chamar este método para exibir uma mensagem de alerta "Somente o atribuído a pode encerrar esta ação".

    function onClick(g_form) {

  if (g_user.userID != g_form.getValue('assigned_to')) {
    g_modal.alert('Only the assigned to can end this action.');
    return;
  }

  var msg = getMessage("Are you sure you want to take this action?");
  g_modal.confirm(getMessage("Confirmation"), msg, function (confirmed) {
    if (confirmed) {
      g_form.setValue('state', 'closed_complete');
      g_form.save();
    }
  });

  return false;
}

    g_modal ( Next Experience Confirm (título da cadeia de caracteres, mensagem da cadeia de caracteres, retorno de chamada da função, objeto de estilo)

    Exibe uma mensagem de confirmação relacionada a uma ação de IU.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Opcional. Título a ser exibido no cabeçalho do modal.

    Padrão: Confirmar
    mensagem Cadeia de caracteres Mensagem a ser exibida no corpo modal.
    Nota:
    Se você passar apenas um parâmetro, o método o tratará como messageparâmetro.
    retorno de chamada Função Opcional. Função a ser chamada depois que o formulário for enviado e processado no servidor.
    A função de retorno de chamada tem o formulário CallbackFunction (cadeia de caracteres action_verb, cadeia de caracteres sys_id, tabela de cadeia de caracteres, cadeia de caracteres displayValue) em que:
    • action_verbNome da ação de IU executada. Exemplos:
      • SyVerbo_cancel (botão Cancelar)
      • SyVerbo_insert (botão Enviar)
      • SyVerbo_save (botão Salvar)
    • sys_idSys_id do registro afetado.
    • tableNome da tabela que contém o registro.
    • displayValueValor que aparece no formulário.

    Padrão: Sem processamento adicional
    estilo Objeto Opcional. Estilo dos botões confirmar e cancelar a serem exibidos no modal.
    "style": {
  "cancelTitle": "String",
  "cancelType": "String",
  "confirmTitle": "String",
  "confirmType": "String"
}
    style.cancelTitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Cancelar.

    Padrão: Cancelar
    style.cancelType Cadeia de caracteres Opcional. Tipo de botão de cancelamento a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Confirmar
    Style.confirmTitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Confirmar.

    Padrão: OK
    Type.confirmType Cadeia de caracteres Opcional. Tipo de botão Confirmar a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Padrão
    Tabela 4. Retornos
    Tipo Descrição
    Promessa Se for um callbacko parâmetro é passado, retorna promise bem-sucedido, caso contrário, erro.

    Se for um callbacko parâmetro não foi passado, o método sempre retorna sucesso.

    O exemplo de código a seguir mostra como chamar este método para exibir a mensagem de confirmação "Tem certeza de que deseja executar esta ação?"

    function onClick(g_form) {

  if (g_user.userID != g_form.getValue('assigned_to')) {
    g_modal.alert('Only the assigned to can end this action.');
    return;
  }

  var msg = getMessage("Are you sure you want to take this action?");
  g_modal.confirm(getMessage("Confirmation"), msg, function (confirmed) {
    if (confirmed) {
      g_form.setValue('state', 'closed_complete');
      g_form.save();
    }
  });

  return false;
}

    Saída:


    Captura de tela que mostra o modal Confirmar gerado pelo código

    g_modal ( Next Experience ConfirmDestroy (título da cadeia de caracteres, mensagem da cadeia de caracteres, retorno de chamada da função, objeto de estilo)

    Exibe uma mensagem de confirmação relacionada a uma ação de IU, com o botão Confirmar exibindo um estilo destrutivo.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Opcional. Título a ser exibido no cabeçalho do modal.

    Padrão: Confirmar
    mensagem Cadeia de caracteres Mensagem a ser exibida no corpo modal.
    Nota:
    Se você passar apenas um parâmetro, o método o tratará como messageparâmetro.
    retorno de chamada Função Opcional. Função a ser chamada depois que o formulário for enviado e processado no servidor.
    A função de retorno de chamada tem o formulário CallbackFunction (cadeia de caracteres action_verb, cadeia de caracteres sys_id, tabela de cadeia de caracteres, cadeia de caracteres displayValue) em que:
    • action_verbNome da ação de IU executada. Exemplos:
      • SyVerbo_cancel (botão Cancelar)
      • SyVerbo_insert (botão Enviar)
      • SyVerbo_save (botão Salvar)
    • sys_idSys_id do registro afetado.
    • tableNome da tabela que contém o registro.
    • displayValueValor que aparece no formulário.

    Padrão: Sem processamento adicional
    estilo Objeto Opcional. Estilo dos botões confirmar e cancelar a serem exibidos no modal.
    "style": {
  "cancelTitle": "String",
  "cancelType": "String",
  "confirmTitle": "String",
  "confirmType": "String"
}
    style.cancelTitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Cancelar.

    Padrão: Cancelar
    style.cancelType Cadeia de caracteres Opcional. Tipo de botão de cancelamento a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Confirmar
    Style.confirmTitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Confirmar.

    Padrão: OK
    Type.confirmType Cadeia de caracteres Opcional. Tipo de botão Confirmar a ser exibido.

    Padrão: Destrutivo
    Tabela 6. Retornos
    Tipo Descrição
    Promessa Se for um callbacko parâmetro é passado, retorna promise bem-sucedido, caso contrário, erro.

    Se for um callbacko parâmetro não foi passado, o método sempre retorna sucesso.

    Este exemplo de código mostra como chamar ConfirmDestroy() método para exibir um modal de confirmação com um vermelho OK botão.

    function callback(value){ 
  value ? console.log("confirm destroy callback") : console.log('cancel callback'); 
}

function onClick(g_form) {
  g_modal.confirmDestroy("Confirm Destroy Title", "Confirm Destroy Message", callback, {
    cancelTitle: "Cancel",
    confirmTitle: "Confirm",
    cancelType: "destructive",
    confirmType: "confirm"
  })

  .then( 

    function test() {
      g_form.setValue("state', '7");
    }, 

    function fail() {
      g_form.setValue("state", 2)
    } 
  )
}

    Saída:


    Modal Confirmar destruição

    g_modal ( Next Experience RichText(Título da cadeia de caracteres, cadeia de caracteres richText, retorno de chamada da função, tamanho da cadeia de caracteres, cadeia de caracteres cancelTitle, cadeia de caracteres confirmTitle, cadeia de caracteres cancelType, cadeia de caracteres confirmType, objeto resizableConfig)

    Exibe um modal que usa HTML passado para gerar o conteúdo no modal.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Opcional. Título a ser exibido no cabeçalho do modal.

    Padrão: Em branco
    RichText Cadeia de caracteres Conteúdo HTML a ser exibido no modal.
    Nota:
    Este método remove ]]>JavaScript em linha e outros elementos que podem representar explorações de segurança.
    retorno de chamada Função Opcional. Função a ser chamada depois que o formulário for enviado e processado no servidor.
    A função de retorno de chamada tem o formulário CallbackFunction (cadeia de caracteres action_verb, cadeia de caracteres sys_id, tabela de cadeia de caracteres, cadeia de caracteres displayValue) em que:
    • action_verbNome da ação de IU executada. Exemplos:
      • SyVerbo_cancel (botão Cancelar)
      • SyVerbo_insert (botão Enviar)
      • SyVerbo_save (botão Salvar)
    • sys_idSys_id do registro afetado.
    • tableNome da tabela que contém o registro.
    • displayValueValor que aparece no formulário.

    Padrão: Sem processamento adicional
    Canceltitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Cancelar.

    Padrão: Cancelar
    ConfirmTitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Confirmar.

    Padrão: OK
    CancelType Cadeia de caracteres Opcional. Tipo de botão de cancelamento a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Confirmar
    ConfirmType Cadeia de caracteres Opcional. Tipo de botão Confirmar a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Padrão
    ResizableConfig Objeto Opcional. Parâmetros de configuração para redimensionar o modal associado. Se você não quiser que os usuários possam redimensionar o modal, não passe este parâmetro.
    resizableConfig:
  {
    enableResizable: Boolean,
    resizableMaxHeight: Number,
    resizableMaxWidth: Number,
    resizableMinHeight: Number,
    resizableMinWidth: Number 
  }

    Modal não é redimensionável.
    ResizableConfig. ​AtivarResizável Booliano Sinalizador que indica se os usuários podem redimensionar o modal associado.
    Valores válidos:
    • Verdadeiro: O modal é redimensionável. As alças de redimensionamento aparecem nas bordas do modal.
    • Modal não é redimensionável.

    Padrão: falso
    ResizableConfig. ​RedimensionableMaxHeight Número Altura máxima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Altura da janela.
    ResizableConfig. ​RedimensionableMinHeight Número Altura mínima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: 600px
    ResizableConfig. ​RedimensionableMaxWidth Número Largura máxima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: Largura da janela
    ResizableConfig. ​RedimensionableMinWidth Número Largura mínima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: 380px
    Tabela 8. Retornos
    Tipo Descrição
    Promessa Se for um callbacko parâmetro é passado, retorna promise bem-sucedido, caso contrário, erro.

    Se for um callbacko parâmetro não foi passado, o método sempre retorna sucesso.

    O exemplo de código a seguir mostra como exibir o texto "This is rich text" em negrito no modal associado.

    function callback(value){
  value ? console.log("confirm richtext callback") : console.log('cancel rich text callback'); 
} 

function onClick(g_form) {
  g_modal.richText("RichTextTitle", "<b>This is rich text</b>", callback, {
    cancelTitle: "Rich Cancel",
    confirmTitle: "Rich Confirm"
  }) 

  .then(
    function test() {
      g_form.setValue("state', '7"); 
    }, 

    function fail() {
      g_form.setValue("state", 2) 
    }
  )
}

    Saída:


    Modal de rich text

    g_modal ( Next Experience ShowFields(Título da cadeia de caracteres, Campos de matriz, retorno de chamada da função, Tamanho da cadeia de caracteres, cancelamento da cadeia de caracteres, cadeia de caracteres confirmTitle, cadeia de caracteres cancelType, cadeia de caracteres confirmType, objeto resizableConfig, instrução de cadeia de caracteres)

    Exibe uma janela modal que contém os campos especificados e um OK e. Cancelar botões por padrão.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Opcional. Título a ser exibido no cabeçalho do modal.

    " "
    campos Matriz de objetivos Lista de campos a serem exibidos no modal. Cada campo é definido em um objeto separado. . fieldsos parâmetros que você passa dependem do tipo de campo ( fields.typeespecificado.

    Os campos são exibidos no modal na mesma ordem em que aparecem na matriz.

    fields: [
  {
    autoFocus: Boolean,
    choices: "Array",
    display_value_list: "String",
    enableMentions: Boolean,
    label: "String",
    mandatory: Boolean,
    name: "String",
    referringTable: "String",
    referringRecordId: "String",
    type: "String",
    value: "String"
  }
]
    campos. ​Foco automático Booliano Opcional. Sinalizador que indica se o campo deve ser foco automático por padrão quando o modal é carregado. Somente um campo deve ter este valor definido como verdadeiro.
    Valores válidos:
    • Verdadeiro: Foco automático.
    • Falso: Não focar automaticamente.

    Padrão: falso
    campos. ​opções Matriz de objetivos Necessário se fields.typeo parâmetro está definido como opção . Lista de opções a serem exibidas no campo de lista associado. Cada entrada na lista de seleção deve ser especificada como um objeto separado no opções matriz.
    Por exemplo:
    choices: [
  {
    displayValue: "String",
    value: "String
  }
]
    campos. ​opções. ​Valor de exibição Cadeia de caracteres Opcional. Valor a ser exibido no campo de lista.

    Padrão: Em branco
    fields.choices.value Cadeia de caracteres Opcional. Valor interno do valor exibido no campo de lista.

    Padrão: Nulo
    campos. ​display_value_list Matriz de cadeia de caracteres Opcional. Lista de cadeias de caracteres a serem exibidas. Por exemplo, "item1", "item2", "item3"] .
    campos. ​EnableMenções Booliano Necessário se fields.type. html . Sinalizador que indica se você pode mencionar um usuário no modal.
    Valores válidos:
    • Verdadeiro: Os usuários podem ser mencionados no modal.
    • Falso: Os usuários não podem ser mencionados no modal.

    Padrão: falso
    fields.label Cadeia de caracteres Opcional. Texto a ser exibido como o rótulo deste campo no modal.

    Padrão: Em branco
    campos. ​obrigatório Booliano Opcional. Sinalizador que indica se o campo é obrigatório.
    Valores válidos:
    • Verdadeiro: O campo é obrigatório.
    • Falso: O campo é opcional.

    Padrão: falso
    campos. ​nome Cadeia de caracteres Nome interno do campo. . fields.typeo parâmetro está definido como referência ou glide_list , é o campo de referência no registro atual que está sendo usado para pesquisar.
    Campos​.referringTable Cadeia de caracteres Necessário se fields.typeo parâmetro está definido como referência ou glide_list . Nome da tabela da qual você está fazendo referência.

    Por exemplo: incidente

    campos. ​ReferirRecordId Cadeia de caracteres Necessário se fields.typeo parâmetro está definido como referência . Sys_id do registro que você está chamando no formulário de ação de IU.
    fields.type Cadeia de caracteres Tipo de campo a ser exibido no modal.

    Cada tipo de campo tem um conjunto de fields.<>elementos que podem ser passados. Os valores entre colchetes [ ] abaixo são fieldselementos compatíveis com o associado fieldstipo.

    Valores válidos:

    • booliano [autofocus, rótulo, obrigatório, nome, valor]
    • escolha [autofocus, escolhas, rótulo, obrigatório, nome, valor]
    • Domain_id [rótulo, referringRecordId, referringTable, valor]
    • glide_list [foco automático, display_value_list, rótulo, nome, obrigatório, referringRecordId, referringTable, valor]
    • html [autofocus, enableMentions, rótulo, obrigatório, nome, referringRecordId, referringTable, valor]
    • referência [autofocus, rótulo, obrigatório, nome, referência, referringRecordId, referringTable, valor]
    • cadeia de caracteres [autofocus, rótulo, obrigatório, nome, valor]
    • área de texto [autofocus, rótulo, obrigatório, nome, valor]
    fields.value Cadeia de caracteres Opcional. Valor a ser exibido no campo.

    Por exemplo, para um campo de opção, você pode exibir um prompt do usuário:

    Valor: GetMessage(' -- Selecionar -- ')

    Para um campo de referência, você pode exibir o valor de um campo no formulário associado:

    G_form.getValue('caller_id')

    Padrão: Em branco
    retorno de chamada Função Opcional. Função a ser chamada depois que o formulário for enviado e processado no servidor.
    A função de retorno de chamada tem o formulário CallbackFunction (cadeia de caracteres action_verb, cadeia de caracteres sys_id, tabela de cadeia de caracteres, cadeia de caracteres displayValue) em que:
    • action_verbNome da ação de IU executada. Exemplos:
      • SyVerbo_cancel (botão Cancelar)
      • SyVerbo_insert (botão Enviar)
      • SyVerbo_save (botão Salvar)
    • sys_idSys_id do registro afetado.
    • tableNome da tabela que contém o registro.
    • displayValueValor que aparece no formulário.

    Padrão: Sem processamento adicional
    tamanho Cadeia de caracteres Opcional.
    Tamanho do modal.
    Valores válidos:
    • fw: Largura total
    • sm: 420px por 315px
    • md: 600 px por 450 px
    • lg: 800 px por 600 px
    Nota:
    Se um valor de pixel for especificado, o modal ocupará todo o navegador. Por exemplo, passar "1px" torna o modal de largura total.

    Padrão: sm
    Canceltitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Cancelar.

    Padrão: Cancelar
    ConfirmTitle Cadeia de caracteres Opcional. Texto a ser exibido no botão Confirmar.

    Padrão: OK
    CancelType Cadeia de caracteres Opcional. Tipo de botão de cancelamento a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Confirmar
    ConfirmType Cadeia de caracteres Opcional. Tipo de botão Confirmar a ser exibido.

    Valores válidos:

    • confirmar (fundo azul)
    • padrão (fundo branco)
    • destrutivo (fundo vermelho)

    Padrão: Padrão
    ResizableConfig Objeto Opcional. Parâmetros de configuração para redimensionar o modal associado. Se você não quiser que os usuários possam redimensionar o modal, não passe este parâmetro.
    resizableConfig:
  {
    enableResizable: Boolean,
    resizableMaxHeight: Number,
    resizableMaxWidth: Number,
    resizableMinHeight: Number,
    resizableMinWidth: Number 
  }

    Modal não é redimensionável.
    ResizableConfig. ​AtivarResizável Booliano Sinalizador que indica se os usuários podem redimensionar o modal associado.
    Valores válidos:
    • Verdadeiro: O modal é redimensionável. As alças de redimensionamento aparecem nas bordas do modal.
    • Modal não é redimensionável.

    Padrão: falso
    ResizableConfig. ​RedimensionableMaxHeight Número Altura máxima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Altura da janela.
    ResizableConfig. ​RedimensionableMinHeight Número Altura mínima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: 600px
    ResizableConfig. ​RedimensionableMaxWidth Número Largura máxima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: Largura da janela
    ResizableConfig. ​RedimensionableMinWidth Número Largura mínima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: 380px
    instrução Cadeia de caracteres Opcional. Instruções a serem exibidas no modal. Este conteúdo aparece abaixo do título modal e acima do primeiro campo no modal.

    Padrão: Nenhuma instrução exibida
    Tabela 10. Retornos
    Tipo Descrição
    Promessa Se for um callbacko parâmetro é passado, retorna promise bem-sucedido, caso contrário, erro.

    Se for um callbacko parâmetro não foi passado, o método sempre retorna sucesso.

    O exemplo a seguir mostra o prompt de um usuário para um motivo usando uma janela modal e, em seguida, passá-lo de volta para o campo Anotações de trabalho no registro. . then() o método retorna uma promessa, que retorna o que o modal retorna; FieldValues neste caso. O campo Anotações de trabalho no lado do cliente, com o valor do campo, estão em Campos Atualizados matriz. Como somente um campo é retornado, o exemplo assume uma posição de índice de 0 .

    function onClick(g_form) {
    g_modal.showFields({
        title: "Enter your reason",
        fields: [{
            type: 'textarea',
            name: 'work_notes',
            label: getMessage('Reason'),
            mandatory: true
        }],
        size: 'lg'
    }).then(function(fieldValues) {
        g_form.setValue('work_notes', fieldValues.updatedFields[0].value);
        g_form.save();
    });
}

    Saída:

    Captura de tela do modal produzido pelo código associado.

    O exemplo a seguir expande o exemplo acima, adicionando a opção e os campos de referência.

    function onClick(g_form) {

    var fields = [{
        type: 'textarea',
        name: 'work_notes',
        label: getMessage('Reason'),
        mandatory: true
    },
    {
        type: 'choice',
        name: 'reason_code',
        label: getMessage('Reason code'),
        value: getMessage(' -- Select -- '),
        choices: [
          {
            displayValue: 'Duplicate',
            value: 'duplicate'
          },
          {
            displayValue: 'Canceled',
            value: 'canceled'
          }
        ],
        mandatory: true
    },
    {
        type: 'reference',
        name: 'caller_id',
        label: getMessage('What is your name?'),
        mandatory: true,
        reference: 'sys_user',
        referringTable: 'incident',
        referringRecordId: g_form.getUniqueValue(),
	 value: g_form.getValue('caller_id'),
	 displayValue: g_form.getDisplayValue('caller_id')
    }
  ];

  g_modal.showFields({
    title: "Enter your reason",
    fields: fields,
    size: 'lg'
  }).then(function(fieldValues) {
        g_form.setValue('work_notes', fieldValues.updatedFields[0].value);
        g_form.setValue('caller_id', fieldValues.updatedFields[2].value);
        g_form.save();
  });
}

    Saída:

    Captura de tela do modal produzido pelo código associado.

    O exemplo a seguir mostra como usar esse método para exibir um modal que contém os tipos de campo textarea, choices, reference, glide_list e domain_id.

    function onClick(g_form) {
  var fields = [
    {
      type: 'textarea',
      name: 'work_notes',
      label: getMessage('Reason'),
      mandatory: true
    },
    {
      type: 'choice',
      name: 'reason_code',
      label: getMessage('Reason code'),
      value: getMessage(' -- Select -- '),
      choices: [
        {
          displayValue: 'Duplicate',
          value: 'duplicate'
        },
        {
          displayValue: 'Canceled',
          value: 'canceled'
        }
      ],
      mandatory: true
    },
    {
      type: 'reference',
      name: 'caller_id',
      label: getMessage('What is your name?'),
      mandatory: true,
      referringTable: 'incident',
      referringRecordId: g_form.getUniqueValue(),
      value: g_form.getValue('caller_id')
    },
    {
      type: 'glide_list',
      name: 'watch_list',
      label: 'A list', 
      mandatory: false,
      referringTable: 'incident',
      referringRecordId: g_form.getUniqueValue(),
      value: '628,9ee1,f298d',
      display_value_list: ['item1', 'item2', 'item3']
    },
    {
      label: 'Domain ID',
      type: 'domain_id',
      value: 'c90d4b084a362312013398f051272c0d',
      displayValue: 'TOP/ACME',
      referringRecordId: '552c48888c033300964f4932b03eb092',
      referringTable: 'incident'
    }
  ];

  g_modal.showFields({
    title: "Enter your reason",
    fields: fields,
    size: 'lg'
  }).then(function(fieldValues) {

  });
}

    Saída:


    Captura de tela modal

    g_modal ( Next Experience ShowFrame(título da cadeia de caracteres, url da cadeia de caracteres, retorno de chamada da função, tamanho da cadeia de caracteres, altura da cadeia de caracteres, cadeia de caracteres modalHeight, cadeia de caracteres modalWidth, booliano showClose, cadeia de caracteres autoCloseOn, booliano hasLoadingMessage, booliano closeOnEscape, booliano hideOverlay, Object resizableConfig)

    Exibe um modal que usa um link para um URL externo ou página de IU para seu conteúdo.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Opcional. Título a ser exibido no cabeçalho do modal.

    Padrão: Em branco
    URL Cadeia de caracteres URL das informações a serem carregadas no iFrame.
    Nota:
    Se apenas um argumento for aprovado, ele será tratado como urlparâmetro.
    retorno de chamada Função Opcional. Função a ser chamada depois que o formulário for enviado e processado no servidor.
    A função de retorno de chamada tem o formulário CallbackFunction (cadeia de caracteres action_verb, cadeia de caracteres sys_id, tabela de cadeia de caracteres, cadeia de caracteres displayValue) em que:
    • action_verbNome da ação de IU executada. Exemplos:
      • SyVerbo_cancel (botão Cancelar)
      • SyVerbo_insert (botão Enviar)
      • SyVerbo_save (botão Salvar)
    • sys_idSys_id do registro afetado.
    • tableNome da tabela que contém o registro.
    • displayValueValor que aparece no formulário.

    Padrão: Sem processamento adicional
    tamanho Cadeia de caracteres Opcional. Tamanho do modal.
    Valores válidos:
    • fw: Largura total
    • sm: 420px por 253,25px
    • md: 600 px por 253,25 px
    • lg: 800 px x 254 px

    Padrão: lg
    altura Cadeia de caracteres Opcional. Altura da seção de conteúdo no modal. Este valor está no formato "<number> <unit>", como "80%" ou "300px". Se você passar apenas um número, o método presume que a unidade de medida é pixels.
    Unidades de medida válidas:
    • %
    • em
    • px
    • vh

    Padrão: 100% ou 153,75px
    ModalHeight Cadeia de caracteres Opcional. Altura do modal. Este valor está no formato "<number> <unit>", como "80%" ou "300px". Se você passar apenas um número, o método presume que a unidade de medida é pixels.
    Unidades de medida válidas:
    • %
    • em
    • px
    • vh

    Padrão: 254 px
    ModalWidth Cadeia de caracteres Opcional. Largura do modal. Este valor está no formato "<number> <unit>", como "80%" ou "300px". Se você passar apenas um número, o método presume que a unidade de medida é pixels.
    Unidades de medida válidas:
    • %
    • em
    • px
    • vh

    Padrão: 800px
    MostrarFechar Booliano Opcional. Sinalizador que indica se o ícone Fechar (X) aparece no canto superior direito do modal.
    Valores válidos:
    • Verdadeiro: Exiba o ícone Fechar.
    • Falso: Não exiba o ícone Fechar.

    Padrão: verdadeiro
    Encerramento automático Cadeia de caracteres Opcional. Condição na qual fechar automaticamente o modal.
    Valores válidos:
    • EMPTY_BODY
    • URL_CHANGED

    Modal: Não fechar automaticamente.
    HasCarregar Mensagem Booliano Opcional. Sinalizador que indica se o deve ser exibido Carregando... mensagem no slot de conteúdo do modal antes de carregar o conteúdo modal.
    Valores válidos:
    • Verdadeiro: Exibe a mensagem de carregamento.
    • Falso: Não exibe a mensagem de carregamento. O slot de conteúdo do modal está vazio antes que o conteúdo seja carregado.
    Nota:
    "Carregando..." configurar somente se ela será exibida ou não.

    Padrão: falso
    EncerraemEscape Booliano Opcional. Sinalizador que indica se o usuário pode fechar o modal pressionando a tecla escape.
    Valores válidos:
    • Verdadeiro: O modal fecha quando o usuário pressiona a tecla escape.
    • Modal não fecha quando o usuário pressiona a tecla escape.

    Padrão: falso
    HideOverlay Booliano Opcional. Sinalizador que indica se a sobreposição cinza transparente deve ser exibida sobre a página de registro.
    Valores válidos:
    • Verdadeiro: Oculte a sobreposição cinza transparente sobre a página de registro.
    • Falso: Exiba a sobreposição cinza transparente sobre a página de registro.

    Padrão: falso
    ResizableConfig Objeto Opcional. Parâmetros de configuração para redimensionar o modal associado. Se você não quiser que os usuários possam redimensionar o modal, não passe este parâmetro.
    resizableConfig:
  {
    enableResizable: Boolean,
    resizableMaxHeight: Number,
    resizableMaxWidth: Number,
    resizableMinHeight: Number,
    resizableMinWidth: Number 
  }

    Modal não é redimensionável.
    ResizableConfig. ​AtivarResizável Booliano Sinalizador que indica se os usuários podem redimensionar o modal associado.
    Valores válidos:
    • Verdadeiro: O modal é redimensionável. As alças de redimensionamento aparecem nas bordas do modal.
    • Modal não é redimensionável.

    Padrão: falso
    ResizableConfig. ​RedimensionableMaxHeight Número Altura máxima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Altura da janela.
    ResizableConfig. ​RedimensionableMinHeight Número Altura mínima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: 600px
    ResizableConfig. ​RedimensionableMaxWidth Número Largura máxima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: Largura da janela
    ResizableConfig. ​RedimensionableMinWidth Número Largura mínima redimensionável do modal.

    Tipo de dados: Número

    Unidade: Pixels

    Padrão: 380px
    Tabela 12. Retornos
    Tipo Descrição
    Promessa Retorna Promise bem-sucedido, caso contrário, erro. Esta promessa é resolvida quando o modal IFrame é encerrado.

    O exemplo a seguir mostra como exibir um artigo da base de conhecimento em um modelo usando o sys_id do registro do artigo da base de conhecimento e uma URL de base.

    function onClick(g_form) {
  var kbId = '24d9243187032100deddb882a2e3ec33'; //sysId of KB article
  g_modal.showFrame({
    url: '/kb_view.do?sys_kb_id=' + kbId,
    title: 'Test Knowledge Article',
    size: 'lg',
    height: 500px
  });
}

    Saída:

    Captura de tela do modal gerado pelo código

    Este exemplo mostra como usar uma página de IU integrada ao criar um modal. Ele usa Window.parent.postMessage() Na página de IU para passar dados do iFrame de volta para o espaço desde g_form A API não está acessível em uma página de IU quando está no iFrame.

    function onClick(g_form) {
  function proposeMIC(data) {
    var workNotes = data.msg + "\n" + data.workNotes;
    var notes = g_form.getValue('work_notes') + ' ' + workNotes;
    var bi = g_form.getValue('business_impact') + ' ' + data.businessImpact;
    g_form.setValue('work_notes', notes.trim());
    g_form.setValue('business_impact', bi.trim());
    g_form.submit('sysverb_mim_propose');
  }
	
  function openPopup() {
    if(!g_form.getControl('work_notes')) {
      getMessage('Cannot propose major incident as "Worknotes" is not visible', function(msg) {
	 g_form.addErrorMessage(msg);
      });
      return false;
    }

    var url = "/sn_major_inc_mgmt_mim_propose.do?sysparm_stack=no&sysparm_workspace=" + true;
    g_modal.showFrame({
      title: getMessage("Propose Major Incident"),
      url: url,
      size: 'lg',
      autoCloseOn: 'URL_CHANGED',
      callback: function (ret, data) {
        if (ret)
          proposeMIC(data);
      }
    });
  }
	
  openPopup();
}

    Saída:


    Captura de tela do modal gerado pelo código