- Introdução
- Configuração e Instalação
- Usando o Data Service
- Referência
- Exemplos e tutoriais
Guia do usuário do Data Service
Introdução
O Data Service contém Campos integrados do sistema. Ao criar uma nova entidade, um conjunto de campos padrão é criado automaticamente. Ainda assim, você pode personalizar as entidades que você cria adicionando campos específicos.

Tipos de campo
Você pode criar os campos dos seguintes tipos de campo.
- Text: esse campo pode ser usado para armazenar uma pequena quantidade de texto.
- Número: esse campo pode ser usado para armazenar um valor numérico. Os valores numéricos podem ser positivos ou negativos. Você deve especificar o número de casas decimais que você deseja usar.
- Yes/No: esse campo é usado para escolher entre um valor de Yesou No.
- Data-hora: esse campo é usado para armazenar um valor que contém uma data e hora. Um seletor de datas pode ser usado para selecionar uma data e hora.
- Relacionamento: esse campo é usado para criar uma relação entre duas entidades.
- Choice Set: esse campo é usado para armazenar uma lista de valores enumerados a partir dos quais um ou mais valores podem ser selecionados.
- Arquivo: esse campo é usado para armazenar um arquivo.
- Número automático: este campo é usado para aumentar automaticamente índices de registro.
Cada tipo de campo requer diferentes detalhes que devem ser especificados. Consulte a página específica em Tipos de campo de entidade para aprender mais sobre isso.
Como criar campos
Para adicionar campos aos dados de sua entidade:
-
Na lista de Entidades, selecione a entidade para a qual você deseja adicionar um campo. A guia Campos é exibida com a lista de campos definidos para a entidade.
-
Clique em Criar novo campo. O assistente Criar campo é aberto.

-
Insira um Nome de Exibição para o novo campo. O Nome de Exibição é o nome exibido ao importar a entidade no Studio. Este campo pode ser modificado após a criação da entidade.
-
Insira um Nome para o novo campo. O Nome pode ser alfanumérico, mas deve começar com uma letra. Deve ter entre 3 e 30 caracteres.
Observação:O campo Nome é preenchido automaticamente com o mesmo valor fornecido para o Nome de Exibição. Você só pode alterar seu valor durante o processo de criação da entidade. Depois que a entidade é criada, o campo Nome não pode ser editado.
-
Selecione o campo Tipo usando a lista suspensa.
-
Para forçar os usuários a fornecer um valor para o campo, marque a caixa de seleção Obrigatório .
-
Para impor valores exclusivos para os registros de campo, marque a caixa de seleção Apenas valores exclusivos .
Importante:A opção está disponível para os tipos de campo Texto e Número .
Quando necessário, use o máximo de casas decimais configuradas para números. Caso contrário, o Data Service arredonda o número para o valor máximo de decimais, causando falha de exclusividade. Por exemplo, se você definir uma precisão de três casas decimais e valores de entrada como
3.015e3.0148, o último valor será arredondado para3.015, levando a falhas de exclusividade.A opção não diferencia maiúsculas de minúsculas, o que significa que "Valor Exclusivo" e "Valor Exclusivo" são identificados como duplicatas.

-
Clique em Mais detalhes para configurar propriedades opcionais de registro de campo, como:
Opção Description Tamanho Máximo Para campos de Texto , defina o número máximo de caracteres que um usuário pode fornecer. Por padrão, até 200 caracteres são permitidos. Valor Máximo Para campos de Número , defina o valor máximo que um usuário pode fornecer. O valor máximo padrão é 1,000,000,000,000.Valor Mínimo Para campos de Número , defina o valor mínimo que um usuário pode fornecer. O valor máximo padrão é -1,000,000,000,000.Casas Decimais Para campos Número , defina quantos dígitos decimais um usuário pode fornecer. O valor padrão é 2, que permite números com dois dígitos decimais, como23,45.Valor Padrão Define um valor padrão caso os usuários não forneçam dados. Description Adicione uma descrição para o campo. Acesso ao campo baseado em função Selecione essa opção para restringir o acesso aos dados concedendo permissões explícitas. -
Opcionalmente, para manter o assistente Criar campo aberto, marque a caixa de seleção Criar outro . Isso ajuda você a criar vários campos na entidade selecionada mais rapidamente, pois pula a etapa 2 deste procedimento.
-
Clique em Salvar.
O novo campo é exibido na lista de Campos.
Updating the fields
Para atualizar os campos que você criou, siga as etapas abaixo:
- Você não pode atualizar campos integrados do sistema.
- Você não pode alterar o Nome e o Tipo de campos personalizados.
-
Na aba Campos, passe o mouse sobre o campo que você deseja editar.
-
Clique no ícone Editar campo correspondente ao item. Isso está disponível no lado direito da tela.

-
O painel Editar campo é exibido. Aplique suas atualizações.
Observação:Se o campo foi criado com a opção Somente valores exclusivos ativada, você pode desabilitá-la, permitindo duplicatas mais uma vez. Esteja ciente de que desmarcar a caixa de seleção Apenas valores exclusivos impede você de selecioná-la novamente posteriormente.
-
Clique em Salvar.
Excluindo campos
Para excluir campos que você criou, siga as etapas abaixo:
Você não pode excluir campos integrados do sistema.
-
Na guia Campos, passe o mouse sobre o campo que você deseja editar.
-
Clique no menu Mais opções no final da linha do campo e selecione Excluir.
-
Para ativar o botão Excluir , insira o nome de exibição do campo na caixa de diálogo Excluir campo .
-
Clique em Excluir para confirmar a ação.

Habilitando ou desabilitando o acesso de campo baseado em função
O Acesso de campo baseado em função pode ser usado para restringir o acesso de dados. É possível habilitar o Acesso de campo baseado em função apenas para campos personalizados. Isso não está disponível para campos integrados do sistema.
Após a opção de Acesso de campo baseado em função ser habilitada para um campo, as funções precisam ser atualizadas para conceder permissões explícitas aos usuários para que acessem o campo. Consulte Gerenciar acesso para obter mais informações.
As Funções Padrão não terão mais acesso aos dados em campos que estão habilitados para o Acesso de campo baseado em função. Os usuários que precisam acessar esses dados precisarão receber uma Função Personalizada que conceda permissões para acessar os dados no campo.
-
Na guia Campos, passe o mouse sobre o campo para o qual você deseja ativar (ou desativar) o Acesso de campo baseado em função.
-
Clique no menu Mais opções no final da linha do campo e, em seguida, selecione a opção Ativar acesso de campo baseado em função (ou a opção Desabilitar acesso de campo baseado em função) no menu.

-
Clique em Ativar (ou Desativar) para confirmar a ação.
Será exibida uma mensagem de confirmação. Veja a ilustração abaixo.
Importante:Quando você habilita Acesso de campo baseado em função para um campo, todos os usuários que têm funções existentes atribuídas, e essas funções não fornecem permissões de nível de campo, não terão acesso aos dados no campo.
-
Clique em Gerenciar funções para abrir a guia Funções da página Gerenciamento do Usuário. Aqui você pode atualizar as Funções Personalizadas para conceder permissões para acessar o campo.