TroubleTicketNotificationUtilOOB - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

    • . TroubleTicketNotificationUtilOOB A inclusão de script fornece métodos usados para definir e gerar cargas úteis compatíveis com TMF para eventos de notificação de tíquete de problemas.

    Substitua os métodos nesta inclusão de script para:
    • Adicionar/remover atributos a um tipo de evento de tíquete de problema existente.
    • Defina atributos para um novo tipo de evento de tíquete de problema.
    Para obter informações adicionais, confira Configure notificações de tíquete de problemas usando a Estrutura de notificação de evento do produtor.

    Esta inclusão de script é executada em sn_ind_tsm_sdwan namespace.

    O usuário chamador deve ter a função ticket_integrator.

    TroubleTicketNotificationUtilOOB - addAdditionalEventAttributes(Object tmfEventPayload)

    Adiciona atributos de cabeçalho de evento personalizados à carga útil do evento de tíquete de problema do TMF aprovada. Os atributos adicionados por este método são adicionados ao cabeçalho no nível do evento para todos os eventos de tíquete de problemas.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    TmfEventPayload Objeto Carga de evento de tíquete de problema compatível com TMF. Para obter detalhes sobre o formato desta carga de evento, consulte TMF621 Trouble tíquete Management API REST Specification v5.0.0 e o. TMF688 Event Management API v4.0.0 .
    Tabela 2. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo de código a seguir mostra como chamar este método.

    constructTMFEvent: function(eventId) {
  var troubleTicketEvent = {};
  if (gs.nil(eventId)) {
    troubleTicketEvent.eventId = gs.generateGUID();
  } else {
    troubleTicketEvent.eventId = eventId;
  }
  troubleTicketEvent['@type'] = Constants.EVENT_TYPE_TROUBLE_TICKET;
  this.addAdditionalEventAttributes(troubleTicketEvent);
  return troubleTicketEvent;
},

    TroubleTicketNotificationUtilOOB - constructTMFEvent(cadeia de caracteres eventID)

    Gera os atributos de cabeçalho compatíveis com TMF688 na seção Evento da carga. Esses atributos são consistentes em todas as cargas de evento.

    Na implementação padrão, este método adiciona o. eventIde o. @typeatributos de cabeçalho.

    Este método chama o método auxiliar AddAtributos de eventos adicionais() . Neste método, você pode adicionar outros atributos de cabeçalho à carga útil do evento. Para obter detalhes, consulte Modifique uma carga de evento de tíquete de problemas.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    eventId Cadeia de caracteres Identificador exclusivo do evento associado. Qualquer valor exclusivo. Na implementação padrão, se você não passar o ID do evento, o valor será definido como um GUID gerado pelo sistema.
    Tabela 4. Retornos
    Tipo Descrição
    Objeto Carga de TMF com os atributos de nível de evento definidos. Para obter detalhes sobre o formato desta carga de evento, consulte TMF688 Event Management API v4.0.0 .

    O exemplo de código a seguir mostra como chamar esse método para construir os atributos de cabeçalho de evento ao gerar uma carga de mudança de atributo de tíquete de problemas.

    generateTroubleTicketAttributeChangePayload: function(incidentGr, eventType, eventId) {
  var tmfEventPayload = this.constructTMFEvent(eventId);
  tmfEventPayload.eventType = eventType;
  tmfEventPayload.event = this.addAttributeChangeTroubleTicketAttributes(incidentGr);

  return tmfEventPayload;
},

    TroubleTicketNotificationUtilOOB - generateCreateTroubleTicketEventPaylaod(Object incidentGr, cadeia de caracteres eventType, cadeia de caracteres eventID)

    Constrói a carga compatível com TMF para o tipo de evento de incidente Criar tíquete de problema associado.

    Este método é executado quando o tipo de evento associado é TROUBLE_TICKET_CREATE: "TROUBLETICKETCREATEEVENT" . Este método chama dois métodos auxiliares:
    • ConstructTMFEvent() Adiciona os atributos do cabeçalho do evento (TMF688) à carga.
    • AddCreateTroubleTicketAttributes() : Substitua este método para adicionar atributos de tíquete de problema (TMF621), obrigatórios e opcionais, à carga. Este método é apenas um stub na implementação padrão.

    Você pode substituir esses métodos de ajuda no TroubleTicketNotificationUtil Inclusão de script para configurar o cabeçalho do evento e os atributos do tíquete de problemas na carga compatível com TMF.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    incidentGr Objeto Registro do Glide formatado JSON que causou a geração do evento de tíquete de problemas. Use as informações neste registro do Glide para criar a carga útil do evento de tíquete de problemas compatível com TMF621.
    eventType Cadeia de caracteres
    Identificador exclusivo do tipo de evento de tíquete de problema associado. Para a implementação padrão deste método, isso sempre deve ser
    "TroubleTicketCreateEvent" .

    Para obter uma lista de todos os tipos de evento de tíquete de problema de base, consulte Constants.EVENT_TYPES em sn_api_notif_mgmt.Constants arquivo de inclusão de script.
    eventId Cadeia de caracteres Identificador exclusivo do evento associado.
    Tabela 6. Retornos
    Tipo Descrição
    Objeto Carga de evento de tíquete de problema compatível com TMF. Para obter detalhes sobre o formato desta carga de evento, consulte TMF621 Trouble tíquete Management API REST Specification v5.0.0 e o. TMF688 Event Management API v4.0.0 .

    O exemplo de código a seguir mostra como chamar este método.

    fetchEventHandlerAndCreateTMFEvent: function(eventSnapshot, eventType, eventId) {
  var eventPayload;
  switch (eventType) {
    case Constants.EVENT_TYPES.TROUBLE_TICKET_STATUS_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketStatusChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaod(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_ATTRIBUTE_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketAttributeChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE_FOR_CASE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaodForCase(eventSnapshot, eventType, eventId);
      break;

    default:
      this._logger.debug("Event with id " + eventId + " could not find the matching payload generator");
      eventPayload = null;
  }
return eventPayload;
},

    TroubleTicketNotificationUtilOOB - generateCreateTroubleTicketEventPaylaodForCase(Object incidentGr, cadeia de caracteres eventType, cadeia de caracteres eventID)

    Constrói a carga compatível com TMF para o tíquete de problema de criação associado para o tipo de evento de caso.

    Este método é executado quando o tipo de evento associado é TROUBLE_TICKET_CREATE_FOR_CASE: "TROUBLETICKETCREATEEVENTFORCASE" . Este método chama dois métodos auxiliares:
    • ConstructTMFEvent() Adiciona os atributos de evento (TMF688) à carga.
    • AddCreateTroubleTicketAttributesForCase() : Substitua este método para adicionar atributos de tíquete de problema (TMF621), obrigatórios e opcionais, à carga. Este método é apenas um stub na implementação padrão.

    Você pode substituir esses métodos de ajuda no TroubleTicketNotificationUtil Inclusão de script para configurar o cabeçalho do evento e os atributos do tíquete de problemas na carga compatível com TMF.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    incidentGr Objeto Registro do Glide formatado JSON que causou a geração do evento de tíquete de problemas. Use as informações neste registro do Glide para criar a carga útil do evento de tíquete de problemas compatível com TMF621.
    eventType Cadeia de caracteres
    Identificador exclusivo do tipo de evento de tíquete de problema associado. Para a implementação padrão deste método, isso sempre deve ser
    "TroubleTicketCreateEvent" .

    Para obter uma lista de todos os tipos de evento de tíquete de problema de base, consulte Constants.EVENT_TYPES em sn_api_notif_mgmt.Constants arquivo de inclusão de script.
    eventId Cadeia de caracteres Identificador exclusivo do evento associado.
    Tabela 8. Retornos
    Tipo Descrição
    Objeto Carga de evento de tíquete de problema compatível com TMF. Para obter detalhes sobre o formato desta carga de evento, consulte TMF621 Trouble tíquete Management API REST Specification v5.0.0 e o. TMF688 Event Management API v4.0.0 .

    O exemplo de código a seguir mostra como chamar este método.

    fetchEventHandlerAndCreateTMFEvent: function(eventSnapshot, eventType, eventId) {
  var eventPayload;
  switch (eventType) {
    case Constants.EVENT_TYPES.TROUBLE_TICKET_STATUS_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketStatusChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaod(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_ATTRIBUTE_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketAttributeChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE_FOR_CASE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaodForCase(eventSnapshot, eventType, eventId);
      break;

    default:
      this._logger.debug("Event with id " + eventId + " could not find the matching payload generator");
      eventPayload = null;
  }
return eventPayload;
},

    TroubleTicketNotificationUtilOOB - generateTroubleTicketAttributeChangePayload(Object incidentGr, cadeia de caracteres eventType, cadeia de caracteres eventID)

    Constrói a carga compatível com TMF para o evento de mudança de atributo de tíquete de problema para o tipo de evento de incidente.

    Este método é executado quando o tipo de evento associado é TROUBLE_TICKET_ATTRIBUTE_CHANGE: "TROUBLETICKETATTRIBUTECHANGE" . Este método chama dois métodos auxiliares:
    • ConstructTMFEvent() Adiciona os atributos de evento (TMF688) à carga.
    • AddAttributeChangeTroubleTicketAttributes() : Substitua este método para adicionar atributos de tíquete de problema (TMF621), obrigatórios e opcionais, à carga. Este método é apenas um stub na implementação padrão.

    Você pode substituir esses métodos de ajuda no TroubleTicketNotificationUtil Inclusão de script para configurar o cabeçalho do evento e os atributos do tíquete de problemas na carga compatível com TMF.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    incidentGr Objeto Registro do Glide formatado JSON que causou a geração do evento de tíquete de problemas. Use as informações neste registro do Glide para criar a carga útil do evento de tíquete de problemas compatível com TMF621.
    eventType Cadeia de caracteres
    Identificador exclusivo do tipo de evento de tíquete de problema associado. Para a implementação padrão deste método, isso sempre deve ser
    "TroubleTicketCreateEvent" .

    Para obter uma lista de todos os tipos de evento de tíquete de problema de base, consulte Constants.EVENT_TYPES em sn_api_notif_mgmt.Constants arquivo de inclusão de script.
    eventId Cadeia de caracteres Identificador exclusivo do evento associado.
    Tabela 10. Retornos
    Tipo Descrição
    Objeto Carga de evento de tíquete de problema compatível com TMF. Para obter detalhes sobre o formato desta carga de evento, consulte TMF621 Trouble tíquete Management API REST Specification v5.0.0 e o. TMF688 Event Management API v4.0.0 .

    O exemplo de código a seguir mostra como chamar este método.

    fetchEventHandlerAndCreateTMFEvent: function(eventSnapshot, eventType, eventId) {
  var eventPayload;
  switch (eventType) {
    case Constants.EVENT_TYPES.TROUBLE_TICKET_STATUS_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketStatusChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaod(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_ATTRIBUTE_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketAttributeChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE_FOR_CASE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaodForCase(eventSnapshot, eventType, eventId);
      break;

    default:
      this._logger.debug("Event with id " + eventId + " could not find the matching payload generator");
      eventPayload = null;
  }
return eventPayload;
},

    TroubleTicketNotificationUtilOOB - generateTroubleTicketStatusChangePayload(Object incidentGr, cadeia de caracteres eventType, cadeia de caracteres eventID)

    Constrói a carga compatível com TMF para o evento de mudança de status do tíquete de problema associado para o tipo de evento de incidente.

    Este método é executado quando o tipo de evento associado é TROUBLE_TICKET_STATUS_CHANGE: "TROUBLETICKETSTATUSCHANGEEVENT" . Este método chama dois métodos auxiliares:
    • ConstructTMFEvent() Adiciona os atributos de evento (TMF688) à carga.
    • AddStatusChangeTroubleTicketAttributes() : Substitua este método para adicionar atributos de tíquete de problema (TMF621), obrigatórios e opcionais, à carga. Este método é apenas um stub na implementação padrão.

    Você pode substituir esses métodos de ajuda no TroubleTicketNotificationUtil Inclusão de script para configurar o cabeçalho do evento e os atributos do tíquete de problemas na carga compatível com TMF.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    incidentGr Objeto Registro do Glide formatado JSON que causou a geração do evento de tíquete de problemas. Use as informações neste registro do Glide para criar a carga útil do evento de tíquete de problemas compatível com TMF621.
    eventType Cadeia de caracteres
    Identificador exclusivo do tipo de evento de tíquete de problema associado. Para a implementação padrão deste método, isso sempre deve ser
    "TroubleTicketCreateEvent" .

    Para obter uma lista de todos os tipos de evento de tíquete de problema de base, consulte Constants.EVENT_TYPES em sn_api_notif_mgmt.Constants arquivo de inclusão de script.
    eventId Cadeia de caracteres Identificador exclusivo do evento associado.
    Tabela 12. Retornos
    Tipo Descrição
    Objeto Carga de evento de tíquete de problema compatível com TMF. Para obter detalhes sobre o formato desta carga de evento, consulte TMF621 Trouble tíquete Management API REST Specification v5.0.0 e o. TMF688 Event Management API v4.0.0 .

    O exemplo de código a seguir mostra como chamar este método.

    fetchEventHandlerAndCreateTMFEvent: function(eventSnapshot, eventType, eventId) {
  var eventPayload;
  switch (eventType) {
    case Constants.EVENT_TYPES.TROUBLE_TICKET_STATUS_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketStatusChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaod(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_ATTRIBUTE_CHANGE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateTroubleTicketAttributeChangePayload(eventSnapshot, eventType, eventId);
      break;

    case Constants.EVENT_TYPES.TROUBLE_TICKET_CREATE_FOR_CASE:
      eventPayload = new sn_ind_tsm_sdwan.TroubleTicketNotificationUtil().generateCreateTroubleTicketEventPaylaodForCase(eventSnapshot, eventType, eventId);
      break;

    default:
      this._logger.debug("Event with id " + eventId + " could not find the matching payload generator");
      eventPayload = null;
  }
return eventPayload;
},