Inclusões de script

As inclusões de script são usadas para armazenar o JavaScript executado no servidor.

Crie inclusões de script para armazenar funções e classes JavaScript para uso por scripts de servidor. Cada inclusão de script define uma classe de objeto ou uma função.

Considere o uso de inclusões de script em vez de regras de negócios globais porque as inclusões de script são carregadas somente mediante solicitação. Para obter mais informações, consulte Inclusões de script chamável pelo cliente e O script de descoberta inclui.

Para obter exemplos adicionais de scripts, consulte Scripts úteis.

Script de inclusão de formulário

As inclusões de script têm um nome, uma descrição e um script. Eles também especificam se estão ativos ou não e se podem ser chamados a partir de um script de cliente. Ou crie uma inclusão de script existente ou uma nova inclusão usando o formulário Inclusão de script.

Para acessar inclusões de script, navegue até Tudo > Definições do Sistema > Inclusões de script.

Tabela 1. Script de inclusão de formulário

Campo	Descrição
Nome	O nome da inclusão de script. Se você estiver definindo uma classe, ela deve corresponder ao nome da classe, do protótipo e do tipo. Se você estiver usando uma inclusão de script sem classe (sob demanda), o nome deve corresponder ao nome da função.
Nome da API	O nome interno da inclusão de script. Usado para chamar a inclusão de script de aplicações fora do escopo.
AJAX do Glide habilitado	A inclusão de script está disponível para scripts de cliente, filtros de lista/relatório, qualificadores de referência ou se especificado como parte do URL. As inclusões de script chamáveis do cliente são invocadas de GlideAjax E exigem que os usuários atendam a uma ACL associada à inclusão de script. Quando selecionado, o. Controles de acesso O link relacionado está disponível. Para obter mais informações, consulte Inclusões de script chamável pelo cliente.
Celular chamável	A inclusão de script está disponível para scripts de cliente chamados de dispositivos móveis.
Área restrita habilitada	A inclusão de script é invocada a partir da sandbox de script, como uma condição de consulta. Este método não requer autenticação. Para obter mais informações sobre a área restrita, consulte Configuring Script sandbox property.
Aplicação	A aplicação em que esta inclusão de script reside.
Acessível de	As aplicações que podem acessar este script incluem: Todos os escopos de aplicação Pode ser acessado a partir de qualquer escopo da aplicação. Somente este escopo da aplicação Pode ser acessado somente a partir do escopo da aplicação atual.
Ativo	Habilita a inclusão de script quando selecionado. Desmarque o campo ativo para desabilitar a inclusão de script.
Descrição	Fornece conteúdo descritivo sobre a inclusão de script.
Script	Define o script do lado do servidor a ser executado quando chamado de outros scripts. O script deve definir uma única classe JavaScript ou uma função global. O nome da classe ou função deve corresponder a. Nome campo.
Pacote	O pacote que contém este script inclui.
Criação de	O usuário que criou este script inclui.
Atualização de	O usuário que atualizou este script mais recentemente inclui.
Política de proteção	Define o nível de proteção para o script Incluir: Nenhum(a) Permite que qualquer pessoa leia e edite esta inclusão de script baixado ou instalado. Somente leitura Permite que qualquer pessoa leia valores desta inclusão de script baixado ou instalado. Ninguém pode mudar os valores de script na instância em que eles baixam ou instalam a inclusão de script. Protegido Fornece proteção de propriedade intelectual para desenvolvedores de aplicações. Os clientes que baixam a inclusão de script não podem ver o conteúdo do campo de script. O script é criptografado na memória para impedir que usuários não autorizados o vejam em texto simples.
Listas relacionadas na exibição de formulário:
Versões	Mostra todas as versões da inclusão de script. Use esta lista para comparar versões ou reverter para uma versão anterior. Consulte Versões .
Controles de acesso	Fica disponível quando Cliente solicitável a caixa de seleção está marcada e oculta das inclusões de script padrão. Use para proteger um CCSI contra o uso não autorizado quando o acesso público não é concedido.

Use inclusões de script

As inclusões de script são encontradas em Definição do sistema ou IU do sistema. Você pode chamar inclusões de script existentes a partir de um script ou criar uma nova inclusão de script.

Para criar uma inclusão de script totalmente nova, você pode seguir o formato de qualquer uma das inclusões de script existentes. Neste exemplo, o nome da inclusão de script é NoIncluir e há uma única função chamada MyFunction . É importante que o nome da inclusão do script corresponda ao nome da classe, do protótipo e do tipo. Quando você cria uma nova inclusão de script e dá um nome a ela, o sistema fornece um snippet de código com a classe e o protótipo configurados corretamente.

var NewInclude =Class.create();
 
NewInclude.prototype={
  initialize :function(){},
 
  myFunction :function(){<Put function code here>},
 
  type :'NewInclude'};

