GlideSPScriptable - Com escopo

. GlideSPScriptable A API fornece métodos para interagir com dados e executar operações de registro no Portal de serviços widgets.

Você acessa GlideSPScriptable usando global sp objeto.

GlideSPScriptable - canReadRecord(GlideRecord now_GR)

Retorna verdadeiro se o usuário puder ler o GlideRecord especificado.

Se o tipo de registro for kb_knowledge , sc_cat_item ou sc_category , o método verifica se o usuário pode exibir o item.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	GlideRecord a ser verificado.

Tabela 2. Retornos

Tipo	Descrição
Booliano	Verdadeiro se o registro for válido e legível.

Script do servidor

//Server script
data.items = [];
data.userName = gs.getUserDisplayName();
var now_GR = new GlideRecord("sc_cat_item");
now_GR.query();
while(now_GR.next() && data.items.length < 10) {
    if ($sp.canReadRecord(now_GR)) {
    data.items.push(now_GR.getDisplayValue("name"));
    }
}

//HTML template
<div class="panel panel-default">
    <div class="panel-heading">Hi, {{c.data.userName}}!</div>
    <div class="panel-body">
        Here are some things you can order:
        <ul><li ng-repeat="item in c.data.items">{{item}}</li></ul>
    </div>
</div>

GlideSPScriptable - canReadRecord (tabela de cadeia de caracteres, cadeia de caracteres SYSID)

Retorna verdadeiro se o usuário puder ler o GlideRecord especificado.

Se o tipo de registro for kb_knowledge , sc_cat_item ou sc_category , o método verifica se o usuário pode exibir o item.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
tabela	Cadeia de caracteres	Nome da tabela a ser consultada.
sysId	Cadeia de caracteres	Sys_id do registro a ser consultado.

Tabela 4. Retornos

Tipo	Descrição
Booliano	Verdadeiro se o registro for válido e legível.

GlideSPScriptable - canSeePage(cadeia de caracteres pageID)

Retorna verdadeiro se o usuário conectado no momento tiver permissão para exibir a página especificada.

O sistema determina a permissão usando funções e critérios do usuário. Para obter mais informações, consulte Configure a segurança da página por função e. Critérios do usuário para o Portal de serviços .

Tabela 5. Parâmetros

Nome	Tipo	Descrição
PageID	Cadeia de caracteres	ID da página da tabela Páginas [sp_page].

Tabela 6. Retornos

Tipo	Descrição
Booliano	Sinalizador que indica se o usuário conectado no momento tem permissões para exibir a página especificada. Os valores incluem: Verdadeiro: O usuário pode exibir a página. Falso: O usuário não pode exibir a página, o pageID fornecido não é válido ou o usuário não está conectado.

Este exemplo adiciona uma condição ao item de menu Conhecimento no Menu do cabeçalho SP para mostrar somente o item de menu para usuários que têm permissão para exibir a página kb_view2.

GlideSPScriptable.canSeePage("kb_view2")

GlideSPScriptable - getCatalogItem(cadeia de caracteres SYSID)

Retorna um modelo e um modelo de exibição para um sc_cat_item ou sc_cat_item_guide .

Este método foi descontinuado. Use GetCatalogItem (SYSID de cadeia de caracteres, booliano isOrdering) em vez disso. Este método chama o. GetCatalogItem (SYSID de cadeia de caracteres, booliano isOrdering) método com isOrderingparâmetro definido como falso, o que significa que a verificação de segurança das funções de gravação foi concluída.

