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: admin

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é Todos > Sistema Móvel > Construtor de apps para celular.
   O Construtor de apps para celular é aberto 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 no qual 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 de 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 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: 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 SLA de tarefa incorporados em uma tela de registro de tarefa, as Tabelas relacionadas aovalor seriam a tabela Tarefa.
   Relacionamento	Relacionamento 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ção. 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 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ção. 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ção, selecione o campo pelo qual você 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 Com 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 e ao local atuais. 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 de scripts móveis a valores que são passados nos objetos SubmittedForm ou ParameterData.
7. Selecione 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.