Como criar spokes usando o Spoke Generator
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 Spoke Generator (sn_spoke_builder). Para obter informações sobre notas de versão cumulativas 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 com problemas para instalar o aplicativo, certifique-se de que o plug-in dependente ServiceNow IntegrationHub Professional Pack Installer (com.glide.hub.integrations.professional) esteja instalado.
Capacidades
Um Integration Hub 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 poderosas sem a necessidade de escrever um script. Este recurso requer uma assinatura Integration Hub. 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 uma especificação OpenAPI ou uma coleção do Postman, snippets de documentação da API de terceirosou 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 de 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 só podem ver 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 de 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 é 100 MB.
Limitações da especificação OpenAPI
As ações de spoke criadas pela importação da especificação OpenAPI contêm a etapa OpenAPI. Certifique-se de estar ciente dessas limitações de etapa da 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
A 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. No momento, a etapa OpenAPI não é compatível com esses componentes.
- Objeto de esquema: propriedades oneOf, anyOf, additionalProperties
- Objeto discriminador
- Objeto de informação: termosDeServiço, 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
- Marcar objeto
- 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 Gerador de spoke v4.0.3 é a versão mais recente.