Criar spoke e criar ações importando uma coleção do Postman
Automatize uma integração e gere ações reutilizáveis importando uma coleção do Postman.
Antes de Iniciar
Função necessária: administrador
Procedimento
- Navegar até Todos > Automação de Processo > Workflow Studio.
- Clicar Criar novo > Spoke.
-
Na tela Informações do spoke, especifique se deseja criar o spoke em um novo escopo ou em um escopo existente.
-
Se você optar por criar o spoke em um novo escopo, selecione uma imagem como o logotipo da sua integração e preencha os campos.
Aqui, faremos uma integração com o Notion como exemplo.
Campo Descrição Nome de spoke Nome para identificar o spoke personalizado. Descrição Descrição sobre o spoke personalizado. Nota:O valor do nome do escopo da aplicação está no formato: x_<company-code> _<spoke-name> _<spoke> . Por padrão, o<company-code> é, snc. Você pode configurar o código da empresa configurando o Valor da propriedade do sistema, glide.appcreator.company.code.
Este valor configurado é usado quando o valor Nome do escopo da aplicação é gerado.
-
Se você optar por criar o spoke em um escopo existente, selecione uma imagem como o logotipo da sua integração e preencha os campos.
Aqui, vamos passar por uma integração com a AWS como exemplo.
Campo Descrição Nome da aplicação Um nome ou escopo de aplicação existente. Nome do escopo da aplicação Nome do escopo que é preenchido automaticamente com base no nome da aplicaçãoselecionado. Descrição Descrição sobre o spoke personalizado.
-
Se você optar por criar o spoke em um novo escopo, selecione uma imagem como o logotipo da sua integração e preencha os campos.
-
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.
-
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.
-
Instale o spoke da Store.
Para mais detalhes, consulte Install a ServiceNow Store application.
-
Depois de instalar o spoke, navegue até a guia Workflow Studio.
O sistema exibe a mensagem Você instalou um spoke da Store?.
-
Selecione uma dessas opções e clique em Continuar.
Opção Descrição Sim, exiba o spoke instalado. Opção para redirecionar para o painel Spokes 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.
-
Clique em Exibir detalhes na Store para ver os detalhes dos spokes correspondentes.
-
Clique em Ignorar se quiser criar o spoke personalizado.
Nota:Essas etapas a seguir também são aplicáveis se você selecionou Não, criarei um spoke personalizado. opção.
O spoke é criado e uma mensagem de confirmação é exibida.
-
Na tela Criar informações, selecione o método usado para criar seu spoke.
Você pode optar por criar seu spoke usando a especificação OpenAPI ou a coleção do Postman.
-
Selecione a coleção do Postman e clique em Continuar para importar uma coleção do Postman.
- Para a origem da coleção do Postman, clique em Importar novo.
-
Na tela Importar nova origem de coleção do Postman, execute uma destas duas etapas.
-
Se você quiser importar usando uma URL, selecione Importar da URL para o método de importação e especifique a URL em URL de coleção do Postman.
-
Se você quiser importar manualmente usando o código JSON, selecione Importar de JSON manualmente para o método de importação e forneça o código em JSON.
-
Se você quiser importar usando uma URL, selecione Importar da URL para o método de importação e especifique a URL em URL de coleção do Postman.
-
Clique em Importar.
A origem da coleção do Postman é importada.
- Para Alias de conexão e credencial, clique em Criar novo.
-
Na tela Criar novo alias de conexão e credencial, preencha os campos e forneça as informações de alias.
Campo Descrição Nome da conexão e da 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 que você forneceu. Você pode continuar com a opção padrão ou alterá-la de acordo com seus requisitos. - Clique em Criar alias e continuar.
-
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 ao servidor de terceiros. Este URL é preenchido automaticamente com base na origem da coleção do Postman 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. Se você quiser configurar o registro de alias mais tarde, clique em Fazer isso mais tarde.
-
Clique em Enviar.
O registro do alias de conexão foi criado.
-
Clique em Gerar operações.
Todas as operações que podem ser realizadas usando a especificação OpenAPI são listadas.
-
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.
-
Clique em Publicar.
Como alternativa, você também pode selecionar Salvar ações como rascunho para salvar as ações como rascunho, modificá-las de acordo com seus requisitos e publicá-las posteriormente.
-
Clique em Concluído: ir 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.
- As 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 seus requisitos.
- 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 de spoke é realizada, o sistema gera suas informações como um log de atividade de spoke. Clique no Número necessário 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 foi criado e esta operação será executada em breve. error Falha ao executar a operação. 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 Como criar subfluxos.
Junto com o 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.