Atributos da tela do formulário de entrada para entradas
Diferentes tipos de entradas estão disponíveis para uso em telas de formulário de entrada e você pode usar atributos diferentes para configurar as entradas.
Use atributos de entrada para definir a aparência e definir limitações em suas entradas. Os exemplos incluem definir valores mínimos e máximos ou exibir um valor de entrada como porcentagem.
Atributo geral
Você pode usar este atributo com qualquer tela de formulário de entrada, independentemente do tipo de entrada.
| Atributo | Descrição |
|---|---|
| DescriptionRenderType | Defina um tipo de renderização para a descrição de entrada. html : Permite que você use marcadores HTML para formatar o texto no Descrição campo da sua entrada. |
| DataSourceId | Defina este atributo sempre que criar um mecanismo de fonte de dados para carregar valores de entrada. Para obter mais informações, consulte Fontes de dados. Nota: Este atributo não é compatível com entradas de assinatura. |
| ElementIdentifier | Defina este atributo sempre que criar um mecanismo de fonte de dados para carregar valores de entrada. Para obter mais informações, consulte Fontes de dados. Nota: Este atributo não é compatível com entradas de assinatura. |
Entradas de anexo
|
Use entradas de anexo para permitir que os usuários anexem arquivos em uma tela de formulário de entrada. As entradas de anexo exigem um item de ação com script e um actionResultobjeto para carregar um arquivo.
Nota: As entradas de anexo são compatíveis somente com ações com script. |
 |
(function WriteBackAction(parm_input, parm_variable, actionResult) {
//other write-back inputs and variables here
actionResult.addAttachment("attach", "incident", gr.getUniqueValue()); //where "attach" is the input name from above screenshot, and “incident” is the table name
})(parm_input, parm_variable, actionResult);
- Restringir origens de anexo aos usuários
- Você tem a opção de limitar as origens dos anexos para garantir que as imagens sejam originadas de um ou de todos os seguintes:
- no local por meio de uma câmera
- na galeria de telefones do usuário
- do sistema de arquivos do usuário
No registro de atributo de entrada, selecione HiddenAttachmentSources . Selecione uma das opções câmera , arquivos ou galeria . Valor e selecione Salvar . Repita o processo se quiser incluir mais de uma origem de anexo. Para obter mais informações, consulte Defina origens de anexo disponíveis para os usuários.
Atributo Descrição HiddenAttachmentSources Decida de onde você não deseja que as imagens sejam obtidas. Selecione um dos seguintes valores de origem: câmera , arquivos ou galeria . Valor campo. Nota:Para evitar que imagens e arquivos sejam obtidos de mais de uma origem, adicione adicional HiddenAttachmentSourcesatributos depois de salvar o atributo que você está configurando no momento.
Entradas de código de barras
Use entradas de código de barras para ler um ou vários códigos de barras. Códigos de barras são códigos legíveis por máquina na forma de números e um padrão de linhas paralelas de larguras variáveis. Esses códigos são usados para identificar itens como produtos, peças ou ativos. Você pode usar este tipo de entrada para inserir informações sobre itens em seu ServiceNow usando seu aplicativo para celular.
- As entradas de código de barras podem ser configuradas para leituras únicas, várias varreduras ou varreduras agrupadas. Verificações únicas permitem que o usuário verifique somente uma vez. Nesse caso, o usuário deve verificar novamente tocando no ícone de verificação, o que limpa o valor da verificação. Você não precisa configurar um atributo para uma única entrada de código de barras de leitura.
- As entradas de várias varreduras podem ser configuradas com MaxEntriesatributo. Se a entrada de código de barras da tela do formulário de entrada estiver configurada com MaxEntries, os usuários podem ler rapidamente vários códigos de barras sequencialmente sem sair da interface de leitura.
- Verificações agrupadas podem ser configuradas para verificar vários códigos de barras associados a um ativo que deve ser agrupado em um conjunto. Para configurar uma entrada de código de barras agrupada, você deve criar uma seção de código de barras na tela do formulário de entrada que tenha somente entradas de código de barras. Em seguida, a seção MaxEntrieso atributo deve ser configurado para a seção de código de barras agrupado para que os usuários possam ler vários grupos de códigos de barras.
| Atributo | Descrição |
|---|---|
| MaxEntries | Usado somente para configurar várias varreduras e vários grupos de códigos de barras. Define o número máximo de códigos de barras que um usuário pode verificar de cada vez. Por exemplo, você pode definir o valor como 5 para permitir que os usuários revisem 5 vezes. Nota: Use este atributo somente para entradas de código de barras de várias leituras. Se sua entrada de código de barras for destinada a verificações únicas, nenhum atributo será necessário. |
Para obter informações sobre como criar uma tela de formulário de entrada com entradas de código de barras, consulte Configure telas de formulário de entrada com entradas de código de barras de leitura única e múltipla e. Configure telas de formulário de entrada com entradas de código de barras de leitura agrupadas.
Entradas boolianas
|
Use entradas boolianas para entradas com valores verdadeiro ou falso. As entradas boolianas podem ser exibidas como uma caixa de seleção ou como uma chave de alternância. |
 |