Este método é uma maneira rápida de obter os dados necessários para renderizar e solicitar um item do catálogo usando <sp-model /> . Se você só precisar obter um item do catálogo para mostrar sua imagem ou nome, use GlideRecord para consultar o. sc_cat_item tabela.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
sysId	Cadeia de caracteres	O sys_id do item do catálogo ( sc_cat_item ou guia de pedido ( sc_cat_item_guide ).

Tabela 8. Retornos

Tipo	Descrição
Objeto	Um objeto que contém o modelo de variável de item do catálogo, exibição, seções, preço e scripts de cliente.

// Server script
(function() {
    var sys_id = $sp.getParameter("sys_id")
    data.catItem = $sp.getCatalogItem(sys_id);
})();

// Client script
function($http, spUtil) {
    var c = this;
    var submitting = false;
    c.getIt = function() {
        if (submitting) return;
        $http.post(spUtil.getURL('sc_cat_item'), c.data.catItem).success(function(response) {
            if (response.answer) {
                c.req = response.answer;
                c.req.page = c.req.table == 'sc_request' ? 'sc_request' : 'ticket';
            }
        });
    }
}

//SCSS
.img-bg {
    padding: 5px;
    background-color: $brand-primary;
}

.img-responsive {
    margin: 0 auto;
}

.cat-icon {
    display: block;
    margin: -40px auto 0;
}

// HTML template
<div class="col-sm-4">
  <div class="panel panel-default">
    <div class="img-bg">
      <img ng-src="{{::data.catItem.picture}}" class="img-responsive" />
    </div>
    <span class="cat-icon fa fa-stack fa-lg fa-3x hidden-xs">
      <i class="fa fa-circle fa-stack-2x text-success"></i>
      <i class="fa fa-desktop fa-stack-1x fa-inverse"></i>
    </span>
    <div class="panel-body">
      <p class="lead text-center">{{::data.catItem.name}}</p>
      <ul class="list-unstyled">
        <li class="text-center" ng-if="::data.catItem.price">${Price}: {{::data.catItem.price}}</li>
      </ul>
      <sp-model form-model="::data.catItem" mandatory="mandatory"></sp-model>
      <p ng-if="c.req" class="text-center text-success">
        ${Request created!} <a href="?id={{c.req.page}}&table={{c.req.table}}&sys_id={{c.req.sys_id}}">{{c.req.number}}</a>
      </p>
      <button ng-if="!c.req" class="btn btn-default btn-block" ng-click="c.getIt()">${Get it}</button>
    </div>
  </div>
</div>

GlideSPScriptable - getCatalogItem(cadeia de caracteres SYSID, booliano isOrdering)

Retorna um modelo e um modelo de exibição para um sc_cat_item ou sc_cat_item_guide .

Tabela 9. Parâmetros

Nome	Tipo	Descrição
sysId	Cadeia de caracteres	O sys_id do item do catálogo ( sc_cat_item ou guia de pedido ( sc_cat_item_guide ).
IsOrdering	Booliano	Quando verdadeiro, usa a verificação de segurança Criar funções. Quando falso, usa a verificação de segurança de funções de gravação. Quando os usuários estiverem solicitando um item ou o tiverem no carrinho, marque usando as funções Criar. Se os usuários não estiverem solicitando, por exemplo, alguém estiver olhando um item solicitado para ver as variáveis associadas a esse item, verifique usando as funções de gravação.

Tabela 10. Retornos

Tipo	Descrição
Objeto	Um objeto que contém o modelo de variável de item do catálogo, exibição, seções, preço e scripts de cliente.

GlideSPScriptable - getDisplayValue(cadeia de caracteres fieldName)

Retorna o valor de exibição do campo especificado (se ele existir e tiver um valor) do widget sp_instance ou sp_portal registro.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
fieldName	Cadeia de caracteres	Nome do campo

Tabela 12. Retornos

Tipo	Descrição
Cadeia de caracteres	O valor de exibição de sp_instance ou sp_portal registro.

//Server script
(function() {
    data.title = $sp.getDisplayValue("title");
    data.catalog = $sp.getDisplayValue("sc_catalog");
})();

//HTML template
<div>
    <h1>sp_instance.title: {{::data.title}}</h1>
    <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
</div>

GlideSPScriptable - getField(GlideRecord now_GR, cadeia de caracteres fieldName)

Retorna informações sobre o campo especificado no GlideRecord especificado.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	GlideRecord a ser verificado
fieldName	Cadeia de caracteres	O campo para encontrar informações

Tabela 14. Retornos

Tipo	Descrição
Objeto	Um objeto que contém o rótulo, o valor, o displayValue e o tipo do campo. Retorna nulo se o GlideRecord do nome do campo não for válido ou se o campo não for legível.

GlideSPScriptable - getFields(GlideRecord now_GR, cadeia de caracteres fieldnames)

Verifica a lista especificada de nomes de campos e retorna uma matriz de nomes de campos válidos.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	GlideRecord a ser verificado
Nomes dos campos	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campos.

Tabela 16. Retornos

Tipo	Descrição
Matriz	Uma matriz de campos válidos.

GlideSPScriptable - getFieldsObject(GlideRecord now_GR, cadeia de caracteres fieldnames)

Verifica a lista especificada de nomes de campo e retorna um objeto de nomes de campo válidos.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	GlideRecord a ser verificado
Nomes dos campos	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campos.

Tabela 18. Retornos

Tipo	Descrição
Objeto	Um objeto que contém nomes de campos válidos.

GlideSPScriptable - getForm(cadeia de caracteres tablename, cadeia de caracteres SYSID)

Retorne o formulário associado ao nome da tabela e ao registro sys_id aprovados.

Nota:

O método impõe privilégios de acesso entre escopos à tabela especificada e ao registro associado.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela na qual o formulário reside.
sysId	Cadeia de caracteres	Sys_id do formulário.

Tabela 20. Retornos

Tipo	Descrição
Objeto	Formulário solicitado.

var sp = new GlideSPScriptable('');
var res = sp.getForm('sys_user', '6816f79cc0a8016401c5a33be04be441');    // User sys ID information
gs.info('Name: ' + res._fields.name.value);
gs.info('E-mail: ' + res._fields.email.value);

Saída:

Name: Harry Jones
 E-mail: [e-mail]

GlideSPScriptable - getKBCategoryArticles(cadeia de caracteres sys_id, limite de número)

Retorna artigos da base de conhecimento na categoria especificada e suas subcategorias.

Para evitar problemas de desempenho, não use este método para retornar artigos em categorias grandes ou artigos com imagens em linha. Em vez disso, use GetKBArticleResumos() .

Tabela 21. Parâmetros

Nome	Tipo	Descrição
sys_id	Cadeia de caracteres	Sys_id da categoria de artigo da base de conhecimento.
limite	Número	Número máximo de artigos da base de conhecimento retornados.

Tabela 22. Retornos

Tipo	Descrição
Matriz	Os artigos dentro da categoria e suas subcategorias com: . workflow_state de publicado . . valid_to data posterior ou igual à data atual.

//Server script 
(function() {
    data.kbs = $sp.getKBCategoryArticles("0ac1bf8bff0221009b20ffffffffffec", 5);
})();

//HTML template
<div>
articles: {{::data.kbs}}
</div>

GlideSPScriptable - getKBCategoryArticleSummaries(cadeia de caracteres sys_id, limite de número, número maxChars)

Retorna resumos de artigos da Base de conhecimento na categoria especificada e suas subcategorias.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
sys_id	Cadeia de caracteres	Sys_id da categoria de artigo da base de conhecimento.
limite	Número	Número máximo de artigos da base de conhecimento retornados.
MaxCaracteres	Número	Número máximo de caracteres a serem retornados do texto do artigo. Para o texto completo do artigo, defina o valor como -1 .

Tabela 24. Retornos

Tipo	Descrição
Matriz	Os artigos dentro da categoria e suas subcategorias com: . workflow_state de publicado . . valid_to data posterior ou igual à data atual.

//Server script 
(function() {
    data.summary = $sp.getKBCategoryArticleSummaries("0ac1bf8bff0221009b20ffffffffffec", 5, 200);
})();

//HTML template
<div>
articles: {{::data.summary}}
</div>

GlideSPScriptable - getKBCount(cadeia de caracteres sys_id)

Retorna o número de artigos na Base de conhecimento definida.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
sys_id	Cadeia de caracteres	Sys_id de um registro da Base de conhecimento.

Tabela 26. Retornos

Tipo	Descrição
Número	Número de artigos de conhecimento na Base de conhecimento definida com: . workflow_state de publicado . . valid_to data posterior ou igual à data atual.

//Server script 
(function() {
    data.count = $sp.getKBCount("a7e8a78bff0221009b20ffffffffff17");
})();

//HTML template
<div>
articles: {{::data.count}}
</div>

GlideSPScriptable - getListColumns(cadeia de caracteres tablename, exibição de cadeia de caracteres)

Retorna uma lista das colunas da tabela especificada na exibição especificada.

Tabela 27. Parâmetros

Nome	Tipo	Descrição
tableName	Cadeia de caracteres	Nome da tabela
exibição	Cadeia de caracteres	A exibição pela qual filtrar as colunas

Tabela 28. Retornos

Tipo	Descrição
Objeto	Um objeto que contém os nomes das colunas.

GlideSPScriptable - getMenuItems (SYSID de cadeia de caracteres)

Retorna uma matriz de itens de menu para a instância especificada.

Tabela 29. Parâmetros

Nome	Tipo	Descrição
sysId	Cadeia de caracteres	SYSID da instância

Tabela 30. Retornos

Tipo	Descrição
Matriz	Itens de menu para a instância especificada

GlideSPScriptable - getMenuHREF(página GlideRecord)

Retorna a parte da URL com base no tipo sp_menu.

Tabela 31. Parâmetros

Nome	Tipo	Descrição
página	GlideRecord	A página

Tabela 32. Retornos

Tipo	Descrição
Cadeia de caracteres	A parte href do URL.

GlideSPScriptable - getParameter(nome da cadeia de caracteres)

Retorna o valor do parâmetro especificado.

Tabela 33. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	O nome da chave da cadeia de caracteres de consulta ou do corpo da publicação.

Tabela 34. Retornos

Tipo	Descrição
Objeto	Retorna o parâmetro especificado como um objeto. Retorna nulo se não houver solicitação, solicitação JSON ou widget.

GlideSPScriptable - getPortalRecord()

Retorna o registro do portal da tabela Portais de serviço [sp_portal].

Tabela 35. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 36. Retorna

Tipo	Descrição
GlideRecord	O registro do portal atual da tabela Portais de serviço [sp_portal].

//Server script
(function() {
    var portalGr = $sp.getPortalRecord();
    data.logo = portalGr.getDisplayValue("logo");
    data.homepage = portalGr.getDisplayValue("homepage.id");
})();

//HTML template
<div>
    <img ng-src="{{::c.data.logo}}" />
    <a href="?id={{::c.data.homepage}}">Click here to go home</a>
</div>

GlideSPScriptable - getRecord (tabela de cadeia de caracteres, cadeia de caracteres sys_id)

Se os parâmetros forem fornecidos, retornará o GlideRecord identificado pela tabela fornecida e o SYS ID. Se nenhum parâmetro for fornecido, retornará o registro identificado pelo URL atual.

Tabela 37. Parâmetros

Nome	Tipo	Descrição
tabela	Cadeia de caracteres	Opcional. A tabela do registro a ser retornado. Se nenhum parâmetro for incluído, retornará a tabela e o SYS ID identificados pelo URL atual.
sys_id	Cadeia de caracteres	Opcional. O SYS ID do registro a ser retornado. Se nenhum parâmetro for incluído, retornará o registro identificado pelo URL atual.

Tabela 38. Retornos

Tipo	Descrição
GlideRecord	Se os parâmetros forem fornecidos, retornará o registro identificado pela tabela e pelo SYS ID fornecidos. Se nenhum parâmetro for fornecido, retornará o registro identificado pelo URL atual. Retorna nulo se o widget for incorporado por outro widget ou se o registro dos parâmetros fornecidos não for encontrado.

//Server script 
(function(){ 
var now_GR = $sp.getRecord(); 
data.tableLabel = now_GR.getLabel(); 
})(); 

//HTML template 
<div class="panel-heading"> 
<h4 class="panel-title">${{{data.tableLabel}} details}</h4> 
</div>

GlideSPScriptable - getRecordDisplayValues(Dados do objeto, GlideRecord de, Nomes de cadeia de caracteres)

Cópias exibem valores para os campos especificados no parâmetro de dados.

Tabela 39. Parâmetros

Nome	Tipo	Descrição
dados	Objeto	Os valores de exibição dos campos especificados são copiados para este objeto.
de	GlideRecord	GlideRecord a ser processado.
nomes	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campos.

Tabela 40. Retornos

Tipo	Descrição
vazio

GlideSPScriptable - getRecordElements(Dados do objeto, GlideRecord de, Nomes de cadeia de caracteres)

Para os campos especificados, copia o nome do elemento, o valor de exibição e o valor para o parâmetro de dados.

Tabela 41. Parâmetros

Nome	Tipo	Descrição
dados	Objeto	O nome do elemento, o valor de exibição e o valor dos campos especificados são copiados para este objeto.
de	GlideRecord	GlideRecord a ser processado.
nomes	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campos.

Tabela 42. Retornos

Tipo	Descrição
vazio

GlideSPScriptable - getRecordValues(Dados do objeto, GlideRecord de, Nomes de cadeia de caracteres)

Copia valores para os nomes de campos especificados do GlideRecord para o parâmetro de dados.

Tabela 43. Parâmetros

Nome	Tipo	Descrição
dados	Objeto	O valor dos campos especificados é copiado para este objeto.
de	GlideRecord	GlideRecord a ser processado.
nomes	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campos.

Tabela 44. Retornos

Tipo	Descrição
vazio

GlideSPScriptable - getRecordVariables(GlideRecord now_GR, booliano includeNilResponses)

Retorna Catálogo de serviços Variáveis associadas a um registro no formato Cadeia de caracteres.

Tabela 45. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	O registro a ser recuperado Catálogo de serviços variáveis para. Deve ser um registro com Catálogo de serviços variáveis definidas, como um registro de item solicitado [sc_req_item] ou um incidente enviado por meio de um produtor de registro.
IncludeNilResponses	Booliano	Opcional. Se verdadeiro, a API incluirá variáveis sem valor definido pelo usuário.

Tabela 46. Retornos

Tipo	Descrição
Cadeia de caracteres	Catálogo de serviços variáveis associadas ao registro.

//Server script 
(function() {
var itemsGR = new GlideRecord("sc_req_item");
itemsGR.get('585d1bc44f4f13008a959a211310c77d');
	
data.scVars = $sp.getRecordVariables(itemsGR);

})();

//HTML template
<div>
Requested item variables: {{::data.scVars}}
</div>

Saída:

Requested item variables: [
  {
    "display_value":"MetroPCS",
    "name":"carrier",
    "visible_summary":true,
    "id":"585d1bc44f4f13008a959a211310c77c",
    "label":"Allocated carrier",
    "type":"5",
    "value":"metropcs",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Unlimited",
    "name":"data_plan",
    "visible_summary":true,
    "id":"d05d1bc44f4f13008a959a211310c77c",
    "label":"Monthly data allowance",
    "type":"5",
    "value":"unlimited",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"12 Months",
    "name":"duration",
    "visible_summary":true,
    "id":"d85d1bc44f4f13008a959a211310c77c",
    "label":"Contract duration",
    "type":"5",
    "value":"twelve_months",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Slate",
    "name":"color",
    "visible_summary":true,
    "id":"545d1bc44f4f13008a959a211310c77c",
    "label":"Color",
    "type":"5",
    "value":"slate",
    "visible_standalone":true,
    "visible_guide":true
  },
  {"display_value":"64GB",
    "name":"storage",
    "visible_summary":true,
    "id":"d45d1bc44f4f13008a959a211310c77c",
    "label":"Storage",
    "type":"5",
    "value":"sixtyfour",
    "visible_standalone":true,
    "visible_guide":true
  }
]

GlideSPScriptable - getRecordVariablesArray(GlideRecord Now_GR, booliano includeNilResponses)

Retorna uma matriz de Catálogo de serviços variáveis associadas a um registro.

Tabela 47. Parâmetros

Nome	Tipo	Descrição
Now_GR	GlideRecord	O registro a ser recuperado Catálogo de serviços variáveis para. Deve ser um registro com Catálogo de serviços variáveis definidas, como um registro de item solicitado [sc_req_item] ou um incidente enviado por meio de um produtor de registro.
IncludeNilResponses	Booliano	Opcional. Se verdadeiro, a API incluirá variáveis sem valor definido pelo usuário.

Tabela 48. Retornos

Tipo	Descrição
Objeto	Matriz de Catálogo de serviços variáveis associadas ao registro.

//Server script 
(function() {
var itemsGR = new GlideRecord("sc_req_item");
itemsGR.get('585d1bc44f4f13008a959a211310c77d');
	
data.scVars = $sp.getRecordVariablesArray(itemsGR);

})();

//HTML template
<div>
Requested item variables: {{::data.scVars}}
</div>

Saída:

Requested item variables: [
  {
    "display_value":"MetroPCS",
    "name":"carrier",
    "visible_summary":true,
    "id":"585d1bc44f4f13008a959a211310c77c",
    "label":"Allocated carrier",
    "type":"5",
    "value":"metropcs",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Unlimited",
    "name":"data_plan",
    "visible_summary":true,
    "id":"d05d1bc44f4f13008a959a211310c77c",
    "label":"Monthly data allowance",
    "type":"5",
    "value":"unlimited",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"12 Months",
    "name":"duration",
    "visible_summary":true,
    "id":"d85d1bc44f4f13008a959a211310c77c",
    "label":"Contract duration",
    "type":"5",
    "value":"twelve_months",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Slate",
    "name":"color",
    "visible_summary":true,
    "id":"545d1bc44f4f13008a959a211310c77c",
    "label":"Color",
    "type":"5",
    "value":"slate",
    "visible_standalone":true,
    "visible_guide":true
  },
  {"display_value":"64GB",
    "name":"storage",
    "visible_summary":true,
    "id":"d45d1bc44f4f13008a959a211310c77c",
    "label":"Storage",
    "type":"5",
    "value":"sixtyfour",
    "visible_standalone":true,
    "visible_guide":true
  }
]

GlideSPScriptable - getStream (tabela de cadeia de caracteres, cadeia de caracteres SYSID)

Obtém o fluxo de atividades do registro especificado. Este método funciona em tabelas que estendem a tabela de tarefas.

Tabela 49. Parâmetros

Nome	Tipo	Descrição
tabela	Cadeia de caracteres	O nome da tabela
sysID	Cadeia de caracteres	O sys_id do registro

Tabela 50. Retornos

Tipo

Descrição

Objeto

Se uma tabela que estende a tabela de tarefas for especificada, conterá display_value, sys_id, short_description,number, entradas, user_sys_id, user_full_name, user_login, rótulo, tabela, e journal_fields; caso contrário, contém as propriedades table e sys_id. Nota: A propriedade user_login contém o ID do usuário atual. As propriedades user_sys_id e iser_full_name fazem referência ao criador do registro consultado.

GlideSPScriptable - getUserInitials()

Retorna as iniciais do usuário.

Tabela 51. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 52. Retorna

Tipo	Descrição
Cadeia de caracteres	Iniciais do usuário

GlideSPScriptable - getValue (nome da cadeia de caracteres)

Retorna o valor nomeado da solicitação JSON, instância ou portal.

Tabela 53. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	Nome da solicitação JSON, instância ou portal.

Tabela 54. Retornos

Tipo	Descrição
Objeto	Valor do parâmetro especificado. Nulo se a entidade especificada não existir ou não tiver esse parâmetro.

//Server script
(function() {
    data.title = $sp.getValue("title");
    data.catalog = $sp.getValue("sc_catalog");
})();

//HTML templage
<div>
    <h1>sp_instance.title: {{::data.title}}</h1>
    <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
</div>

GlideSPScriptable - getValues (dados do objeto, nomes de cadeia de caracteres)

Copia valores da solicitação ou instância para o parâmetro de dados.

Tabela 55. Parâmetros

Nome	Tipo	Descrição
dados	Objeto	Recebe os valores do parâmetro.
nomes	Cadeia de caracteres	Cadeia de caracteres separada por vírgulas de nomes de campos.

Tabela 56. Retornos

Tipo	Descrição
vazio

GlideSPScriptable - getVariablesArray(boolian includeNilResponses)

Retorna uma matriz de Catálogo de serviços Variáveis associadas ao registro no URL.

Por exemplo, se o URL incluir os parâmetros sc_req_item&sys_id: 832e9620db4f330083766b984b9619cf , A API retorna as variáveis associadas ao registro fornecido na tabela Item solicitado [sc_req_item]. Deve ser um registro com Catálogo de serviços variáveis definidas, como um registro de item solicitado [sc_req_item] ou um incidente enviado por meio de um produtor de registro.

Tabela 57. Parâmetros

Nome	Tipo	Descrição
IncludeNilResponses	Booliano	Opcional. Se verdadeiro, a API incluirá variáveis sem valor definido pelo usuário.

Tabela 58. Retornos

Tipo	Descrição
Objeto	Matriz de variáveis associadas à tabela.

//Server script 
(function() {	
data.scVars = $sp.getVariablesArray();
})();

//HTML template
<div Current record variables: {{::data.scVars}} ></div>

Saída:

Current record variables: [
  {
    "display_value":"unlimited",
    "name":"data","visible_summary":
    true,"id":"472e5620db4f330083766b984b96198a",
    "label":"Data",
    "type":"6",
    "value":"unlimited",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Black",
    "name":"color",
    "visible_summary":true,
    "id":"c72e5620db4f330083766b984b96198a",
    "label":"Color",
    "type":"6",
    "value":"Black",
    "visible_standalone":true,
    "visible_guide":true
  }
] 

GlideSPScriptable - getWidget(cadeia de caracteres SYSID, opções de objeto)

Obtém um widget por ID ou sys_id, executa o script de servidor desse widget usando as opções fornecidas e retorna o modelo de widget.

Tabela 59. Parâmetros

Nome	Tipo	Descrição
sysID	Cadeia de caracteres	O widget sys_id ou widget_id
opções	Objeto	Um objeto a ser passado para o script do servidor do widget. Consulte este objeto como opções no script do servidor. Nota: Todas as opções passadas para esta função só estarão disponíveis no script do servidor do widget incorporado no primeira execução desse script. As chamadas subsequentes no script do servidor do widget incorporado não conterão as propriedades do objeto passadas.

Tabela 60. Retornos

Tipo	Descrição
Objeto	Um modelo de widget a ser usado com sp-widget.

//Server script
data.myWidget = $sp.getWidget('widget_id', {p1: param1, p2: param2});

//HTML
<sp-widget widget="c.data.myWidget"></sp-widget>

GlideSPScriptable - isRTLEnabled()

Verifica se o portal associado está habilitado para o idioma da direita para a esquerda (RTL) e se o idioma do usuário atual é RTL direcional.

Use este método para determinar se há necessidade de um CSS específico de RTL na IU do portal.

Tabela 61. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 62. Retorna

Tipo	Descrição
Booliano	Sinalizador que indica se o sinalizador RTL está habilitado e se o idioma da sessão do usuário atual é RTL direcional. Valores possíveis: Verdadeiro: O sinalizador RTL está habilitado. Falso: O sinalizador RTL não está habilitado. Tipo de dados: Booliano

O exemplo de código a seguir mostra como usar esse método para determinar o tipo de ícone a ser exibido na página do portal.

// Server script  
(function() {
  data.isRTLEnabled = $sp.isRTLEnabled();
 })(); 

// HTML template 
<div> <i ng-class="c.data.isRTLEnabled ? 'fa fa-arrow-right' : 'fa fa-arrow-left'"></i> </div> 

GlideSPScriptable - isUserCriteriaEnabled()

Retorna verdadeiro se os critérios do usuário estiverem habilitados.

Este método retorna verdadeiro se Suporte a critérios do usuário do Portal de serviços o plug-in (com.glide.service-portal.user-criteria) está ativo e o Habilite o uso de registros de Critérios do usuário em vez de campos Funções para direitos do Portal de serviços (glide.service_portal.user_criteria_enabled) a propriedade do sistema está definida como verdadeira.

Tabela 63. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 64. Retorna

Tipo	Descrição
Booliano	Verdadeiro se os critérios do usuário estiverem habilitados.

GlideSPScriptable - log (mensagem do objeto)

Saída de logs para a tabela Entradas de log do Portal de serviços [sp_log]. O usuário conectado deve ter a função sp_admin ou admin.

Tabela 65. Parâmetros

Nome	Tipo	Descrição
mensagem	Objeto	Objeto JavaScript ou cadeia de caracteres que representa a mensagem a ser enviada como saída em um Portal de serviços página.

Tabela 66. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como registrar em log um erro predefinido se ele ocorrer.

var demo_data = null;
var params = null;
if (gr.getValue("demo_data")) {
   try {
	demo_data = JSON.parse(gr.getValue("demo_data"));
	params = (demo_data.options) ? demo_data.options : null;
	} catch(e) {
	$sp.log(e);
   }
}

GlideSPScriptable - mapUrlToSPUrl(url da cadeia de caracteres)

Transforma uma URL que solicita uma lista ou formulário na IU da plataforma na URL do correspondente id: lista ou id: formulário Página do Portal de serviços.

Use este método para executar tarefas como redirecionar um usuário após o login para a página correta do Portal de serviços quando ele solicitar um formulário de IU da plataforma ou URL de lista. Observe que id: lista e. id: formulário as metas de página não são personalizáveis.

Nota:

Os valores table, sys_id e sysparm_query são preservados da URL original; sysparm_view não é.

Tabela 67. Parâmetros

Nome	Tipo	Descrição
URL	Cadeia de caracteres	URL da IU da plataforma

Tabela 68. Retornos

Tipo	Descrição
Cadeia de caracteres	URL do Portal de serviços transformado. Se o URL aprovado não solicitar uma lista ou um formulário na IU da plataforma, um valor nulo será retornado.

Exemplo de lista

GlideSPScriptable().mapUrlToSPUrl("http://demo.service-now.com/task_list.do?sysparm_userpref_module=1523b8d4c611227b00be8216ec331b9a&sysparm_query=assigned_to=javascript:getMyAssignments()&sysparm_clear_stack=true"))

Retornos

id=list&table=task&filter=assigned_to=javascript:getMyAssignments()&sys_id=&v=

Exemplo de formulário

GlideSPScriptable().mapUrlToSPUrl("incident.do?sys_id=12bc12bc12bc12bc12bc12bc12bc12bc")

Retornos

id=form&table=incident&filter=&sys_id=12bc12bc12bc12bc12bc12bc12bc12bc&v=

GlideSPScriptable - userCanSeeSearchSourceByCriteria (cadeia de caracteres searchSourceID)

Retorna verdadeiro se o usuário atual puder ver uma fonte de pesquisa especificada pelo searchSourceID.

Retorna verdadeiro se o usuário não estiver restrito por critérios do usuário. Para obter mais detalhes sobre como os critérios do usuário afetam os ativos do Portal de serviços, consulte Critérios do usuário para o Portal de serviços .

Nota:

Este método não avalia as permissões baseadas em função da origem de pesquisa e só deve ser usado se os Critérios do usuário estiverem habilitados.

Tabela 69. Parâmetros

Nome	Tipo	Descrição
SearchSourceID	Cadeia de caracteres	Sys_id do registro de origem de pesquisa.

Tabela 70. Retornos

Tipo	Descrição
Booliano	Verdadeiro se o usuário atual tiver acesso de leitura à origem de pesquisa.