Expor dados dinamicamente nas páginas do Construtor de IU (recurso avançado)

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura
  • Sincronizar dados entre ServiceNow tabelas e dados com as páginas com as quais você cria Construtor de IU. As páginas exibem dados sincronizados em tempo real e atualizam dados/tabelas quando um usuário insere informações.

    Aprendendo sobre recursos de dados em Construtor de IU

    Construtor de IUsincronizações ServiceNowtabelas/dados usando recursos de dados. Um recurso de dados busca os dados que o Construtor de IU usa para exibir informações em um componente. Construtor de IUos componentes usam recursos de dados para sincronizar dados em diferentes experiências. Os recursos de dados tornam os dados nos componentes dinâmicos, o que significa que você não precisa recriar dados para cada página.

    Pilha de recursos de dados que distribui dados para várias páginas.

    Os recursos de dados são encontrados no compartimento de recursos de dados. O compartimento de recursos de dados é onde você pode adicionar e configurar um recurso de dados para sua página. Depois de configurar o recurso de dados, você pode sincronizar os dados entre os componentes na sua página e. ServiceNowtabelas/dados .

    Figura 1. Recurso de dados Gaveta
    Seta apontando para a gaveta de recursos de dados no Construtor de IU.
    O compartimento de recursos de dados contém três seções:
    • Recursos de dados: Os recursos de dados que fazem parte da experiência
    • Configuração/eventos: Recursos de dados configurados e eventos para a experiência
    • Visualização: JSON para as informações retornadas pelo recurso de dados

    Você pode vincular as propriedades de configuração de componentes, outros recursos de dados, scripts de cliente, estado do cliente e eventos a esses recursos de dados.

    Defina condições para um filtro em seu recurso de dados. Para obter mais informações, consulte Conectar dados a seus componentes.

    Como os recursos de dados funcionam no Construtor de IU

    Os recursos de dados buscam dados das APIs Glide, GraphQL e REST e os transformam para uso em um componente em um Construtor de IUpágina.

    Os componentes usam instâncias de recursos de dados herdados e locais. Os recursos de dados herdados são carregados automaticamente em um Construtor de IUe instâncias de recurso de dados locais podem ser adicionadas e configuradas. Os recursos de dados são avaliados com base nos valores de entrada especificados para garantir que os dados corretos sejam recuperados. Para obter mais informações sobre recursos de dados herdados e locais, consulte Recursos de dados herdados versus locais em Construtor de IU.

    Recursos de dados locais em Construtor de IU

    Você pode selecionar recursos de dados locais, como dados do servidor, operações, transformações ou dados do cliente, como a API gForm, para trazer dados para o. Construtor de IUpágina.
    Nota:
    Apenas um GlideForm é compatível por página em Construtor de IU. Para obter mais informações sobre GlideForm, consulte Site do desenvolvedor da ServiceNow .
    Os recursos de dados são organizados por aplicação no compartimento de recursos de dados. Em seguida, eles são categorizados ainda mais pelo tipo de recurso de dados, como dados do servidor ou transformação. Por exemplo, a aplicação global tem vários recursos de dados, mas Customer Service Management (CSM)A aplicação do espaço tem apenas alguns recursos de dados.
    Figura 2. Recursos de dados
    Modal de seleção de recursos de dados.

    Você vê diferentes recursos de dados dependendo da aplicação em que você está. Se você selecionar a aplicação global, verá recursos de dados diferentes em Dados do servidor do que se você selecionar CSMAplicação do espaço configurável.

    Usando vinculação de dados em Construtor de IU

    A vinculação de dados permite que você crie páginas dinâmicas sincronizando páginas e componentes com recursos de dados. Você pode vincular dados a um componente para recuperar dados do back-end e usar parâmetros de campo para obter propriedades do URL. A mudança dos parâmetros de URL permite criar páginas dinâmicas que mostram dados diferentes, dependendo dos parâmetros.

    Você pode vincular dados a um componente das seguintes maneiras:

    Vinculação de contexto

    Use parâmetros de URL para conectar partes do URL às propriedades da sua página. Por exemplo, você pode vincular o nome da tabela da URL ao seu componente usando a sintaxe de contexto, como esta: a context.props.table .

    Imagine que você tem um Construtor de IUpágina com um campo obrigatório chamado tabela . O URL da sua página pode ser parecido com /demo/page/<table-name>. O <table-name> poderia ser algo como incidente . Os dados também podem vir de recursos de dados primários ou ser propriedades locais específicas da página.

    Para vincular as propriedades do componente, outras propriedades do recurso de dados ou detalhes do evento à propriedade da página, use um a context.props.table vinculação. Certifique-se de fornecer um valor de teste no URL ou definir um valor fixo para essa propriedade na configuração da sua página se você estiver usando a vinculação de contexto.

    Vinculação de recurso de dados

    Use recursos de dados para buscar dados do back-end da instância, como Estado do cliente, GraphQL ou uma REST API. Essas fontes de dados têm propriedades que podem ser vinculadas a elementos em um Construtor de IUpágina.

    Por exemplo, se você estiver usando o recurso de dados Registro de pesquisa, poderá utilizá-lo em um componente de botão. Você pode usar uma expressão de dados na propriedade "rótulo" como esta: Lookup_record_1.result.number.displayValue .

    Vinculação de componente
    Use a vinculação de componente para conectar um componente a outro. Digamos que você tenha um componente de Menu de lista no Construtor de IUpágina. O Menu de lista revela a lista escolhida no momento para outros componentes na mesma página. Esses outros componentes podem acessar os dados vinculando-os a eles usando uma expressão como A elements.list_menu_1.selectedListId .
    Vinculação do parâmetro de estado do cliente

    Use a vinculação de parâmetro de estado do cliente para conectar e sincronizar dados entre uma aplicação do lado do cliente e. Construtor de IUcomponentes. A vinculação de parâmetros permite que o estado do cliente atualize automaticamente os dados nos componentes e vice-versa. Uso no estado sintaxe para vincular uma propriedade de estado a um parâmetro de estado do cliente.

    Tipos de fontes de dados disponíveis em Construtor de IU

    Você pode usar os seguintes tipos de recursos de dados mostrados na tabela.

    Tabela 1. Tipos de recursos de dados
    Tipo do recurso de dados Descrição
    Controlador Encapsula dados e lógica de evento e habilita predefinições para componentes.
    GraphQL Consultas GraphQL e mutações que são executadas.
    Transformação Script que transforma os dados de entrada em outro formato.
    Estado do cliente Recursos de dados do lado do cliente que incluem as informações do cliente, estados ou lógica específicos do domínio, preferências do usuário e assim por diante.
    Composto Único recurso de dados reutilizável que contém vários recursos de dados.
    REST Recursos de dados feitos por meio de solicitações da REST API.

    Recursos de dados herdados versus locais em Construtor de IU

    Os recursos de dados herdados compartilham informações das partes circundantes de um Construtor de IUuma página como uma aplicação. Imagine que sua página está em um quadro grande e ela obtém algumas informações do quadro ou de outras partes ao redor dele. Você pode usar essas informações conetando-as às propriedades da sua página, como vincular peças do quebra-cabeça. Se você obter essas informações do porta-retratos, não precisará obtê-las novamente.

    Diagrama que mostra a diferença entre recursos de dados herdados e locais.

    Os recursos de dados locais são itens que você adiciona a um Construtor de IUpágina para você mesmo. Imagine que você está criando uma página para solicitações de viagem. Você pode sincronizar dados do funcionário com um componente de lista para que os funcionários possam solicitar viagens vinculadas a suas próprias informações.

    Para usar esses recursos de dados, traga-os de um app ou crie-os no ServiceNowplataforma. Em seguida, em Construtor de IU, disponibilize esses recursos para seus componentes. Em seguida, vincule os dados ao seu componente para que ele possa trabalhar com ele. Por exemplo, você pode ter um conjunto de registros, expô-lo no Construtor de IU e vinculá-lo a um componente. A partir daí, configure o componente para fazer coisas com os dados, como salvar novos registros.

    Quando sua página estiver sincronizando dados, você a coneta à parte da página que precisa deles, como um componente. É como garantir que a peça certa do quebra-cabeça se encaixa no lugar certo. Em seguida, você pode dizer a essa parte da página o que fazer com os dados. Por exemplo, você pode usá-lo para adicionar novos planos de viagem para funcionários.

    Construtor de IU Propriedades do recurso de dados

    Quando você adiciona um recurso de dados em Construtor de IU, é como adicionar uma ferramenta que sabe de onde obter informações. As propriedades do recurso de dados são as instruções que informam um recurso de dados como trazer dados para Construtor de IUpáginas. Essas propriedades informam ao recurso de dados quais dados obter, como organizá-los e quais condições seguir. Por exemplo, você pode usar essas propriedades para especificar quais tabelas serão pesquisadas, como classificar os dados e muito mais. Essas propriedades são o que fazem o recurso de dados funcionar corretamente e fornecem os dados de que você precisa.

    Depois de adicionar um recurso de dados, você pode optar por carregá-lo com entusiasmo ou explicitamente. Use as descrições abaixo para determinar qual abordagem melhor se adapta à sua página. Essa decisão pode afetar o desempenho, a experiência do usuário e a eficiência dos recursos, por isso é importante entender as diferenças.
    Imediatamente (avaliação ansiosa)
    Os dados são carregados automaticamente quando a página ou o componente é carregado.
    Útil para o conteúdo principal que o usuário espera ver imediatamente.
    Pode retardar o carregamento de páginas e componentes buscando dados não utilizados.
    Somente quando invocado (avaliação explícita)
    Adia o carregamento de dados até que um usuário execute uma ação específica. Por exemplo, clicar em um botão ou inserir dados em um campo.
    Busca dados somente quando necessário.
    Acelera o carregamento inicial da página.
    Figura 3. Opções de avaliação de recursos de dados
    Seta que aponta para o menu suspenso Quando avaliar este recurso de dados.

    Construtor de IU Scripts de recursos de dados

    Os scripts de recursos de dados são instruções especiais que você fornece Construtor de IUpara retornar partes específicas de dados. Por exemplo, se você estiver lidando com uma lista de produtos, um script poderá dizer a um recurso de dados para mostrar somente produtos que estão disponíveis em estoque ou organizá-los em uma ordem específica. Os scripts de recursos de dados permitem personalizar como Construtor de IUtrata as informações, como adicionar regras ou ações extras.