GlideSPScriptable - com escopo

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

Você acessa os métodos GlideSPScriptable usando o objeto global $sp.

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_itemou sc_category, o método verificará se o usuário pode exibir o item.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
now_GR	GlideRecord	O 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(cadeia de caracteres tabela, 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_itemou sc_category, o método verificará 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 Configuração da segurança de 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 de cabeçalho SP para mostrar o item de menu somente para usuários que tenham 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 está obsoleto. Em vez disso, use o método getCatalogItem(String sysId, Boolean isOrdering). Este método chama o método getCatalogItem(String sysId, Boolean isOrdering) com o parâmetro isOrdering 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 que um item do catálogo mostre sua imagem ou nome, use GlideRecord para consultar a tabela sc_cat_item.

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 do item do catálogo, exibição, seções, preços e client scripts.

// 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).
estáPedido	Booliano	Quando verdadeiro, usa a verificação de segurança de funções de criação. 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, verifique usando as funções de criação. Se os usuários não estiverem solicitando, por exemplo, alguém estiver observando 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 do item do catálogo, exibição, seções, preços e client scripts.

GlideSPScriptable - getDisplayValue(cadeia de caracteres fieldName)

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

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 do registro sp_instance ou sp_portal.

//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	O GlideRecord a ser verificado
fieldName	Cadeia de caracteres	O campo para encontrar informações para

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, String fieldNames)

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

Tabela 15. Parâmetros

Nome	Tipo	Descrição
now_GR	GlideRecord	O GlideRecord a ser verificado
Nomes de campo	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campo.

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	O GlideRecord a ser verificado
Nomes de campo	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campo.

Tabela 18. Retornos

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

GlideSPScriptable - getForm(cadeia de caracteres "tableName", cadeia de caracteres sysId)

Retorna o formulário associado ao nome da tabela aprovado e ao sys_id do registro.

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 getKBArticleSummaries().

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 na categoria e suas subcategorias com: Um workflow_state de publicado. Uma data valid_to maior 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.
máx. de caracteres	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 na categoria e suas subcategorias com: Um workflow_state de publicado. Uma data valid_to maior 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: Um workflow_state de publicado. Uma data valid_to maior 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(cadeia de caracteres sysId)

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 (?id=) do 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 da URL.

GlideSPScriptable - getParameter(String name)

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 para o 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(cadeia de caracteres tabela, cadeia de caracteres sys_id)

Se os parâmetros forem fornecidos, retornará o GlideRecord identificado pela tabela fornecida e pelo 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 retornar. Se nenhum parâmetro estiver incluído, retornará a tabela e o SYS ID identificado pelo URL atual.
sys_id	Cadeia de caracteres	Opcional. O SYS ID do registro a ser retornado. Se nenhum parâmetro estiver 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 fornecida e pelo SYS ID. 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)

Copia valores de exibição dos 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	O GlideRecord a ser processado.
nomes	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campo.

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 no 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	O GlideRecord a ser processado.
nomes	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campo.

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 campo 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	O GlideRecord a ser processado.
nomes	Cadeia de caracteres	Uma lista separada por vírgulas de nomes de campo.

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 de cadeia de caracteres.

Tabela 45. Parâmetros

Nome	Tipo	Descrição
now_GR	GlideRecord	O registro para recuperar Catálogo de serviços variáveis. 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 inclui 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 para recuperar Catálogo de serviços variáveis. 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 inclui 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(cadeia de caracteres tabela, 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á as propriedades display_value, sys_id, short_description,number, entradas, user_sys_id, user_full_name, user_login, label, table e journal_fields; caso contrário, contém a tabela e as propriedades 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	As iniciais do usuário

GlideSPScriptable - getValue(String name)

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

Tabela 53. Parâmetros

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

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 das cadeias 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 de parâmetro.
nomes	Cadeia de caracteres	Cadeia de caracteres separada por vírgulas de nomes de campo.

Tabela 56. Retornos

Tipo	Descrição
vazio

GlideSPScriptable - getVariablesArray(Booliano includeNilResponses)

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

Por exemplo, se o URL incluir os parâmetros id=form&table=sc_req_item&sys_id=832e9620db4f330083766b984b9619cf, a API retornará 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 inclui 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 do 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 na primeira execução desse script. Quaisquer chamadas subsequentes para o script do servidor a partir 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 de RTL está habilitado. falso: o sinalizador de RTL não está habilitado. Tipo de dados: booliano

O exemplo de código a seguir mostra como usar este 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 retornará verdadeiro se o plug-in Suporte aos critérios do usuário do Portal de serviços (com.glide.service-portal.user-criteria) estiver ativo e os campos Habilitar uso de registros de critérios do usuário em vez de 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)

Registra a saída 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 ou cadeia de caracteres JavaScript que representa a mensagem a ser enviada como saída em uma página Portal de serviços.

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(cadeia de caracteres URL)

Transforma um URL que solicita uma lista ou um formulário na IU da plataforma no URL da página correspondente do Portal de serviços id=list ou id=form.

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 os destinos de página id=list e id=form não são personalizáveis.

Nota:

Os valores de tabela, sys_id e sysparm_query são preservados do 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 passado 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 origem 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.