Você pode usar esses atributos com entradas boolianas.
| Atributo | Descrição |
|---|---|
| RenderType | Especifique um tipo de renderização para a entrada booliana.
|
Entradas de seleção
|
Use as entradas de seleção para dar aos usuários opções de seleção. Você pode criar essas opções manualmente ou usar uma tabela e um campo existentes para fornecer as opções. Configure uma entrada de opção para permitir que os usuários selecionem uma ou várias opções. A opção de selecionar mais de um chip em uma categoria é marcada por um sinal de adição nas fichas. Defina o número de chips a serem exibidos, permitindo que o usuário veja todas as opções disponíveis em uma única tela de formulário de entrada. Se o número definido de fichas a serem exibidas exceder o valor definido, um Ver tudo o botão é exibido. Toque em Ver tudo botão para abrir uma página com todas as opções listadas. |
|
Você pode usar esses atributos com entradas de opção.
| Atributo | Descrição |
|---|---|
| MultiSelect | Opção para permitir que os usuários selecionem várias opções para a entrada. O valor deve ser verdadeiro ou falso . As opções de seleção múltipla são indicadas com um sinal de adição no chip. |
| Table | A tabela onde o campo de seleção está localizado. Nota: Use esta opção para usar as opções em uma tabela e campo existentes em vez de criar opções manualmente. Você deve selecionar um campo nesta tabela usando Fieldatributo. |
| Field | O campo que contém suas escolhas. Nota: Use esta opção para usar as opções em uma tabela e campo existentes em vez de criar opções manualmente. O campo definido neste atributo deve estar na tabela definida em Tableatributo. |
| Inline | Opção para selecionar como exibir suas entradas de escolha. Por padrão, o valor é falso , o que significa que a exibição de seleção está na mesma tela, eliminando a necessidade de navegar para uma tela separada. Para obter um exemplo visual, consulte a imagem na introdução de Entradas de seleção. Se você selecionar verdadeiro uma opção do tipo lista é exibida onde os usuários precisam navegar para uma tela adicional, depois que uma seleção é feita. |
| InlineMaxItems | Opção para definir o número de chips a serem exibidos em uma seção de tela de formulário de entrada. As seguintes entradas no Valor os campos estão disponíveis:
|
| RenderType | Opção para renderizar as opções de escolha como uma imagem para a entrada de escolha. O valor deve ser imagem . |
Entradas de mapa personalizadas
|
Use entradas de mapa personalizadas para adicionar um link a um mapa interno em seu aplicativo para celular. Os usuários podem usar esses mapas para obter direções e reservar recursos, como mesas, salas de reunião ou armários. Os administradores também podem configurar um item de dados com parâmetros com condições de consulta que permitem a classificação e a filtragem da entrada do mapa personalizado. Importante:
Entradas de mapa personalizado que oferecem suporte a itens de dados com parâmetros devem usar somente o. ScreenIdatributo. Não use nenhum outro tipo de atributo para entradas de mapa personalizadas que oferecem suporte a itens de dados com parâmetros. Se você estiver modificando uma entrada de mapa personalizado existente que usa o qualificador de referência avançado para usar um item de dados com parâmetros, use ScreenIdatribua somente e remova todos os outros atributos. |
|
| Atributo | Descrição |
|---|---|
| CustomMapConfigId | O sys_id da tabela sys_sg_custom_map_config. |
| CustomMapDefaultProviderId | O sys_id do registro do provedor na tabela sys_sg_custom_map_provider. |
| CustomMapInputs | O sys_id do andar na tabela sys_sg_input. Este valor deve ser inserido como uma matriz JSON. |
| ScreenId | O sys_id de um item de dados parametrizado usado para classificar e filtrar entradas de mapa personalizado. Importante: Este atributo não pode ser usado com nenhum outro atributo de entrada de mapa personalizado. Se você usar ScreenIdatributo com uma entrada de mapa personalizada, não use outros atributos com a entrada. |
| TargetTable | Definido como sn_wsd_core_space . |
Entradas de data/hora
|
Use entradas de data/hora para permitir que os usuários insiram valores de data e hora. Você pode configurar a entrada para data e hora ou somente data. |
 |
