GlideElementDescriptor - com escopo, global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura
  • A API GlideElementDescriptor fornece informações sobre campos individuais em um registro de glide.

    Não há nenhum construtor para esta classe. Use o método GlideElement ou GlideRecord getED() para obter um objeto GlideElementDescriptor.

    GlideElementDescriptor – getAttachmentEncryptionType()

    Retorna o tipo de criptografia usado para anexos na tabela do elemento.

    Este método é para uso com o plug-in Edge Encryption.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 2. Retorna
    Tipo Descrição
    Cadeia de caracteres O tipo de criptografia usado em anexos. Retorna nulo se os anexos na tabela do elemento não estiverem sendo criptografados.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    var isEdge = ed.getAttachmentEncryptionType();
    gs.info(isEdge);
    

    Saída:

    null

    GlideElementDescriptor – getEncryptionType()

    Retorna o tipo de criptografia do elemento.

    Este método é para uso com o plug-in Edge Encryption.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Cadeia de caracteres O tipo de criptografia do elemento. Retorna nulo se o elemento não estiver criptografado.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    sEdge = ed.getEncryptionType();
    gs.info(isEdge);

    Saída:

    null

    GlideElementDescriptor – getInternalType()

    Retorna o tipo de dados internos do elemento.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres O tipo de dados internos do elemento.
    Valores possíveis:
    • booliano
    • caractere
    • collection
    • condições
    • data
    • decimal
    • document_field
    • domain_id
    • due_date
    • e-mail
    • field_name
    • anexo_arquivo
    • variável
    • glide_date
    • glide_date_time
    • glide_duration
    • glide_list
    • GUID
    • html
    • imagem
    • inteiro
    • longo
    • longint
    • várias_duas_linhas
    • registro
    • journal_input
    • numérico
    • índice_de_ordem
    • senha
    • número_ph
    • referência
    • script
    • script_plain
    • Cadeia de caracteres
    • sys_class_name
    • table_name
    • valor_modelo
    • timer
    • campo_traduzido
    • URL
    • user_image
    • user_input
    • user_roles
    • vídeo
    • fluxo de trabalho
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
     
    var field = grInc.getElement('priority');
    var ed = field.getED();
     
    var isEdge = ed.getInternalType();
    gs.info(isEdge);
    Saída:
    integer

    GlideElementDescriptor – getLabel()

    Retorna o rótulo do elemento.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Cadeia de caracteres O rótulo do elemento.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
     
    var field = grInc.getElement('priority');
    var ed = field.getED();
     
    var isEdge = ed.getLabel();
    gs.info(isEdge);

    Saída:

    Priority

    GlideElementDescriptor – getLength()

    Retorna o comprimento do elemento.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Número O tamanho do elemento.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
     
    var field = grInc.getElement('priority');
    var ed = field.getED();
     
    var isEdge = ed.getLength();
    gs.info(isEdge);

    Saída:

    40

    GlideElementDescriptor – getName()

    Retorna o nome do elemento.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres O nome do elemento.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
     
    var field = grInc.getElement('priority');
    var ed = field.getED();
     
    var isEdge = ed.getName();
    gs.info(isEdge);

    Saída:

    priority

    GlideElementDescriptor – getPlural()

    Retorna o rótulo plural do elemento.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Cadeia de caracteres O rótulo plural do elemento.
    var now_GR = new GlideRecord('incident');
    now_GR.query();
    var ed = now_GR.getED();
    gs.info(ed.getPlural());

    Saída:

    Incidents

    GlideElementDescriptor - hasAttachmentsEncrypted()

    Retorna verdadeiro se um anexo criptografado tiver sido adicionado à tabela.

    Este método é para uso com o plug-in Edge Encryption.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. Retorna
    Tipo Descrição
    Booliano Retorna verdadeiro se um anexo criptografado tiver sido adicionado à tabela.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    var isEdge = ed.hasAttachmentsEncrypted();
    gs.info(isEdge);

    Saída:

    false

    GlideElementDescriptor - isAutoOrSysID()

    Retorna verdadeiro se o elemento for um campo do sistema ou gerado automaticamente.

    Os campos gerados automaticamente e do sistema não podem ser criptografados. Este método é para uso com o plug-in Edge Encryption.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Booliano Verdadeiro se o elemento for gerado automaticamente ou um campo do sistema.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    isEdge = ed.isAutoOrSysID();
    gs.info(isEdge);
    

    Saída:

    false

    GlideElementDescriptor – isChoiceTable()

    Retorna verdadeiro se o elemento estiver definido como uma opção suspensa em sua definição de dicionário.

    Os campos de opção não podem ser criptografados.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 20. Retorna
    Tipo Descrição
    Booliano Retorna verdadeiro se o elemento estiver definido como uma opção suspensa. Retorna verdadeiro mesmo se não houver entradas definidas na tabela de seleção. O tipo de última opção, sugestão, não retorna verdadeiro.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    var isChoiceTable = ed.isChoiceTable();
    gs.info(isChoiceTable);

    Saída:

    true

    GlideElementDescriptor - isEdgeEncrypted()

    Retorna verdadeiro se um elemento estiver criptografado.

    Este método é para uso com o plug-in Edge Encryption.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    Booliano Retorna verdadeiro se o elemento estiver criptografado; caso contrário, retornará falso.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    var isEdge = ed.isEdgeEncrypted();
    gs.info(isEdge)

    Saída:

    false

    GlideElementDescriptor – isMandatory()

    Determina se o elemento é obrigatório e deve conter um valor antes que o registro possa ser salvo.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o elemento associado é obrigatório e deve conter um valor antes que o registro que contém o elemento possa ser salvo.

    Valores possíveis:

    • verdadeiro: o elemento deve conter um valor; campo obrigatório
    • falso: o elemento não precisa conter um valor

    Este exemplo mostra como verificar se o campo de nome é obrigatório.

    var isRecordValid;
    var now_GR = new GlideRecord('my_table');
    var field = now_GR.getElement('name');
    var elementDescriptor = field.getED();
    now_GR.query();
    while (now_GR.next()) {
    if (elementDescriptor.isMandatory() && !now_GR.name) {
           isRecordValid = false;
      }
    }

    GlideElementDescriptor – isVirtual()

    Retorna verdadeiro se o elemento for virtual.

    Um elemento virtual é um campo calculado conforme definido pela definição do dicionário do campo. Campos virtuais não podem ser criptografados.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 26. Retorna
    Tipo Descrição
    Booliano Retorna verdadeiro se o elemento for virtual.
    var grInc = new GlideRecord('incident');
    grInc.query('priority', '1');
    
    var field = grInc.getElement('priority');
    var ed = field.getED();
    
    var isVirtual = ed.isVirtual();
    gs.info(isVirtual);

    Saída:

    false