Executar guias de pedido automaticamente
Os guias de pedido do catálogo de serviços permitem que os clientes façam uma única solicitação do catálogo de serviços que pode gerar vários itens solicitados. Os administradores podem configurar guias de pedido para serem executados automaticamente, a partir de um fluxo de trabalho ou de um script para gerar um conjunto de itens solicitados sem enviar manualmente uma solicitação do catálogo de serviços. Os administradores também podem revisar e reprocessar as falhas do guia de pedido.
Como caso de uso, um fluxo de trabalho de integração para um novo funcionário pode executar um guia de pedido para solicitar itens automaticamente para esse funcionário.
Executando guias de pedido a partir de scripts
Executar guias de pedido com um script do lado do servidor é mais complexo do que usar fluxos de trabalho, mas permite mais flexibilidade e pode ser usado em situações que não sejam de fluxo de trabalho.
Use SNC.ScriptableOrderGuide Classe Java para executar guias de pedido com um script.
Use ScriptableOrderGuide(String orderGuideId) Construtor para criar um novo objeto ScriptableOrderGuide.
Resumo do método
| Método | Retornar Valor | Descrição |
|---|---|---|
| Processo (cadeia de caracteres json) | booliano | Executa o guia de pedido usando o parâmetro de cadeia de caracteres codificado JSON como entrada para o guia de pedido. Retorna verdadeiro ou falso se o processamento foi bem-sucedido ou não. Nota:
Ambos opened_bye. requested_foros parâmetros devem ser passados para o guia de pedido e ambos devem ter valores sys_id de registro de usuário válidos. Se o processamento for bem-sucedido e uma solicitação for criada pelo guia de pedido, você poderá recuperar a solicitação GlideRecord usando GetRequest() . Se o processamento falhar, você poderá recuperar o GlideRecord de falha usando GetFailure() e envie o script para reprocessamento usando reprocessar. |
| Reprocessar (Falha GlideRecord) | booliano | Executa o guia de pedido novamente usando o parâmetro de cadeia de caracteres codificado JSON armazenado no GlideRecord de falha. |
| GetMessage() | Cadeia de caracteres | Recupera a mensagem preenchida após o processamento ou reprocessamento. |
| GetRequest() | GlideRecord | Recupera a solicitação GlideRecord. |
| GetFailure() | GlideRecord | Recupera o GlideRecord de falha da tabela Falhas do Guia de pedido programável [sc_script_order_guide_failure]. |
Exemplo de script
// Creating the object to later be JSON encoded
var json = {"opened_by":"62826bf03710200044e0bfc8bcbe5df1","requested_for":"06826bf03710200044e0bfc8bcbe5d8a","department":"221f3db5c6112284009f4becd3039cc9"};
var now_GR = new GlideRecord("sc_cat_item_guide");
if (gr.get("name","IT Onboarding SOG")) {
var sog = new SNC.ScriptableOrderGuide(gr.getValue("sys_id"));
var result = sog.process(new JSON().encode(json));
if(!result)
gs.log("Processing the scriptable order guide failed with message: " + sog.getMessage());
else {
var request = sog.getRequest();
gs.log("Request created - " + request.sys_id); } }Executando guias de pedido de fluxos de trabalho
Executar um guia de pedido a partir de um fluxo de trabalho será adequado se você incluir guias de pedido como parte de um processo mais amplo baseado em fluxo de trabalho.
| Campo | Descrição |
|---|---|
| Guia de pedido | O nome do guia de pedido que esta atividade processa. Por exemplo, TI DE integração DE funcionário de exemplo . |
| Script | Um script passando informações para o guia de pedido. Essas informações são enviadas como um parâmetro de cadeia de caracteres codificado JSON atribuído ao resposta variável. O script deve atender a estes requisitos:
|
Resultados
- Sucesso : a atividade processou o guia de pedido com sucesso. Isso não significa que uma solicitação foi criada. Se uma solicitação foi criada, o sys_id da solicitação será adicionado ao bloco de anotações do fluxo de trabalho em sc_request variável.
- Falha : ao processar o guia de pedido, ocorreu uma falha, criando um registro de falha. Se o processamento falhar, você poderá exibir e editar o registro de falha.
Exemplo de fluxo de trabalho
. Fluxo de trabalho DE TI DE integração do funcionário O fluxo de trabalho usa este exemplo para gerar itens do catálogo DE TI para um novo funcionário como parte de um processo de integração.
- Pegue uma cadeia de caracteres JSON gerada anteriormente a partir do registro de mudança de RH.
- Anexe o obrigatório opened_bye. requested_forparâmetros para essa cadeia de caracteres.
- Envie a nova cadeia de caracteres para processamento pelo guia de pedido.
var parameters = new JSON().decode(current.payload);
// Need to amend the json object to include additional values.
parameters.opened_by = current.opened_by + "";
parameters.requested_for = current.opened_for + "";
answer = new JSON().encode(parameters);Exibir falhas do guia de pedido
O processamento do guia de pedido pode falhar, por exemplo, se o guia de pedido que está sendo executado não existir. Quando ocorre uma falha durante o processamento do guia de pedidos, o. Falhas do Guia de pedido programável o submódulo permite revisar e reprocessar as falhas. Um registro é criado para cada falha e, depois de corrigir os erros que causaram a falha inicial, você pode reprocessar os guias de pedido com falha.
Por Que e Quando Desempenhar Esta Tarefa
Se ocorrer uma falha, um registro de falha será criado na tabela Falhas do Guia de pedido programável [sc_script_order_guide_failure].
Para exibir detalhes de uma falha, navegue até e abra um registro de falha.
Falhas de reprocessamento: Se você corrigiu o erro que causou a falha inicial, poderá reprocessar guias de pedido com falha.