Configurar um item de dados de relacionamento para uma lista integrada

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 incorporada. 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.
   O 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.
   A tela inicial de Construtor de apps para celular categorias é exibida.
3. Selecione a categoria Dados no menu e selecione Novo.
4. Selecione o ícone de 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 de 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 incorporada como lista na tela de registro primário. Nota: As tabelas personalizadas não estão disponíveis por padrão. Você pode mudar esse comportamento modificando a propriedade do sistema subscription.custom_table.enforce_entitlement. Para obter detalhes sobre como fazer essa mudança, consulte Permitir ou restringir 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 uma lista de registros de ANS de tarefa incorporados a uma tela de registro de tarefa, as tabelas relacionadas aovalor seriam a tabela de tarefas.
   Relacionamento	Relação entre a tabela selecionada no campo Tabela e a tabela selecionada no campo Tabela relacionada a.
   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 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 Configurar 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 o Construtor de condições. Nota: Este campo só está disponível quando você seleciona Declarativo no campo Tipo de condição.
   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 deseja que a lista seja classificada. 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 no campo Tipo de condição.
   Parâmetros	Nota: O campo Parâmetros não deve ser usado para itens de dados de relacionamento.

6. Opcional: Se você selecionou Script no campo Tipo de condição, deverá criar um script no campo Script de condição de consulta.

   Sua condição de script deve retornar uma cadeia de caracteres de consulta, que a instância usa para filtrar o item de dados. Use a variável de entrada 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 a variável de entrada e filtra o item de dados para registros que correspondem à empresa de registros atual e ao local. Em seguida, ele anexa o texto ^EQ^ORDERBYDESCsys_updated_on à consulta, que classifica os registros de item de dados pelo campo Atualizado em.

   Nota:

   A variável de entrada fornece acesso a scripts móveis para 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.