sb - escopo, global

. sb a inclusão de script fornece métodos que permitem que você execute operações no Central de controle de serviços registros de configuração.

Existem três tipos de Central de controle de serviços os registros de configuração nos quais você pode executar operações usando este script incluem:

• Sincronização de dados de base (FDS)
• Produtores de registro remoto (RRP)
• RTD (Remote Task Definition, definição de tarefa remota)

Você pode executar qualquer um dos procedimentos a seguir Central de controle de serviços operações nestes registros de configuração:

• Check-out: Cria uma versão de rascunho de um registro de configuração especificado. Qualquer versão publicada ainda está disponível para uso do cliente.
• Publicar: Publica a versão de rascunho de um registro de configuração especificado e a disponibiliza para uso do cliente.
• Arquivar: Arquiva uma versão inativa de um registro de configuração especificado e a torna indisponível para os clientes.
• Descontinuar: Desativa todas as versões de um registro de configuração especificado e as torna indisponíveis para os clientes.
• Atualizar campo virtual: Preenche os campos virtuais em uma tabela de tarefas em uma instância de destino ao usar Central de controle de serviços tarefas remotas.

Para obter informações adicionais sobre Central de controle de serviços registros de configuração, consulte Create configuration revisions.

Para acessar esta API, o Central de controle de serviços Para a aplicação de provedores (sn_sb_pro) e Central de controle de serviços Os plug-ins de base (sn_sb) devem ser instalados em sua instância.

Você chama os métodos nesta API usando sb inclusão de script. No entanto, o código desses métodos reside no PSBPublicAPIUtil inclusão de script.

Ao chamar esses métodos do escopo global, use a seguinte sintaxe:

sb.checkout(glideRecord);
sb.publish(glideRecord);
sb.archive(glideRecord);
sb.retire(glideRecord);

Ao chamá-los de uma aplicação com escopo, use esta sintaxe:

global.sb.checkout(glideRecord);
global.sb.publish(glideRecord);
global.sb.archive(glideRecord);
global.sb.retire(glideRecord);

sb - archive (glideRecord)

Valida se o GlideRecord especificado é válido Central de controle de serviços registro de configuração e verifica se o registro está no estado "inativo". Se esta validação for aprovada, arquiva o registro de configuração especificado, deixando todas as outras versões do mesmo registro de configuração inalteradas.

Para obter informações adicionais sobre revisões de configuração e seus estados associados, consulte Create configuration revisions.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
GlideRecord	GlideRecord	Registro de configuração a ser arquivado. Este registro pode ser um dos seguintes: Sincronização de dados de base (FDS): Registros localizados na tabela Oferta do provedor de dados de base [sn_fds_pro_offering]. Produtores de registro remoto (RRP): Registros localizados na tabela Produtor de registro remoto [sn_sb_pro_remote_record_producer]. Definição de tarefa remota (RTD): Registros localizados na tabela Definição de tarefa remota [sn_sb_pro_remote_task_def].

Tabela 2. Retornos

Tipo	Descrição
Booliano	Sinalizador que indica se o registro de configuração foi arquivado. Valores possíveis: Verdadeiro: O registro de configuração foi arquivado. Falso: Ocorreu um erro; o registro de configuração não foi arquivado.

O exemplo de código a seguir mostra como chamar esse método do escopo global em um registro de configuração FDS.

var grConfig = new GlideRecord('sn_fds_pro_offering’’'); // Configuration table that contains the desired record 
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to publish
var isExecuted = sb.archive(grConfig);

sb - check-out (glideRecord)

Valida se o GlideRecord especificado é válido Central de controle de serviços registro de configuração e verifica se o registro está no estado "publicado". Se esta validação for aprovada, criará uma nova versão do registro de configuração especificado e definirá o campo de estado como "rascunho".

Tabela 3. Parâmetros

Nome	Tipo	Descrição
GlideRecord	GlideRecord	Registro de configuração para check-out. Este registro pode ser um dos seguintes: Sincronização de dados de base (FDS): Registros localizados na tabela Oferta do provedor de dados de base [sn_fds_pro_offering]. Produtores de registro remoto (RRP): Registros localizados na tabela Produtor de registro remoto [sn_sb_pro_remote_record_producer]. Definição de tarefa remota (RTD): Registros localizados na tabela Definição de tarefa remota [sn_sb_pro_remote_task_def].