Você pode usar esses atributos com entradas de data/hora.
| Atributo | Descrição |
|---|---|
| RenderType | Especifique um tipo de renderização para a entrada de data/hora.
|
| IncludeTimezone |
O fuso horário do dispositivo móvel ao qual a entrada está sendo adicionada. O valor deve ser verdadeiro ou falso . Quando definido como verdadeiro , O cliente móvel envia as informações de Fuso horário do dispositivo junto com o valor de data e hora para a instância de back-end no seguinte formato: MM-DDThh:mm:ss.sssTZD Nota:
O Fuso horário do dispositivo é diferente do Fuso horário do perfil do usuário configurado na plataforma. Se este atributo não estiver configurado, o cliente móvel não incluirá as informações de Fuso horário do dispositivo nos valores de entrada de data/hora. Este comportamento é o padrão. Os valores de entrada de data/hora estão no seguinte formato: AAAA-MM-DD hh:mm:ss Para obter informações sobre como configurar o atributo IncludeTimezone de entradas de data/hora para diferentes tipos de ação, consulte Configuração de entrada de data/hora para diferentes tipos de item de ação. Para obter informações sobre tipos de item de ação, consulte Configure um item de ação. |
| MaxRangeDays |
Atributo opcional que determina se datas futuras podem ser selecionadas quando uma entrada de data/hora é adicionada. Este atributo oferece suporte a valores inteiros positivos e negativos. Configuração MaxRangeDays. 0 impede que os usuários selecionem datas futuras e as restringe a datas atuais ou passadas. Nota:
MaxRangeDayspode ser usado em conjunto com MinRangeDays, MaxRangeHourse MinRangeHours. |
| MinRangeDays |
Atributo opcional que determina se datas passadas podem ser selecionadas quando uma entrada de data/hora é adicionada. Este atributo oferece suporte a valores inteiros positivos e negativos. Configuração MinRangeDays. 0 impede que os usuários selecionem datas passadas e os restringe a datas atuais ou futuras. Nota:
MinRangeDayspode ser usado em conjunto com MaxRangeDays, MaxRangeHourse MinRangeHours. |
| MaxRangeHours |
Atributo opcional que determina se as horas futuras podem ser selecionadas quando uma entrada de data/hora é adicionada. Este atributo oferece suporte a valores inteiros positivos e negativos. Configuração MaxRangeHours. 0 impede que os usuários selecionem datas e horas futuras e os restringe a datas e horas atuais ou passadas. Nota:
MaxRangeHourspode ser usado em conjunto com MaxRangeDays, MinRangeDayse MinRangeHours. |
| MinRangeHours |
Atributo opcional que determina se as horas anteriores podem ser selecionadas quando uma entrada de data/hora é adicionada. Este atributo oferece suporte a valores inteiros positivos e negativos. Configuração MinRangeHours. 0 impede que os usuários selecionem datas e horas passadas e os restringe a datas e horas atuais ou futuras. Nota:
MinRangeHourspode ser usado em conjunto com MaxRangeDays, MinRangeDayse MaxRangeHours. |
Entradas numéricas
|
Use entradas numéricas para permitir que os usuários insiram valores numéricos. Defina valores mínimos e máximos opcionais para definir um intervalo numérico para sua entrada. Opcionalmente, você pode configurar uma entrada numérica para aparecer como uma porcentagem. Por padrão, as entradas numéricas são compatíveis com decimais. Para ter a entrada de caixa básica para um número, em um registro de entrada, preencha todos os campos obrigatórios e selecione Número em Tipo de entrada campo. |
 |
