Crie ações de spoke e crie importando uma Especificação OpenAPI

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Automatize uma integração e gere ações reutilizáveis importando uma especificação OpenAPI.

    Antes de Iniciar

    • Instale o app Gerador de spoke do ServiceNow Store.
    • Confirme isso ServiceNow IntegrationHub Professional Pack Installer (com.glide.hub.integrations.professional) está instalado e a licença é atribuída.
    • Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Workflow Studio.
    2. Clique Criar novo > Spoke.
    3. Na tela Informações do spoke, especifique se você deseja criar o spoke em um novo escopo ou em um escopo existente.
      1. Se você optar por criar o spoke em um novo escopo, selecione uma imagem como o logotipo para sua integração e preencha os campos.

        Aqui, passaremos por uma integração com o Zoom como exemplo.

        Campo Descrição
        Nome de spoke Nome para identificar o spoke personalizado.
        Descrição Descrição sobre o spoke personalizado.

        Criar spoke no novo escopo.

        Nota:

        O valor de Nome do escopo da aplicação é o formato: x_<company-code>_<spoke-name>_<spoke> . Por padrão, o <company-code> é, snc . Você pode configurar o código da empresa configurando Valor da propriedade do sistema, glide.appcreator.company.code.Configurando Valor de glide.appcreator.company.code.

        Este valor configurado é usado quando o valor Nome do escopo da aplicação gerado.Valor configurado de Nome do escopo da aplicação .

      2. Se você optar por criar o spoke em um escopo existente, selecione uma imagem como o logotipo para sua integração e preencha os campos.

        Aqui, passaremos por uma integração com a AWS como exemplo.

        Campo Descrição
        Nome da aplicação Um nome ou escopo de aplicação existente.

        Selecione uma aplicação existente.

        Nome do escopo da aplicação Nome do escopo preenchido automaticamente com base no selecionado Nome da aplicação .
        Descrição Descrição sobre o spoke personalizado.

        Crie spoke em um escopo existente.

    4. Clique em “Continuar”.

      Com base no nome e na descrição fornecidos, se houver spokes correspondentes na Store, os detalhes do spoke serão exibidos.Spokes correspondentes encontrados na Store.

      1. Clique em Exibir detalhes na Store para ver os detalhes dos spokes correspondentes.
        Os detalhes dos spokes correspondentes são exibidos em uma nova guia do navegador.
      2. Instale o spoke da Store.
        Para mais detalhes, consulte Install a ServiceNow Store application.
      3. Depois de instalar o spoke, navegue até Workflow Studio guia.
        O sistema exibe a mensagem Você instalou um spoke da Store? .
      4. Selecione uma dessas opções e clique em Continuar .
        Opção Descrição
        Sim, exiba o spoke instalado. Opção para redirecionar para Spokes painel em Integrações .
        Não, criarei um spoke personalizado. Opção para continuar com a criação do spoke.
        Não, quero sair da criação do spoke. Opção para fechar a guia atual.
    5. Clique em Ignorar se você quiser criar o spoke personalizado.
      Nota:
      As etapas a seguir também serão aplicáveis se você tiver selecionado Não, criarei spoke personalizado. opção.

      O spoke é criado e uma mensagem de confirmação é exibida.

    6. Na tela Informações de compilação, selecione o método usando o qual você deseja criar seu spoke.
      Você pode optar por criar seu spoke usando a especificação OpenAPI ou a coleção do Postman.
    7. Selecione OpenAPI Especificação e clique em Continuar Para importar uma especificação OpenAPI.
      Selecione o método pelo qual você deseja criar seu spoke.
    8. Para Origem da OpenAPI clique em Importar novo .
    9. Na tela Importar nova origem da OpenAPI, execute uma dessas duas etapas.
      1. Se você quiser importar usando um URL, selecione Importar da URL para Método de importação E especifique o URL em URL da OpenAPI .
        Importar nova origem OpenAPI.
      2. Se você quiser importar manualmente usando o código JSON ou YAML, selecione Importar de JSON ou YAML manualmente para Método de importação e forneça o código em JSON ou YAML .
        Crie spoke manualmente importando JSON ou YAML.
    10. Clique em Importar.
      A origem OpenAPI é importada.
    11. Para Alias de conexão e credencial clique em Criar novo .
    12. Na tela Criar novo alias de conexão e credencial, preencha os campos e forneça as informações do alias.
      Campo Descrição
      Nome de conexão e credencial Nome para identificar o registro de alias de conexão e credencial.
      Modelo de configuração para autenticação Mecanismo de autenticação necessário para esta integração. Certifique-se de que o mecanismo de autenticação seja compatível com a origem da OpenAPI.
      Nota:
      O modelo de configuração é preenchido automaticamente com base na especificação OpenAPI fornecida. Você pode continuar com a opção padrão ou alterá-la de acordo com seu requisito.
      Crie alias de conexão para o spoke.
    13. Clique em Crie alias e continue .
    14. Na mesma tela, preencha os campos para configurar o alias.
      Campo Descrição
      Informação de conexão
      Nome da Conexão Nome para identificar o registro de conexão.
      URL de conexão URL base para se conectar à instância ou servidor de terceiros. Este URL é preenchido automaticamente com base na especificação OpenAPI que você forneceu.
      Informações de credencial
      Com base no modelo de configuração selecionado, os campos de credencial relevantes são exibidos. Forneça os valores necessários para configurar o registro de credencial.
      Configurar registros de conexão e credencial.

      Se você quiser configurar o registro de alias mais tarde, clique em Faça isso mais tarde .

    15. Clique em Enviar.
      O registro de alias de conexão é criado.
    16. Clique em Gerar operações .
      Gere operações para o spoke.
      Todas as operações que podem ser realizadas usando a Especificação OpenAPI são listadas.
    17. Selecione as operações necessárias.

      Você pode pesquisar as ações necessárias inserindo o termo necessário na barra de pesquisa. As ações que correspondem ao termo de pesquisa especificado são exibidas.

      PESQUISE as ações necessárias.
    18. Clique em Publicar.
      Como alternativa, você também pode selecionar Salvar ações como Rascunho para salvar as ações como rascunho, modifique-as de acordo com seu requisito e publique-as posteriormente.Criar ações de spoke.
    19. Clique em Concluído: Vá para o spoke Para acessar a página Spokes e exibir o status de publicação.
      • Ações com a etapa OpenAPI são criadas. Para obter informações sobre a etapa OpenAPI, consulte OpenAPI support in the REST step.
      • Entradas e saídas de ação são mapeadas.
      • As ações são publicadas e listadas na página de detalhes do spoke em Ações > Publicado.

      Você pode começar a usar essas ações publicadas para criar fluxos e subfluxos de acordo com seu requisito.

      • Se você salvou ações como rascunho, poderá acessar essas ações de rascunho na página de detalhes do spoke em Ações > Rascunho.
      • Para exibir informações de tempo de execução sobre as atividades do spoke, clique em Log de atividades do spoke na página de detalhes do spoke. Cada vez que uma atividade do spoke é realizada, o sistema gera suas informações como um log de atividades do spoke. Clique no necessário Número para exibir o log de atividades. Cada operação no log de atividades do spoke tem um destes valores de status:
        Status Descrição
        novo Um evento para a operação é criado e esta operação será executada em breve.
        error A operação falhou ao executar.
        processando A execução da operação está em andamento.
        êxito A operação foi executada com sucesso.

      Você pode criar fluxos e subfluxos na página de detalhes do spoke e usá-los em sua integração. Para obter mais informações, consulte Como criar fluxos e Criando subfluxos.

      Junto com Log de atividades do spoke você também pode exibir detalhes dos fluxos, subfluxos e ações disponíveis na página de detalhes do spoke.