Tabela 4. Retornos

Tipo	Descrição
GlideRecord	Se for bem-sucedido, retornará o registro de configuração recém-criado com o campo de estado definido como "rascunho". Se ocorrer um erro, retornará nulo.

O exemplo de código a seguir mostra como chamar esse método do escopo global em um registro de configuração RTD.

var grConfig = new GlideRecord('sn_sb_pro_remote_task_def'); // Configuration table that contains the desired record 
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to checkout
var checkoutGr = sb.checkout(grConfig);

sb - publicar (glideRecord)

Valida se o GlideRecord especificado é válido Central de controle de serviços registro de configuração e verifica se o registro está no estado "rascunho". Se esta validação for aprovada, publica a versão de rascunho do registro de configuração.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
GlideRecord	GlideRecord	Registro de configuração a ser publicado. Este registro pode ser um dos seguintes: Sincronização de dados de base (FDS): Registros localizados na tabela Oferta do provedor de dados de base [sn_fds_pro_offering]. Produtores de registro remoto (RRP): Registros localizados na tabela Produtor de registro remoto [sn_sb_pro_remote_record_producer]. Definição de tarefa remota (RTD): Registros localizados na tabela Definição de tarefa remota [sn_sb_pro_remote_task_def].

Tabela 6. Retornos

Tipo	Descrição
Booliano	Sinalizador que indica se o registro de configuração foi publicado. Valores possíveis: Verdadeiro: O registro de configuração foi publicado. Falso: Ocorreu um erro; o registro de configuração não foi publicado.

O exemplo de código a seguir mostra como chamar esse método do escopo global em um registro de configuração de RRP.

var grConfig = new GlideRecord('sn_sb_pro_remote_record_producer’'); // Configuration table that contains the desired record 
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to publish
var isExecuted = sb.publish(grConfig);

sb - Descontinuar(glideRecord)

Valida se o GlideRecord especificado é válido Central de controle de serviços registro de configuração e verifica se o registro está em um estado válido. Se esta validação for aprovada, a versão especificada do registro de configuração será cancelada junto com todas as outras revisões desse mesmo registro de configuração.

Para obter informações adicionais sobre revisões de configuração e seus estados associados, consulte Create configuration revisions.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
GlideRecord	GlideRecord	Registro de configuração a ser descontinuado. Este registro pode ser um dos seguintes: Sincronização de dados de base (FDS): Registros localizados na tabela Oferta do provedor de dados de base [sn_fds_pro_offering]. Produtores de registro remoto (RRP): Registros localizados na tabela Produtor de registro remoto [sn_sb_pro_remote_record_producer]. Definição de tarefa remota (RTD): Registros localizados na tabela Definição de tarefa remota [sn_sb_pro_remote_task_def].

Tabela 8. Retornos

Tipo	Descrição
Booliano	Sinalizador que indica se o registro de configuração foi descontinuado. Valores possíveis: Verdadeiro: O registro de configuração foi descontinuado. Falso: Ocorreu um erro; o registro de configuração não foi descontinuado.

O exemplo de código a seguir mostra como chamar esse método do escopo global em um registro de configuração RTD.

var grConfig = new GlideRecord('sn_sb_pro_remote_task_def'); // Configuration table that contains the desired record 
grConfig.get('0ed11101ff6aca10c1befe258c4fd99e'); // Sys_id of the configuration record to checkout
var isExecuted = sb.retire(grConfig);

UpdateVirtualField(GlideRecord remoteTaskGr, cadeia de caracteres virtualField, cadeia de caracteres virtualValue, cadeia de caracteres virtualDisplayValue)

Preenche campos virtuais em uma tabela de tarefas em uma instância de destino ao usar Central de controle de serviços tarefas remotas.

Um campo virtual é um campo que existe em uma tabela de tarefas de destino, mas não existe na tabela de tarefas de origem. Você usa este método para passar os valores de um campo virtual da instância de origem para a instância de destino. Este método armazena os valores especificados para o campo virtual como JSON na seção de formulário do especificado tarefa remota . Esta tarefa remota é sincronizada com a instância de destino em que os valores são armazenados no campo mapeado na tabela de tarefas de destino.

