Criação de uma inclusão de script de integração para aplicações de operadora de terceiros

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura

    • Para se integrar a uma instância ServiceNow, uma aplicação de transportadora de terceiros deve ter uma inclusão de script que estenda o script ITAMshipmentIntegration da classe base em sua instância ServiceNow para receber o número de acompanhamento da remessa da instância ServiceNow do cliente e responder com a transportadora Detalhes relacionados a.

    Considere o seguinte ao criar a inclusão de script:
    • Certifique-se de que a inclusão de script seja acessível no escopo da aplicação comum Gestão de ativos ajustando as seguintes configurações no registro de recurso da aplicação:
      • Defina o campo Acessível de como Todos os escopos da aplicação.
      • Defina o campo Acesso do chamador como Nenhum para garantir que o acesso do chamador não seja restrito.
    • O código para se comunicar com a instância ServiceNow do cliente com base no número de acompanhamento deve ser incluído na função fetchSipmentInfo.
    • Quando a API é invocada no modo de teste para validar a conexão com a instância ServiceNow do cliente, a resposta de retorno do método fetchSipmentInfo deve ser um objeto JSON com o código de resposta HTTP e a mensagem de resposta, da seguinte forma:
      {
httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’
}
    • Quando não estiver no modo de teste, consulte as remessas e invoque o método processResponse com o seguinte formato de resposta:
      [
{
trackingNumber: ‘’,
deliveryDate: ‘’,
pickupDate: ‘’,
packageStatus: ‘’.
statusDetail: ‘’,
trackingURL: ‘’,
parcelWeight: ‘’,
deliveryServicesCost: ‘’,
currency: ‘’
}
	]

    Estrutura da inclusão de script ITAMshipmentIntegration

    Inclusão de script de integração de remessa ITAM

    Função fetchShipmentInfo

    A função fetchSipmentInfo recebe os números de rastreamento da instância ServiceNow do cliente e invoca a API da transportadora para buscar os detalhes da remessa de todos os números de rastreamento. Nesta função, você deve definir a lógica de negócios que permite que seus clientes se comuniquem com as APIs da operadora com base nos números de acompanhamento. Esta função processa a resposta recebida da API da transportadora e invoca a função de pós-processamento.

    Função processResponse

    Nota:
    A aplicação Gestão de ativos de TI define a lógica de negócios nesta função e não deve ser alterada.
    A função processResponse recebe a resposta da API da transportadora e atualiza os registros de remessa com os seguintes detalhes relacionados à transportadora:
    • Link da transportadora
    • Status da transportadora
    • Detalhe do status da transportadora
    • Data de coleta da transportadora
    • Data de entrega da transportadora
    • Moeda
    • Custo dos serviços de entrega
    • Peso do pacote