Expor dados dinamicamente nas páginas do Construtor de IU (recurso avançado)
Sincronize dados entre ServiceNow tabelas e dados com as páginas criadas com Construtor de IU. As páginas exibem dados sincronizados em tempo real e atualizam dados/tabelas quando um usuário insere informações.
Saiba mais sobre recursos de dados no Construtor de IU
Construtor de IU sincroniza ServiceNow tabelas/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 IU 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.
Os recursos de dados são encontrados na gaveta de recursos de dados. A gaveta 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 em sua página e ServiceNow tabelas/dados.
- Recursos de dados: os recursos de dados que fazem parte da experiência do
- Configuração/eventos: recursos de dados e eventos configurados para a experiência
- Visualização: JSON das informações retornadas pelo recurso de dados
Você pode vincular as propriedades de configuração para 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 Conecte dados aos 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 uma página Construtor de IU.
Os componentes usam instâncias de recursos de dados herdados e locais. Os recursos de dados herdados são carregados automaticamente em uma página Construtor de IU e as instâncias de recursos 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 locais e herdados, consulte Recursos de dados herdados versus locais em Construtor de IU.
Recursos de dados locais em Construtor de IU
Você vê diferentes recursos de dados, dependendo da aplicação em que está. Se você selecionar a aplicação Global, verá recursos de dados diferentes em Dados do servidor do que se você selecionar a aplicação CSM Espaço configurável.
Como usar vinculação de dados no Construtor de IU
A vinculação de dados permite criar 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. Alterar os 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 do URL ao seu componente usando a sintaxe @context, como esta:
@context.props.table.Imagine que você tem uma página Construtor de IU com um campo obrigatório chamado
tabela. A URL da sua página pode ser /demo/page/<table-name> . O<table-name> pode ser algo comoincidente. 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 de recursos de dados ou detalhes do evento à propriedade da página, você usa uma vinculação
@context.props.table. Certifique-se de fornecer um valor de teste no URL ou de 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 sua instância, como Estado do cliente, GraphQL ou REST API. Essas fontes de dados têm propriedades que podem ser vinculadas a elementos em uma página Construtor de IU.
Por exemplo, se você estiver usando o recurso de dados Pesquisar registro, poderá utilizá-lo em um componente de botão. Você pode usar uma expressão de dados na propriedade "label" como esta:
@data.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 na página Construtor de IU. O Menu de lista revela a lista selecionada 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
@elements.list_menu_1.selectedListId. - Vinculação de 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 componentes Construtor de IU. A vinculação de parâmetro permite que o estado do cliente atualize automaticamente os dados nos componentes e vice-versa. Use a sintaxe
@statepara vincular uma propriedade de estado a um parâmetro de estado do cliente.
Tipos de fontes de dados disponíveis no Construtor de IU
Você pode usar os seguintes tipos de recursos de dados que são mostrados na tabela.
| Tipo do recurso de dados | Descrição |
|---|---|
| Controlador | Encapsula dados e lógica de evento e habilita predefinições para componentes. |
| GraphQL | Consultas e mutações do GraphQL 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 | Recurso de dados reutilizável único que contém vários recursos de dados. |
| REST | Recursos de dados que são feitos por meio de solicitações de REST API. |
Recursos de dados herdados versus locais em Construtor de IU
Os recursos de dados herdados compartilham informações das partes adjacentes de uma página Construtor de IU, como uma aplicação. Imagine que sua página está em um quadro grande e obtém algumas informações do quadro ou de outras partes ao seu redor. Você pode usar essas informações conectando-as às propriedades da sua página, como se estivesse vinculando peças de quebra-cabeça. Se você obtiver essas informações do quadro, não precisará obtê-las novamente.
Recursos de dados locais são itens que você adiciona a uma página Construtor de IU. Imagine que você está criando uma página para solicitações de viagem. Você pode sincronizar os dados do funcionário com um componente de lista para que os funcionários possam solicitar viagens vinculadas às suas próprias informações.
Para usar esses recursos de dados, traga-os de um app ou crie-os na plataforma ServiceNow. Em seguida, em Construtor de IU, disponibilize esses recursos para seus componentes. Em seguida, vincule os dados ao seu componente para que possam funcionar 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ê os conectará à parte da página que precisa deles, como um componente. É como garantir que a peça certa do quebra-cabeça se encaixe no lugar certo. Em seguida, você pode informar 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 a um recurso de dados como trazer dados para Construtor de IU páginas. Essas propriedades informam a um 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 procurar, como classificar os dados e muito mais. Essas propriedades são o que faz o recurso de dados funcionar corretamente e fornecem os dados necessários.
Construtor de IU Scripts de recursos de dados
Os scripts de recursos de dados são instruções especiais que você fornece Construtor de IU para retornar dados específicos. Por exemplo, se você estiver lidando com uma lista de produtos, um script poderá informar a um recurso de dados para mostrar somente os produtos que estão disponíveis em estoque ou organizá-los em uma ordem específica. Os scripts de recursos de dados permitem que você personalize como Construtor de IU trata as informações, como adicionar regras ou ações extras.