Preenchimento de valores de variáveis no formulário de item do catálogo no portal e. Next Experience UIS

  • Versão de lançamento: Zurich
  • Atualizado 19 de ago. de 2025
  • 3 min. de leitura
  • Quando os solicitantes de item do catálogo desejam solicitar itens em portais ou Next Experience IU, você pode definir os itens do catálogo para usar os pares chave-valor, que preenchem previamente os valores das variáveis. Os solicitantes podem concluir formulários mais rapidamente.

    Os valores definidos por este método são aplicados como se fossem valores fornecidos pelo usuário. Comportamentos dinâmicos (políticas de IU do catálogo, scripts de cliente do catálogo e assim por diante) funcionam para esses valores.

    Esta propriedade está habilitada por padrão. Para desativar este recurso, você pode definir glide.sc.enable_url_prefillpropriedade como falsa.

    Preenchimento de formulários em portais

    Você pode configurar itens do catálogo em portais como Portal de serviços ou Central do funcionário Para preencher previamente formulários modificando o URL.
    Nota:
    Em portais, você pode encontrar a opção de instância de widget chamada Desabilitar pré-preenchimento de URL . Esta caixa de seleção está desativada por padrão. Selecione esta opção para desabilitar o pré-preenchimento de URL nesse portal específico.
    Para configurar o pré-preenchimento, você pode executar as seguintes ações:
    1. Usar um parâmetro de URL, sysparm_variable_values, para construir os pares de chave-valor. No par chave-valor, chave é o nome da variável e valor é o valor dessa variável.
      Nota:
      O valor de uma variável de referência deve ser um sys_id.
    2. Forneça o valor como um parâmetro de URL de sysparam_variable_values. Por exemplo, se você quiser definir Departamento "Vendas" e. Justificativa de negócios Como "integração do funcionário", use o seguinte URL.

      /sp?id=sc_cat_item&sys_id=e56a7ffe41011300964ff05369414ebd&sysparm_variable_values={"business_justification":"employee onboarding", "department":"221db0edc611228401760aec06c9d929"}

    3. Para testar o URL, você pode adicionar o URL na barra de endereço do navegador e abri-lo.

      Você pode observar que Departamento O campo é preenchido previamente com o valor "Vendas" e Justificativa de negócios o campo é preenchido previamente com o valor "integração do funcionário" no carregamento.

      As seguintes variáveis não são compatíveis com pré-preenchimento:
      • Anexo
      • Personalizado
      • Personalizado com rótulo
      • Tipos de variáveis sem entrada, como rótulo, contêiner
      • Mascarado
      • Página da interface do usuário
      • Conjunto de variáveis de várias linhas (MRVS)

      A ordem em que esses valores de variáveis são pré-preenchidos é a ordem em que as variáveis são definidas no formulário de item do catálogo.

    Preenchimento de formulários em Next Experience UIS

    Configure pares de chave-valor para preencher previamente os formulários de solicitação de item do catálogo Next Experience UIS. Para Next Experience UIS, os pares de chave-valor são enviados diretamente para o componente como uma propriedade de entrada.

    Quando o item do catálogo ou formulário é renderizado depois que o usuário seleciona o item, esses pares de chave-valor são passados para o componente como um objeto. Em seguida, o componente analisa o objeto e preenche o formulário adequadamente.

    Para configurar os pares de chave-valor, execute estas etapas:
    1. Navegar até Tudo > Estrutura do Now Experience > Experiências.
    2. Selecione a aplicação de UX para a qual você deseja definir valores de pré-preenchimento.
    3. Selecione Abra no Construtor de IU .
    4. Abra a página com o item do catálogo para o qual você deseja definir os valores de pré-preenchimento.
    5. No macroponent do item do catálogo, use a propriedade variableValues.
    6. Edite a propriedade para adicionar um par de chave-valor, conforme mostrado na imagem a seguir. exemplo de par chave-valor
    7. Depois de fornecer o par chave-valor, salve o item e selecione Visualização > Abrir caminho do URL.

    Preenchimento de formulários para itens do catálogo em linha no Virtual Agent

    Você pode definir valores de pré-preenchimento para o formulário de item do catálogo em linha usado em Virtual Agent.

    Para configurar o pré-preenchimento de formulários para itens do catálogo em linha, execute estas etapas:
    1. Abra o tópico, por exemplo, Solicitar item do catálogo em linha sísmico.
    2. Na propriedade variableValues, forneça os pares de chave-valor como um objeto JSON de cadeia.

    Há duas maneiras de configurar este recurso. Você pode fornecer um objeto JSON de cadeia ou escrever um script.

    Neste exemplo, conforme mostrado na imagem, há duas variáveis, Justificação de departamento e negócio. Defina o valor como verdadeiro para ambas as variáveis. Você pode especificar "Departamento" como "Vendas" e "Justificação comercial" como "Integração do funcionário".Exemplo de pré-preenchimento de formulários para itens do catálogo em linha no Virtual Agent

    Depois de configurar isso, quando os solicitantes solicitam itens, eles veem os formulários pré-preenchidos.