Em seguida, você pode usar o. MyFunction linha como esta:

var foo =new NewInclude();
foo.myFunction();

Inclusões de script acionáveis pelo cliente

Inclusões de script chamável do cliente (CCSI) Torne a inclusão de script disponível para scripts de cliente, filtros de lista/relatório, qualificadores de referência ou, se especificado como parte do URL.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Definição do Sistema > Inclusões de script.
2. Selecione Novo ou selecione uma inclusão de script existente para exibição ou edição.
   Consulte Use inclusões de scriptpara obter informações adicionais sobre como escrever inclusões de script.
3. Preencha o formulário e selecione Cliente solicitável caixa de seleção.
   Um seletor de função é exibido para selecionar uma função de usuário e criar automaticamente uma entrada de controle de acesso. Selecione uma função de usuário e clique em OK .

   Nota:

   Para desabilitar a janela do seletor de função, defina glide.script.ccsi.enable_acl_create_ux para falso .

   Um novo registro CCSI com um controle de acesso baseado em função é criado. O Link relacionado ao controle de acesso fica disponível com a seleção de Client calIable caixa de seleção.

   

Inclusões de script chamável pelo cliente

As configurações de privacidade para inclusões de script chamável pelo cliente (CCSI) determinam quem pode acessar uma inclusão de script chamável pelo cliente.

Configuração de privacidade privada

A configuração de privacidade privada significa que os convidados que acessam páginas públicas não podem acessar o script-include chamável pelo cliente. Um script privado não pode ser executado por um usuário não conectado.

Configuração de privacidade pública

Uma configuração de privacidade pública significa que o script do cliente pode ser executado por usuários não conectados que criam uma solicitação HTTP apropriada. Isso pode criar um problema de segurança se o script do cliente fornecer informações confidenciais.

As inclusões de script a seguir permanecem públicas por padrão porque Tornar páginas de IU públicas ou privadas é necessário acessá-los:

• GlideSystemAjax
• SysMessageAjax
• KnowledgeMessagingAjax
• KnowledgeAjax
• ResetAjax

Defina a privacidade em todas as inclusões de script chamáveis pelo cliente

Altere a configuração de privacidade em todas as inclusões de script chamáveis pelo cliente.

Para fornecer mais controle sobre todas as inclusões de script chamáveis pelo cliente, os administradores podem adicionar o. glide.script.ccsi.ispublic propriedade. Esta propriedade muda a visibilidade das inclusões de script chamável pelo cliente, tornando-as públicas ou privadas. Configure a propriedade da seguinte forma:

Tabela 2. Configure a propriedade

Título	Propriedade
Nome	glide.script.ccsi.ispublic
Tipo	verdadeiro|falso
Valor	falso

Nota:

Para aprender mais sobre essa propriedade, consulte Require authentication by default for client-callable script includes [Updated in Security Center 1.3] nas Configurações de proteção de segurança de instância.

Mude a privacidade em uma inclusão de script chamável de cliente único

Altere a configuração de privacidade de uma inclusão de script chamável pelo cliente único adicionando o. IsPublic() função.

A configuração isPublic () tem precedência sobre a propriedade glide.script.ccsi.ispublic. Por exemplo, se a propriedade estiver definida como falso , tornando privadas todas as inclusões de script chamáveis pelo cliente e um conjunto de scripts IsPublic() para verdadeiro , o script é público.

Para mudar a privacidade de uma inclusão de script chamável pelo cliente, adicione o seguinte método à inclusão de script:

isPublic:function(){return[true/false];},

Torne o script do cliente NewInclude privado.

var NewInclude =Class.create();
 
