Configure um item de dados de relacionamento para uma lista integrada

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Configure itens de dados de relacionamento para que você possa controlar as informações que aparecem em listas integradas em uma tela de registro.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Um item de dados de relacionamento é necessário para criar uma lista integrada. Listas integradas são listas que podem ser incorporadas em uma tela de registro. Para obter mais informações sobre listas integradas em dispositivos móveis, consulte Listas integradas para uma tela de registro.

    Procedimento

    1. Navegar até Tudo > Sistema Móvel > Construtor de apps para celular.
      . Construtor de apps para celular abre em uma nova guia do navegador e exibe a tela de seleção do escopo da aplicação.
    2. PESQUISE o escopo da aplicação em que você está trabalhando e selecione o nome do escopo da aplicação.
      . Construtor de apps para celular a tela inicial de categorias é exibida.
    3. Selecione Dados no menu e selecione Novo .
    4. Selecione Item de dados de relacionamento e selecione Continuar .
    5. Preencha os seguintes campos conforme necessário.
      Tabela 1. Campos de item de dados de relacionamento
      Campo Descrição
      Seção Propriedades:
      Nome Um título para o item de dados. Você pode ter vários itens de dados com o mesmo nome. Certifique-se de que este nome seja exclusivo para que você possa encontrá-lo facilmente.
      Descrição Detalhes adicionais opcionais sobre o item de dados.
      Seção de dados:
      Tabela A tabela da qual você deseja que o item de dados extraia informações. Esta tabela é a tabela de registros que está incorporada como lista na tela de registro primário.
      Nota:
      Tabelas personalizadas não estão disponíveis por padrão. Você pode mudar esse comportamento modificando o. subscription.custom_table.enforce_entitlementpropriedade do sistema. Para obter detalhes sobre como fazer essa mudança, consulte Permita ou restrinja o acesso a tabelas personalizadas em itens de dados móveis.
      Agrupar por Agrupa os resultados da consulta com base no campo selecionado no menu.
      Tabela relacionada a Tabela à qual os registros neste item de dados estão relacionados. Por exemplo, para obter uma lista de registros de ANS de tarefa incorporados em uma tela de registro de tarefa, o. Tabelas relacionadas a o valor seria Tarefa tabela.
      Relacionamento Relacionamento entre a tabela selecionada em Tabela e a tabela selecionada em Tabela relacionada a. campo.
      Tipo de condição Determina que tipo de condição seu item de dados usa. Selecione entre:
      Declarativa
      Use uma condição declarativa para criar condições para o item de dados usando o construtor de condições.
      Com script
      Use um script para determinar as condições do seu item de dados. Uma janela de texto para inserir um script aparece abaixo deste campo quando você seleciona esta opção.
      Acrescentar Consulta Codificada
      Use esta opção somente ao criar itens de dados para suas telas de gráfico. Para obter detalhes sobre esse tipo de item de dados, consulte Configure um item de dados de consulta codificado para telas de gráfico.
      Condição Conjunto de condições para o item de dados estar em conformidade. Você pode criar condições usando construtor de condições .
      Nota:
      Este campo só está disponível quando você seleciona Declarativo em Tipo de condição campo.
      Classificar por Permite adicionar campos ao formulário que permitem configurar como classificar a lista. No Construtor de condições, selecione o campo pelo qual você deseja classificar a lista. Por exemplo, selecione Solicitante . Em seguida, selecione crescente ou decrescente para determinar a ordem da lista.
      Nota:
      Este campo só está disponível quando você seleciona Declarativo em Tipo de condição campo.
      Parâmetros
      Nota:
      O campo Parâmetros não deve ser usado para itens de dados de relacionamento.
    6. Opcional: Se você selecionou Script em Tipo de condição , você deve criar um script no Script de condição de consulta campo.

      Sua condição com script deve retornar uma cadeia de caracteres de consulta, que a instância usa para filtrar o item de dados. Use entrada variável para acessar informações do registro atual.

      (function getQueryString(input) {
      	var queryString = '';
      	if(input.company) {
      		  queryString += "company="+input.company;
      	 }
      	if(input.location) {
      	  queryString += "^location="+input.location;
      	 }
              queryString += "^EQ^ORDERBYDESCsys_updated_on";
      	 return queryString; 
       })(input);

      Este exemplo usa entrada e filtra o item de dados para registros correspondentes à empresa de registros atuais e ao local. Em seguida, ele anexa o texto ORDERBYDESCsys_UPDATED_ON para a consulta, que classifica os registros de item de dados por Atualizado em campo.

      Nota:
      . entrada A variável fornece acesso aos scripts móveis aos valores que são passados nos objetos SubmittedForm ou ParameterData.
    7. Selecione Save (Salvar).

    O que Fazer Depois

    Depois de criar um item de dados de relacionamento, crie uma tela de lista usando este item de dados recém-criado. Para obter mais informações, consulte Configuração da tela de lista.