| Atributo | Descrição |
|---|---|
| CustomErrorMessage | Define uma mensagem de erro personalizada que você pode especificar. Esta mensagem é exibida quando a condição da regra de IU associada é atendida. |
| Max | Especifique um valor máximo para a entrada. |
| Min | Especifique um valor mínimo para a entrada. |
| RenderType | Especifique um tipo de renderização para a entrada numérica.
Nota: Para obter uma tabela que mostra quais atributos podem ser usados com qual tipo de renderização, consulte Tipos de renderização de números e atributos de entrada compatíveis. |
| SkipValidationWhenHidden | Nota: Pode ser definido como qualquer um verdadeiro ou falso . Definido como falso Por padrão, o que significa que, por padrão, a validação da regra de IU associada é executada nas entradas ocultas. Somente defina como verdadeiro quando você quiser ignorar a validação em entradas ocultas.Este atributo só pode ser usado com tipos de renderização de linha e porcentagem. |
| Atributo | Descrição |
|---|---|
| DefaultValue |
O valor exibido quando o usuário exibe o controle deslizante pela primeira vez. Se nenhum valor for inserido, o valor exibido será zero. O valor padrão deve estar entre os valores mínimo e máximo. Nota:
Este valor definido é o ponto de partida, a menos que um mecanismo de carregamento, que tenha prioridade, esteja configurado. Consulte, Mecanismos de carregamento para telas de formulário de entrada. |
| StepSize | O tamanho de cada etapa no controle deslizante. As etapas devem ser um número divisível entre o número máximo e mínimo. Por exemplo, o número mínimo é 20 e o número máximo é 80, o tamanho stepSize pode ser números como 2, 5 ou 10. |
| ReferencePoint | Quando definido como verdadeiro um marcador é adicionado ao controle deslizante, fornecendo um ponto de referência visual para o usuário. Nota: Por uma questão de clareza visual, este atributo de entrada não deve ser usado com o atributo de entrada VisualStepsEnabled. |
| VisualStepsEnabled | Quando definido como verdadeiro O controle deslizante exibe incrementos visuais com base no atributo de entrada stepSize especificado. Nota: Por uma questão de clareza visual, este atributo de entrada não deve ser usado com o atributo de entrada ReferencePoint. |
| EnforceStepSize | Quando definido como verdadeiro Os usuários não podem inserir um valor na caixa Número que não esteja alinhado com o valor de Tamanho de etapa. |
| Decoration | Define seções no controle deslizante com rótulos correspondentes que aparecem quando um usuário toca em uma seção ou insere um valor. Cada seção pode ser associada a uma cor específica para auxiliar na representação visual. Para obter mais informações, consulte Configure uma opção de controle deslizante para uma entrada numérica. |
Entradas de classificação
|
Use entradas de classificação para permitir que os usuários classificem as opções disponíveis em ordem de preferência ou prioridade. Os usuários tocam e arrastam as opções disponíveis. As opções para a entrada de classificação devem ser definidas manualmente. |
Não há atributos para classificar entradas além dos atributos gerais listados neste tópico.
Entradas de referência
Use entradas de referência para entradas que fazem referência a um campo em uma tabela. Essas entradas funcionam como campos de referência nos formulários em sua instância. Você pode configurar sua entrada de referência com condições, qualificadores de referência e uma opção de pesquisa para ajudar os usuários a encontrar o que precisam rapidamente.
A opção de pesquisa opcional usa pesquisas de palavra-chave "para texto" e pode pesquisar elementos na exibição para celular.
Você pode usar esses atributos com entradas de referência.
| Atributo | Descrição |
|---|---|
| SourceTable | A tabela de origem do qualificador de referência. |
| SourceFieldName | O nome do campo referenciado na tabela de origem. |
| TargetTable | A tabela que você deseja direcionar para o qualificador de referência. |
Os seguintes atributos adicionais são opcionais:
| Atributo | Descrição |
|---|---|
| MultiSelect | Opção para permitir que os usuários selecionem várias opções para a entrada. O valor deve ser verdadeiro ou falso . |
| MobileViewId | ID de exibição móvel (Configuração de exibição) a ser usado para itens da lista de referência. |
| EnableSearch | Opção para exibir a barra de pesquisa. O valor deve ser verdadeiro ou falso . |
| SearchPlaceholder | Texto que aparece em uma barra de pesquisa como um espaço reservado. |
| Conditions | Insira uma consulta codificada para aplicar condições à sua lista de referência. Para obter detalhes sobre como criar essas consultas, consulte Cadeias de caracteres de consulta codificadas . |
| SearchType | Define a consulta usada para pesquisa. O valor pode ser starts_with ou contém . Se este atributo não estiver configurado, a instância usará starts_withpor padrão, na coluna de rótulo de exibição. |
Este exemplo cria uma entrada de tela de formulário de entrada para Atribuído a. Campo na tabela Incidente [incidente]. Para criar esta entrada, você usa os três atributos necessários: TargetTable , SourceTable e SourceFieldName .
- Seus usuários selecionam em uma lista de usuários aos quais atribuir o incidente. Você define TargetTable atributo para sys_user .
- Como você está adicionando o usuário a um registro de incidente, o. SourceTable o atributo está definido como incidente .
- Defina SourceFieldName . assigned_to para que o usuário selecionado seja atribuído ao Atribuído a. campo.
Entradas de assinatura
Use entradas de assinatura para capturar assinaturas eletrônicas em uma tela de formulário de entrada. As entradas de assinatura podem ser incluídas em seções ou páginas da tela do formulário de entrada.
Você pode usar o opcional IsOverlayatributo com entradas de assinatura. Por padrão, as assinaturas são renderizadas na janela modal completa. . IsOverlayatributo Valor está definido como verdadeiro as assinaturas são renderizadas em uma janela modal.
| Atributo | Descrição |
|---|---|
| IsOverlay | Define se a entrada de assinatura é aberta em uma meia janela modal. Você pode definir Valor . verdadeiro ou falso . Um valor de verdadeiro configura a assinatura para abrir em uma meia janela modal. Nota: Se a entrada de assinatura estiver configurada como a única entrada em uma página e isOverlayo atributo está definido como verdadeiro . isOverlayo atributo é ignorado e a entrada de assinatura é exibida em tela cheia. |
Entradas de cadeia de caracteres
|
Use entradas de cadeia de caracteres para entrada de texto. Você pode definir um tamanho máximo de caracteres para esta entrada. |
 |
