Criando spokes usando o Gerador de spokes

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 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 ServiceNow Store site para exibir todos os apps 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 apps 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

    AN 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 que você adicione rapidamente ações avançadas 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 Especificação OpenAPI ou Coleção do Postman , Snippets de documentação da documentação da API de terceiros , ou criar um spoke manualmente .

    Funções do usuário obrigatórias

    • Os usuários com a função de administrador podem:
      • Exibir o. Spokes .
      • 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.
    • Os usuários com as funções ACTION_DESIGNER e fd_READ_ACTIONS podem:
      • Exibir o. Spokes .
      • 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.
    • Os usuários com 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 o. 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.

    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.
    OpenAPI 3,0 componentes

    A 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: Oneof, anyOf, propriedades additionalProperties
    • Objeto discriminador
    • Objeto de informação: TermsOfService, contato, campos de 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 da 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

    Gerador de spoke v4.2. 4 é a versão mais recente.