Como criar spokes usando o Spoke Generator

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Automatize as tarefas de integração criando uma sequência de ações reutilizáveis para desenvolver integrações personalizadas chamadas spokes.

    Solicitar aplicativos na Store

    Visite o ServiceNow Store site para exibir todos os aplicativos disponíveis, para obter informações sobre como enviar solicitações para a loja e para baixar e instalar o Spoke Generator (sn_spoke_builder). Para obter informações sobre notas de versão cumulativas para todos os apps lançados, consulte o ServiceNow Store histórico de versões notas de versão.

    Dependências da aplicação

    Se você estiver com problemas para instalar o app, certifique-se de que o plug-in dependente, ServiceNow IntegrationHub Professional Pack Installer (com.glide.hub.integrations.professional) esteja instalado.

    Nota:
    Alguns desses plug-ins são recursos licenciáveis e exigem licenças apropriadas, se usados fora da implementação do spoke.

    Habilidades

    Um spoke personalizado IntegrationHub fornece integração de entrada e saída com aplicações de terceiros. Essas integrações, conhecidas como spokes, são fáceis de configurar e permitem que você adicione rapidamente ações poderosas sem a necessidade de escrever um script. Este recurso requer uma assinatura IntegrationHub. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub.

    Você pode criar spokes personalizados para a aplicação de terceiros necessária importando uma especificação OpenAPI ou criando um spoke manualmente.

    Funções do usuário obrigatórias

    • Usuários com a função de administrador podem:
      • Exiba a guia Spokes.
      • Crie um novo spoke.
      • Importe uma especificação OpenAPI.
      • Criar alias de conexão.
      • Publicar ações e salvar ações como rascunhos.
      • Consulte o log de atividades do spoke.
    • Usuários com as funções action_designer e fd_read_actions podem:
      • Exiba a guia Spokes.
      • Veja as ações em um spoke.
    • Usuários com a função action_designer podem adicionar ações manualmente.
      Nota:
      Usuários com apenas a função fd_read_actions podem ver somente ações.
    • Usuários com o flow_operator ou flow_designer podem exibir fluxos e subfluxos.

    Limite de tamanho da especificação OpenAPI

    Por padrão, o sistema pode importar especificações OpenAPI de até 10 MB. Para aumentar o tamanho da importação, atualize a propriedade do sistema glide.rest.openapi.max_request_size. O valor máximo é de 100 MB.

    Limitações da especificação OpenAPI

    As ações do spoke criadas pela importação da especificação OpenAPI contêm a etapa OpenAPI. Certifique-se de estar ciente dessas limitações de etapa OpenAPI.

    Tipos de mídia do corpo da solicitação
    O corpo da solicitação é compatível somente com tipos de mídia JSON.
    Nota:
    Um objeto de saída do tipo cadeia de caracteres é criado quando o esquema OpenAPI tem additionalProperties ou nenhuma propriedade.
    Componentes do OpenAPI 3.0

    O OpenAPI 3.0 adiciona novos componentes ao Swagger 2.0 para descrever uma API com mais detalhes. O suporte a OpenAPI na etapa OpenAPI oferece suporte a alguns, mas não a todos esses componentes. A etapa OpenAPI não é compatível com esses componentes.

    • Objeto de esquema: propriedades oneOf, anyOf, additionalProperties
    • Objeto discriminador
    • Objeto de informação: campos de termos de serviço, contato e licença
    • Objeto de exemplo
    • Objeto de link
    • Objeto de retorno de chamada
    • Objeto do Esquema de Segurança
    • Objeto de requisitos de segurança
    • Objeto de marcador
    • Objeto de documentação externa
    • Objeto do Servidor
    • Extensões de especificação
    • Referências recursivas

    Mais informações sobre esses componentes estão disponíveis na documentação do OpenAPI. Consulte Especificação OpenAPI.

    Número máximo de operações compatíveis
    O número de operações de API é limitado a 500 por padrão. No entanto, usando a propriedade do sistema glide.rest.openapi.max_operation_limit, você pode configurar o número de operações de 1 a 1000.

    Versão do app

    O Spoke Generator v2.0.2 é a versão mais recente.