Você pode usar esses atributos com entradas de cadeia de caracteres.
| Atributo | Descrição |
|---|---|
| Inline | Opção para mostrar a entrada em linha ou para abrir a entrada em um modal separado. O valor deve ser verdadeiro ou falso . |
| MaxLength | Número máximo de caracteres para o valor de entrada. |
| ShowDeleteAll | Opção para exibir um botão de exclusão sempre que houver texto no campo de entrada. Este valor deve ser verdadeiro ou falso e está definido como falso por padrão. |
| ConfirmDeletion | Opção para mostrar ao usuário uma mensagem de confirmação antes que o texto seja excluído ao usar ShowDeleteAll. O valor deve ser verdadeiro ou falso e está definido como verdadeiro por padrão. |
Entradas da tela
Use uma entrada de tela para transformar uma tela de lista em entrada de lista selecionável. Os usuários podem selecionar vários itens da lista e executar uma operação de write-back no cache.
Você pode usar esses atributos com entradas de tela.
| Atributo | Descrição |
|---|---|
| ScreenId | Configura a tela de lista que é usada para a entrada de lista selecionável. O valor é o sys_id da tela de lista. |
| GetDataFromParent | Transforma uma tela de lista de uma tela primária na entrada de lista selecionável. Os filtros que são aplicados à tela da lista primária são transferidos para a entrada da tela. Insira verdadeiro para habilitar este atributo. Por padrão, ele está desativado na instância. |