Os campos virtuais são definidos nas definições de tarefa remota. As definições de tarefa remota contêm tabelas de mapeamento de entrada e saída que mapeiam campos entre tabelas de tarefas nas instâncias de origem e de destino. Quando uma tabela de origem não contém um campo que existe em uma tabela de destino, o campo é configurado na definição de tarefa remota como um campo virtual. O consumidor pode usar qualquer um deles Central de controle de serviços transforma ou este método para atualizar os valores desses campos virtuais no registro de tarefa de destino associado.

A seção a seguir descreve um exemplo de caso de uso sobre como implementar campos virtuais e usar o. UpdateVirtualField() método para preencher valores no campo virtual. Neste exemplo, as duas tabelas de tarefa que são vinculadas por uma definição de tarefa remota são a tabela de caso do provedor e a tabela Incidente do consumidor. Quando um registro de incidente é criado ou atualizado na instância do consumidor, ele é configurado para sincronizar com a tabela de casos do provedor. O campo Instâncias afetadas na tabela Caso é um campo obrigatório, mas não existe na tabela Incidente. Para lidar com essa situação, o campo Instâncias afetadas deve ser definido como um campo virtual no mapeamento de entrada da definição de tarefa remota associada.

1. O provedor cria uma definição de tarefa remota para a tabela de casos do provedor e a tabela Incidente do consumidor.
2. Em Campos de entrada no Links relacionados Da definição de tarefa remota, o provedor mapeia os campos entre a tabela Incidente e a tabela Caso.
   Ao definir o campo Instâncias afetadas, o provedor seleciona Virtual e, em seguida, seleciona Instâncias afetadas em Campo de destino em Mapeamento de destino guia.

   Nota:

   Ao definir um campo virtual, nenhum campo de origem é definido, pois não existe.
3. Em seguida, o provedor publica a definição da tarefa remota, que é sincronizada com a instância do consumidor.
4. O consumidor cria uma tarefa remota para a tabela Incidente. Uma carga JSON que contém todos os valores dos campos mapeados, incluindo as informações sobre campos virtuais, é incluída em uma seção de formulário na tarefa remota.
5. A instância do consumidor chama o. UpdateVirtualField() Método, como em uma regra de negócios que é executada quando os registros na tabela Incidente são atualizados, para definir os valores do campo Instâncias afetadas na tarefa remota.
   Nota:

   Embora você possa preencher dados na tabela de destino a qualquer momento, os campos obrigatórios configurados como campos virtuais devem ser preenchidos na tarefa remota antes que a tarefa remota seja enviada para a instância do produtor.
6. A tarefa remota é sincronizada com a instância do provedor e cria um registro de caso na instância do provedor.

Para obter informações sobre como criar uma definição de tarefa remota, consulte Create a remote task definition in Service Exchange for Providers.

Para obter informações sobre como criar um Central de controle de serviços transformação, consulte Transform data with the Service Exchange transform framework.

Aviso:

Você só deve chamar este método em uma regra de negócio anterior, pois ele atualiza a tarefa remota em que ele é chamado. Se você chamar este método em uma regra de pós-negócio, deverá incluir condições estritas que impedem que a atualização do campo virtual na tarefa remota acione a regra de negócio, pois isso pode causar um loop infinito.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
TaskGr remoto	GlideRecord	Objeto GlideRecord da tarefa remota para a qual definir os valores de campo virtual especificados.
VirtualField	Cadeia de caracteres	Nome do campo do campo virtual para o qual as informações associadas serão atualizadas. Definido em Campos de saída guia relacionada da definição de tarefa remota associada.
VirtualValue	Cadeia de caracteres	Valor a ser definido para este campo na instância de destino.
VirtualDisplayValue	Cadeia de caracteres	Valor de exibição a ser definido para este campo na instância de destino

Tabela 10. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como chamar este método.

var remoteTaskGr = new GlideRecord("");
/** Remote Task table name,
** Table name vary based on which instance the script is being executed.
**/

remoteTaskGr.get(""); // Remote Task record sys_id

global.sb.updateVirtualField(remoteTaskGr,"<virtual outbound field name>", "<value to set on target field>", "<display value to set on target field>");