NewInclude.prototype={
   initialize:function(){},
 
   myFunction:function(){//Put function code here},
   isPublic:function(){return false;},
 
   type:'NewInclude'};

Inclusões de script solicitável do cliente

P Rotecte sua inclusão de script chamável do cliente (CCSI) contra uso não autorizado. Para todos os registros de CCSI criados como uma aplicação do cliente, são exibidas recomendações que podem ajudar a reduzir o risco de segurança .

Ao criar um CCSI, o sistema exibe as seguintes recomendações de segurança, se ainda não tiverem sido configuradas:

• Adicione ou defina um controle de acesso, a menos que o CCSI tenha acesso público.
• Uso GlideRecordSecure em vez de GlideRecord API para melhor segurança, se o script consultar o banco de dados.

  

  Nota:

  Para desabilitar as mensagens de recomendação de segurança, defina a propriedade glide.script.ccsi.customer_scoped.security_msgs_enabled para falso na tabela sys_properties. O valor padrão é definido como verdadeiro .

Consulte Configurações de proteção de segurança da instância para obter informações adicionais sobre conformidade de segurança.

O script de descoberta inclui

DescobertaAs inclusões de script definem classes JavaScript que você pode usar para realizar Descobertatarefas.

Nota:

Os usuários com a função discovery_admin podem gravar inclusões de script. Siga as práticas recomendadas para scripts do lado do servidor e do cliente para evitar problemas de segurança. Consulte o artigo de conhecimento KB0550828 para obter mais informações.

Usando GlideRecordUtil para trabalhar com GlideRecords

GlideRecordUtil É uma classe de utilitário que fornece métodos que são úteis para trabalhar com GlideRecords durante Descoberta. Consulte GlideRecordUtil para obter descrições dos métodos disponíveis.

Obtendo uma instância GlideRecord

Para obter um GlideRecord para um determinado item de configuração e da classe e tabela corretas, use GetCIGR(sys_id) método. Por exemplo, o código a seguir obtém o GlideRecord de um IC com o sys_id de 2dfd7c8437201000deeabfc8bcbe5d56:

var now_GR = new GlideRecordUtil().getCIGR("2dfd7c8437201000deeabfc8bcbe5d56");

Para recuperar qualquer tabela hierárquica sem saber seu tipo de classe, use GetGR(base_table, sys_id) método. Por exemplo, para obter um GlideRecord para um IC de classe de computador, você pode ter que distinguir se é uma classe de computador, Windowsou Linuxclasse de servidor. Usar este método garante um GlideRecord com a classe correta. Classes diferentes têm atributos diferentes. Neste caso de uso, um Windowso servidor tem atributos diferentes de a. Linuxservidor. O exemplo a seguir mostra como obter um GlideRecord na classe correta com seus atributos.

var now_GR = new GlideRecordUtil().getGR( "cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");

Obtendo todos os campos em um GlideRecord

. GetFields (NOW_GR) O método retorna um objeto JavaScript, como um hashmap, de todos os campos ou atributos que existem em um determinado GlideRecord.

var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56");
var fields = new GlideRecordUtil().getFields(now_GR);
gs.log(fields.join(" ")); // List all the fields that are in a computer CI

Preenchendo campos de objeto GlideRecord

. PopulateFromGR(hashmap, gr, ignorar) O método permite que você pegue um objeto GlideRecord e preencha seus campos e valores em um objeto JavaScript. O terceiro argumento ( ignorar ) É um objeto JavaScript opcional que permite excluir determinados campos. Por exemplo, você pode não se importar sys_created_byou sys_updated_byCampos em um GlideRecord.

var objectToPopulate = { }; 
var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56"); 
var ignore = {"sys_created_on": true, "sys_updated_by": true}; 
new GlideRecordUtil().populateFromGR(objectToPopulate, now_GR, ignore); 
// Now the objectToPopulate contains field/value pairs from the computer GlideRecord

. MergeToGR(hashmap, gr, ignorar) O método permite preencher um GlideRecord com um objeto pareado com campo/valor. O argumento ignorar impede que os campos especificados sejam atualizados. O exemplo de código a seguir atualiza um registro de computador namee. os, mas não atualiza o. sys_created_bycampo:

var now_GR = new GlideRecordUtil().getGR("cmdb_ci_computer", "2dfd7c8437201000deeabfc8bcbe5d56"); 
var obj = {"name": "xyz", "os": "windows 2000", "sys_created_by", "aleck.lin"};
var ignore = {"sys_created_by": true}; 
new GlideRecordUtil().mergeToGR(obj, gr, ignore);
gr.update();

Obtendo hierarquias de tabela

. GetTables (tabela) o método retorna uma lista de hierarquias de tabela, conforme mostrado no exemplo a seguir:

var tables = new GlideRecordUtil().getTables("cmdb_ci_linux_server");
gs.log(tables.join(",")); 
// The result would be "cmdb_ci, cmdb_ci_computer, cmdb_ci_server, cmdb_ci_linux_server".

Usando DiscoveryException e AutomationException

Ao escrever DescobertaSensores e scripts relacionados a sensores, você pode usar DiscoveryException ou AutomationException para indicar que uma exceção veio de Descoberta.

. Descoberta extensões de inclusão de script AutomationException , que estende o. Exceção genérica classe. O exemplo a seguir usa Descoberta para lançar uma exceção:

function foo() { 
  if(//condition matches) throw new DiscoveryException("The message", "The cause"); }

O primeiro argumento usa a mensagem da exceção e o segundo argumento (opcional) usa a causa da exceção. Você também pode querer capturar a exceção e registrá-la como mostrado no exemplo abaixo:

try {
  foo(); 
} 
catch(e) { 
   if(e instanceof DiscoveryException)
     gs.log("A DiscoveryException occurred. It is " + e. getMessage() + " caused by " + e.getCause()); }

O exemplo acima também se aplica a AutomationException . Descoberta É normalmente usado para fornecer processamento de exceção especificamente para a Descoberta, enquanto AutomationException É usado para processamento de exceções que se aplica à Orquestração e. Descoberta.