Criando spokes usando o Gerador de spokes

  • Versão de lançamento: Zurich
  • Atualizado 2 de set. de 2025
  • 2 min. de leitura

    • Automatize 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 ServiceNow Store site para exibir todos os aplicativos disponíveis, obter informações sobre como enviar solicitações para a loja e baixar e instalar Gerador de spoke (sn_spoke_builder) . Para obter informações cumulativas de notas de versão para todos os aplicativos lançados, consulte ServiceNow Store notas da versão do histórico de versões.

    Dependências da aplicação

    Se você estiver tendo problemas para instalar o app, certifique-se de que o plug-in dependente ServiceNow IntegrationHub Starter Pack Installer (com.glide.hub.integrations.starter) esteja instalado. Você precisa da licença do ServiceNow IntegrationHub Professional Pack Installer em seus ambientes de produção e subprodução para criar spokes usando Abrir Especificação de API, coleção do Postman , Ou Now Assist.

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

    Capacidades

    Um IntegrationHub o spoke personalizado 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 adicionar rapidamente ações poderosas sem a necessidade de escrever um script. Este recurso requer um IntegrationHub assinatura. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

    Você pode criar spokes personalizados para a aplicação de terceiros necessária importando um OpenAPI Especificação ou Coleção do Postman , Fragmentos de documentação da documentação de API de terceiros ou criando um spoke manualmente .

    Funções do usuário obrigatórias

    • Usuários com a função de administrador podem:
      • Exiba Spokes guia.
      • Crie um novo spoke.
      • Importe uma especificação OpenAPI.
      • Criar alias de conexão.
      • Publique ações e salve 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 Spokes guia.
      • Consulte Ações em um spoke.
    • Usuários com a função action_designer podem adicionar ações .
      Nota:
      Usuários com apenas a função fd_read_actions só podem ver ações.
    • Usuários com flow_operator ou flow_designer podem exibir fluxos e subfluxos.

    Limite de tamanho de especificação do OpenAPI

    Por padrão, o sistema pode importar Especificações OpenAPI de até 10 MB. Para aumentar o tamanho da importação, atualize glide.rest.openapi.max_request_sizepropriedade do sistema. O valor máximo é 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 da etapa OpenAPI.

    Solicitar tipos de mídia do corpo
    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

    OpenAPI 3,0 adiciona novos componentes ao Swagger 2,0 para descrever uma API em mais detalhes. O suporte à OpenAPI na etapa OpenAPI oferece suporte a alguns, mas não a todos esses componentes. No momento, a etapa OpenAPI não oferece suporte a esses componentes.

    • Objeto de esquema: Propriedades oneof, anyOf, additionalProperties
    • Objeto discriminador
    • Objeto de informações: TermsOfService, contato, campos de licença
    • Objeto de exemplo
    • Vincular objeto
    • Objeto de retorno de chamada
    • Objeto do esquema de segurança
    • Objeto de requisitos de segurança
    • Objeto de marcador
    • Objeto de documentação externo
    • 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 OpenAPI Especificação .

    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 v4.2.0 é a versão mais recente.