Criação do Construtor de Conectores¶

Introdução¶

Esta página descreve como criar e configurar um novo conector ou editar um conector existente usando o Connector Builder.

Crie um Novo Conector¶

Ao acessar o Connector Builder, se nenhum conector personalizado do Connector Builder estiver acessível, esta tela ficará em branco. Clique em Novo conector para começar:

Ao clicar em Novo Conector, a tela de criação do conector é aberta. Existem quatro etapas de configuração, cada uma abordada nas próximas seções:

• Etapa 1: Configurações básicas
• Etapa 2: Autenticação
• Etapa 3: Atividades do Conector
• Etapa 4: Resumo e Confirmação

Para demonstrar a criação de um conector, estas etapas mostram como criar um conector personalizado usando Atlassian Jira como o endpoint.

Etapa 1: Configurações Básicas¶

• Carregar imagem: Use o link Procurar arquivos locais para selecionar um arquivo SVG a ser usado como imagem em miniatura no conector. A imagem não deve ter mais de 120 KB de tamanho. Para substituir uma imagem que já foi selecionada, clique novamente em Procurar arquivos locais para selecionar um arquivo diferente.

• Remover imagem: Para limpar uma imagem que foi selecionada, clique no link Remover imagem. Isso reverte a imagem para a imagem padrão do Connector Builder.

• Nome do conector: Insira um nome para o conector a ser usado para registrar o conector no Harmony. O nome do conector também é mostrado aos usuários finais como uma dica de ferramenta quando eles passam o mouse sobre o conector na paleta de componentes de design.

  Somente letras, números ou espaços são permitidos (sem caracteres especiais). Podem ser reservados alguns nomes que já estão em uso em outras áreas do produto, caso em que uma mensagem indica que o nome já está em uso.

• Nome de exibição: Insira um nome para o conector ser o nome do conector principal visto pelos usuários finais.

• Versão #: Insira um número de versão a ser usado para identificar esse conector. Somente letras e números são permitidos (sem caracteres especiais ou espaços).

• Descrição: Insira uma descrição do conector. Esta descrição aparece no Connector Builder e pode ser útil para ajudar os membros da organização com permissão Admin a entender o conector. A descrição não é exibida aos usuários finais.

• Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa.

• Salvar alterações: Clique para salvar a configuração desta etapa e navegue até Etapa 4: Resumo e confirmação.

• Excluir: Depois de abrir um conector existente para editar, clique para excluir permanentemente o conector da organização e fechar a configuração. Para obter mais informações, consulte Excluir ou cancelar publicação de um conector mais adiante nesta página.

• Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Autenticação¶

• Tipo de autenticação: Use o menu suspenso para selecionar a autenticação Anônima ou Básica. Outros tipos de autenticação não são suportados atualmente.

  • Anônimo: Selecione este tipo se nenhuma autenticação HTTP for necessária. Isso também é conhecido como autenticação anônima, sem nome de usuário ou senha.
  • Básico: Selecione este tipo para usar autenticação HTTP básica sem criptografia SSL. Observe que se esta opção for utilizada, a senha fornecida será enviada em texto não criptografado.

• URL de teste de autenticação: Quando Básico for selecionado, insira um URL que você deseja testar com as credenciais de um usuário final quando ele estiver configurando esse conector. Isto é para fins de validação para garantir que uma conexão possa ser feita usando o tipo de autenticação configurado com as credenciais do usuário final. Este campo não está presente quando Anônimo é selecionado.

  • Oculto: Se você não deseja que os usuários finais vejam o campo URL de teste de autenticação ao configurar este conector, marque esta caixa de seleção.
  • Cadeado: Aplicável somente quando um campo não está oculto, o ícone de cadeado é uma indicação se o campo será somente leitura ou editável pelos usuários finais. Isto é fornecido só para fins informativos; ao criar um conector, você não poderá alternar isso.
    • Bloqueado: Um ícone de cadeado fechado indica que o campo é somente leitura para usuários finais.
    • Desbloqueado: Um ícone de cadeado aberto indica que o campo está disponível para edição pelos usuários finais. Este é o comportamento padrão para campos que não estão ocultos e não podem ser alterados.

• Método de teste de autenticação: Quando Básico for selecionado, use o menu suspenso para selecionar o tipo de método a ser usado com o URL de teste de autenticação inserido acima, selecionando entre GET, PUT, ou POST. Este campo não está presente quando Anônimo é selecionado.

  Dica

  Para escolher uma URL e um método para testar a autenticação, recomendamos usar um simples GET solicitar. Verifique a documentação da API do seu endpoint para construir uma URL para o seu endpoint testar.

• Credenciais: Quando Básico é selecionado, esta tabela mostra informações sobre os campos que o usuário final usará para fornecer suas credenciais:

  • Nome do campo: O nome do campo no Connector Builder. Isto não será visto pelos usuários finais e não pode ser editado.
  • Nome de exibição: Este nome será visto pelo usuário final que estiver configurando a conexão. Por padrão, é igual ao Nome do campo. Você pode renomear este campo usando as ações disponíveis na última coluna. Por exemplo, você pode renomear "Nome de usuário" para "Endereço E-mail " ou renomear "Senha" para "Token de API ", dependendo dos requisitos específicos do endpoint.
  • Ações: Passe o mouse sobre a célula da coluna e clique no ícone de edição para fazer alterações na linha. Quando terminar, clique no botão Salvar que aparece nesta célula.

• Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima etapa.

• Salvar alterações: Clique para salvar a configuração desta etapa e navegue até Etapa 4: Resumo e confirmação.

• Excluir: Disponível somente após abrir um conector existente para edição, clique para excluir permanentemente o conector da organização e fechar a configuração. Para obter mais informações, consulte Excluir ou cancelar publicação de um conector mais adiante nesta página.

• Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: Atividades do Conector¶

• URL base: Insira um URL base que você deseja que seja usado para todas as atividades configuradas pelo usuário final. Não inclua parâmetros ou caminhos de consultar, a menos que sejam usados para todas as atividades. (Um usuário final poderá especificar caminhos e parâmetros exclusivos durante a configuração da atividade.)

  Dica

  Se uma versão estiver incluída no URL do endpoint, você pode querer incluí-la como parte do URL base. Se a versão exigir atualização, você poderá alterá-la aqui para que todas as atividades herdem o caminho da nova versão. (Observe que você deve validar que os caminhos serão válidos com uma nova versão.)

  • Oculto: Se você não deseja que os usuários finais vejam o campo URL base ao configurar este conector, marque esta caixa de seleção.
  • Cadeado: Aplicável somente quando um campo não está oculto, o ícone de cadeado é uma indicação se o campo será somente leitura ou editável pelos usuários finais. Isto é fornecido só para fins informativos; ao criar um conector, você não poderá alternar isso.
    • Bloqueado: Um ícone de cadeado fechado indica que o campo é somente leitura para usuários finais.
    • Desbloqueado: Um ícone de cadeado aberto indica que o campo está disponível para edição pelos usuários finais. Este é o comportamento padrão para campos que não estão ocultos e não podem ser alterados.

• Cabeçalhos de solicitação globais: Para adicionar cabeçalhos de solicitação que se aplicam a todas as atividades, use o link Adicionar para inserir uma nova linha em branco na tabela abaixo do link e preencha os campos:

  • Nome e Valor: Insira um nome de cabeçalho e um valor correspondente para usar em todas as atividades.

    Dica

    Os cabeçalhos de solicitação para inserir podem ser encontrados na documentação da API do endpoint ou testando com uma ferramenta de externo, como Postman ou SoapUI.

  • Ações: Clique no botão Salvar para salvar a linha. Para excluir ou editar uma linha de cabeçalho que foi salva, passe o mouse sobre a célula da coluna e clique no ícone de edição ou exclua o ícone, respectivamente, para fazer alterações ou remover a linha do cabeçalho.

• Atividades: Para adicionar atividades que ficarão disponíveis para um usuário final configurar, use o link Adicionar para criar uma nova atividade na tabela abaixo do link. Para obter informações sobre como criar uma nova atividade, consulte Criar atividades do conector mais adiante nesta página.

  Estas colunas são exibidas na tabela de atividades:

  • Nome da atividade e Nome para exibição: Esses campos mostram os valores inseridos durante a criação da atividade.

  • Solicitação e Resposta: Esses campos indicam se um esquema de solicitação ou resposta foi inserido durante a criação da atividade.

  • Ações: Para excluir ou editar uma linha de atividade que foi salva, passe o mouse sobre a célula da coluna e clique no ícone de edição ou exclua o ícone, respectivamente, para fazer alterações ou remover a linha de atividade.

• Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa.

• Salvar alterações: Clique para salvar a configuração desta etapa e prosseguir para a próxima etapa.

• Excluir: Disponível somente após abrir um conector existente para edição, clique para excluir permanentemente o conector da organização e fechar a configuração. Para obter mais informações, consulte Excluir ou cancelar publicação de um conector mais adiante nesta página.

• Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

• Teste: Clique para abrir uma tela separada onde você pode testar o conector. Para obter mais informações, consulte Testar um conector mais adiante nesta página.

Etapa 4: Resumo e Confirmação¶

• Configurações básicas: Na parte superior há um resumo das informações inseridas em Etapa 1: Configurações básicas, incluindo a imagem, o nome do conector, o nome de exibição, a versão e a descrição.

  Para fazer alterações, clique no ícone de edição para voltar à Etapa 1: Configurações básicas.

• Autenticação: A próxima seção é um resumo das informações inseridas na Etapa 2: Autenticação, incluindo o tipo de autenticação. Caso seja utilizada a autenticação básica, também será exibido o URL do teste de autenticação e o método utilizado para o teste, com indicação se este campo está oculto.

  Para fazer alterações, clique no ícone de edição para voltar à Etapa 2: Autenticação.

• Atividades do Conector: A última seção é um resumo das informações inseridas na Etapa 3: Atividades do Conector, incluindo o URL base, cabeçalhos de solicitação global e atividades.

  Para fazer alterações, clique no ícone de edição para voltar à Etapa 3: atividades do conector.

• Salvar: Clique para salvar e fechar o conector. O conector será salvo no Cloud Studio, mas ainda não foi publicado ou disponível para uso dos usuários finais. Quando você salva um conector, ele fica acessível na página Construtor de Conector pela pessoa que o criou e por outros membros da organização que tenham permissão de Admin.

• Publicar: Clique para salvar e publicar o conector. Ao publicar, o conector é automaticamente registrado no Harmony e publicado no agente. Ele fica então disponível para ser usado pelos usuários finais na organização (consulte Configuração do usuário do Connector Builder).

  Se você editar e republicar um conector que já foi publicado, uma mensagem solicitará que você confirme que deseja substituir a versão publicada anteriormente:

  

  Cuidado

  Se o conector já estiver em uso, dependendo das alterações, isso pode fazer com que algumas operações se tornem inválidas. Recomendamos verificar cada local onde o conector é usado para validar se está funcionando corretamente após a republicação.

  Para determinar os projetos onde cada conector é usado, você pode tentar excluir o conector. Os projetos em que o conector está "em uso" são listados na mensagem de erro indicando que o conector não pode ser excluído porque está em uso (consulte Excluir ou cancelar a publicação de um conector mais adiante nesta página).

  Depois de saber quais projetos usam o conector, você pode tentar excluir a conexão nesses projetos. Os componentes que dependem da conexão são listados na mensagem de erro indicando que a conexão não pode ser excluída porque possui dependências (consulte a opção Excluir em Configurar uma conexão em Configuração do usuário do Connector Builder).

• Cancelar publicação: Disponível apenas para conectores que foram publicados. Clique para ocultar o conector dos usuários finais. Para obter mais informações, consulte Excluir ou cancelar publicação de um conector mais adiante nesta página.

• Excluir: Disponível somente após abrir um conector existente para edição, clique para excluir permanentemente o conector da organização e fechar a configuração. Para obter mais informações, consulte Excluir ou cancelar publicação de um conector mais adiante nesta página.

• Exportar: Gera e baixa o conector como um arquivo JSON com os metadados do conector (consulte Exportações e importações do Connector Builder).

Testar um Conector¶

Testar um conector permite testar a conexão antes da publicação.

A opção de testar um conector está disponível como botão na parte inferior da Etapa 3: Atividades do Conector durante a criação do conector:

Ao clicar no botão Testar, uma tela separada é aberta onde você pode testar o conector:

• URL base: Insira o URL base a ser usado para testar o conector.

• Caminho: Se aplicável, insira um caminho a ser anexado à URL base a ser usada para testar o conector.

• Verbo HTTP: Use o menu suspenso para selecionar o método apropriado para testar o conector com o URL listado à direita. A URL é construída a partir da URL base e do caminho fornecidos. Você pode selecionar entre GET, PUT, POST, DELETE, ou PATCH.

• Nome de usuário e Senha: Estas são as credenciais de Nome de campo configuradas na Etapa 2: Autenticação. Os campos Nome de exibição não são exibidos.

• Corpo da solicitação: Esta área estará presente apenas se o verbo HTTP selecionado for PUT, POST, ou PATCH. Insira ou cole manualmente o corpo da solicitação nesta área. Você pode usar o ícone popout para editar o corpo da solicitação em uma área maior (após abrir essa área, clique no ícone de retorno para retornar a esta tela). Não há suporte para carregar um arquivo de um esquema de um URL ou arquivo.

  

• Teste: Ao clicar em Teste, aparece uma mensagem ao lado do botão indicando se a conexão foi bem sucedida ou falhou. Se a conexão falhar, um link para mais detalhes estará presente.

Criar Atividades de Conector¶

As atividades do conector devem ser adicionadas para que os usuários finais possam configurá-las para interagir com um endpoint.

A área para adicionar atividades do conector está em Atividades na Etapa 3: Atividades do conector de criação do conector.

Para adicionar atividades que ficarão disponíveis para configuração por um usuário final, use o link Adicionar para inserir uma nova atividade:

Ao clicar neste link, uma nova tela se abre para você inserir informações sobre a atividade:

• Nome da atividade: Insira um nome para a atividade. Isto será visto apenas por aqueles com acesso à criação do conector e não será visto pelos usuários finais.

• Nome de exibição: Insira um nome para a atividade a ser vista pelos usuários finais que usarão o conector.

• Descrição: Insira uma descrição desta atividade. Isto será visto apenas por aqueles com acesso à criação do conector e não será visto pelos usuários finais.

  Dica

  Pode ser uma boa ideia usar o mesmo nome e descrição usados na documentação da API do endpoint para ajudar outras pessoas com acesso à criação do conector a entender exatamente para que serve a atividade.

• Método: Use o menu suspenso para selecionar o método apropriado, selecionando entre GET, PUT, POST, DELETE, PATCH, ou MERGE. Os métodos personalizados não são suportados para criação de conectores usando o Connector Builder, mas podem ser configurados usando um endpoint HTTP genérico em vez de.

• Caminho: Insira um caminho que deve ser anexado ao URL Base fornecido na Etapa 3: Atividades do Conector. Os parâmetros de caminho que você deseja que o usuário final configure podem ser especificados entre chaves. Por exemplo, /users/{firstname}/{lastname} define dois parâmetros de caminho, firstName e lastName. Os parâmetros de caminho inseridos desta forma aparecerão automaticamente como linhas no campo Parâmetros de caminho abaixo.

• Parâmetros de caminho: Este campo exibe uma tabela de resumo dos parâmetros de caminho inseridos em Caminho conforme descrito acima, com estas colunas:

  • Nome: O nome do parâmetro de caminho inserido acima é exibido. Para editar o nome do caminho, edite o campo Caminho acima.
  • Nome de exibição: Este nome será visto pelo usuário final que configura a atividade. Por padrão, este campo é igual ao campo Nome. Você pode renomear este campo usando as ações disponíveis na última coluna.
  • Tipo: Por padrão, o tipo é string. Você pode tornar este campo editável usando as ações disponíveis na última coluna. Esses tipos de dados estão disponíveis no menu suspenso: boolean, date, double, float, integer, long, string.
  • Ações: Para excluir ou editar uma linha de parâmetro, passe o mouse sobre a célula da coluna e clique no ícone de edição ou exclua o ícone, respectivamente, para fazer alterações ou remover a linha do parâmetro. Se a linha for editável no momento, clique no botão Salvar para salvá-la.

• Parâmetros de string de consulta: Para adicionar parâmetros de string de consultar para a atividade, use o link Adicionar para inserir uma nova linha em branco na tabela abaixo e preencha os campos:

  • Nome: Insira o nome do parâmetro de string de consultar a ser usado.
  • Nome de exibição: Insira o nome que deseja exibir no conector para o parâmetro de string de consultar. Este nome será visto pelo usuário final que configura a atividade.
  • Tipo: Use o menu suspenso para selecionar um destes tipos de dados: boolean, date, double, float, integer, long, string.
  • Obrigatório: Marque a caixa de seleção para tornar o parâmetro da string de consultar obrigatório a ser inserido pelo usuário final que configura a atividade.
  • Padrão: Se aplicável, insira um valor padrão para o parâmetro de string de consultar que será fornecido ao usuário final que configura a atividade.
  • Ações: Clique no botão Salvar para salvar a linha. Para excluir ou editar uma linha de parâmetro de string de consultar que foi salva, passe o mouse sobre a célula da coluna e clique no ícone de edição ou exclua o ícone, respectivamente, para fazer alterações ou remover a linha do parâmetro da string de consultar.

• Cabeçalhos de solicitação: Para adicionar cabeçalhos de solicitação para a atividade, use o link Adicionar para inserir uma nova linha em branco na tabela abaixo e preencha os campos:

  • Nome: Insira o nome do cabeçalho da solicitação a ser usado.
  • Nome para exibição: Insira o nome que deseja exibir no conector para o cabeçalho da solicitação. Este nome será visto pelo usuário final que configura a atividade.
  • Tipo: Use o menu suspenso para selecionar um destes tipos de dados: boolean, date, double, float, integer, long, string.
  • Obrigatório: Marque a caixa de seleção para tornar o cabeçalho da solicitação obrigatório para ser inserido pelo usuário final que configura a atividade.
  • Padrão: Se aplicável, insira um valor padrão para o cabeçalho da solicitação que será fornecido ao usuário final que configura a atividade.
  • Ações: Clique no botão Salvar para salvar a linha. Para excluir ou editar uma linha de cabeçalho de solicitação que foi salva, passe o mouse sobre a célula da coluna e clique no ícone de edição ou exclua o ícone, respectivamente, para fazer alterações ou remover a linha do cabeçalho da solicitação.

• Esquema do corpo de solicitação e Esquema do corpo de resposta: Essas áreas são usadas para fornecer estruturas de solicitação e resposta. Quando o Método selecionado for GET, é necessário fornecer um Request Body Schema e não é possível fornecer um esquema de resposta. Quando o Método selecionado for qualquer outro método, fornecer qualquer um dos esquema é opcional.

  Se você deve fornecer essas estruturas depende da chamada de API específica. Exemplos de estruturas de solicitação e resposta geralmente podem ser obtidos na documentação da API de um endpoint. Para verificar sua precisão, essas estruturas devem ser validadas usando uma ferramenta de externo, como Postman ou SoapUI.

  Se uma API responder com mais de uma estrutura de resposta JSON possível, é recomendado combinar as estruturas de resposta em uma estrutura para lidar com todas as respostas possíveis, pois todos os campos em uma estrutura JSON são opcionais.

  Os esquema carregados são usados exclusivamente com a finalidade de definir a solicitação de atividade do Connector Builder ou os esquemas de resposta. Ao contrário de um projeto do Cloud Studio, os esquemas não são salvos e não estão disponíveis para reutilização em outro lugar no Connector Builder ou no Cloud Studio.

  Depois de editar os esquemas em um conector existente do Connector Builder que já está em uso no projeto do Cloud Studio, o usuário do conector deve usar o botão Atualizar na etapa Esquema de dados para trazer no esquema atual definido (consulte Configuração do usuário do Connector Builder).

  Cuidado

  Solicitações imprecisas ou estruturas de resposta levarão a erros no Harmony. É altamente recomendável testar com uma ferramenta de externo para verificar a precisão.

  • Carregar URL: Clique para abrir uma caixa de diálogo onde você pode carregar um esquema de um URL:

    

    • Tipo de arquivo: Use o menu suspenso para selecionar entre os tipos de arquivo suportados, incluindo JSON, XML e XSD.

    • URL: Insira uma URL que seja acessível sem autenticação. Arquivos de até 5 MB podem ser carregados.

    • Carregar: Clique para carregar o esquema do URL. Observe que o arquivo é recuperado apenas uma vez para geração de esquema.

      Nota

      Ao fazer upload de um arquivo XSD que contém vários elementos de nível superior, você será solicitado a selecionar o nó raiz desejado. Selecione o elemento e clique em Concluir para fazer upload do arquivo.

    • Cancelar: Clique em Cancelar para fechar a caixa de diálogo Upload Schema URL sem salvar.

  • Carregar arquivo: Clique para abrir uma caixa de diálogo onde você pode carregar um esquema de um arquivo que pode ser acessado na máquina atual:

    

    • Tipo de arquivo: Use o menu suspenso para selecionar entre os tipos de arquivo suportados, incluindo JSON, XML e XSD.

    • Arquivo: Use o botão Procurar à direita para navegar até um arquivo que ainda não foi usado no projeto atual. Arquivos de até 5 MB podem ser carregados.

    • Carregar: Clique para carregar o esquema do arquivo.

      Nota

      Ao fazer upload de um arquivo XSD que contém vários elementos de nível superior, você será solicitado a selecionar o nó raiz desejado. Selecione o elemento e clique em Concluir para fazer upload do arquivo.

    • Cancelar: Clique para fechar a caixa de diálogo Carregar arquivo de esquema sem salvar.

  • Visualizar/Editar Esquema: Se você não estiver carregando um esquema, você pode inserir um manualmente na área de texto abaixo dos botões Carregar URL e Carregar arquivo. Caso contrário, após fazer upload de um esquema, você poderá visualizar ou editar o esquema diretamente nesta área de texto.

    Para visualizar ou editar o esquema em uma área maior, clique no ícone popout (após abrir essa área, clique no ícone de retorno para voltar a esta tela).

    Esta área de texto também pode ser copiada usando Control+C (Windows ou Linux) ou Command+C (macOS).

• Aplicar: Clique para aplicar a atividade à configuração do conector e retornar à tela principal da Etapa 3: Atividades do Conector com a atividade adicionada como uma linha na tabela. Para salvar a atividade, clique no botão Salvar alterações na Etapa 3: atividades do conector.

• Aplicar e Novo: Clique para aplicar a atividade à configuração do conector e abrir outra tela onde informações para outra nova atividade podem ser adicionadas. Para salvar a atividade, clique no botão Salvar alterações na Etapa 3: atividades do conector.

• Cancelar: Clique para fechar a tela de atividades sem salvar e retornar à tela principal da Etapa 3: Atividades do Conector.

Excluir Ou Cancelar Publicação de um Conector¶

Antes de excluir ou cancelar a publicação de um conector, todos os componentes criados a partir desse conector em projetos devem primeiro ser excluídos conforme descrito em Excluir dependências do conector abaixo. Depois de fazer isso, consulte Excluir um conector ou Cancelar publicação de um conector abaixo.

Excluir Dependências do Conector¶

Antes de excluir ou cancelar a publicação de um conector, todos os componentes que usam o conector devem primeiro ser excluídos e os componentes anteriormente dependentes devem ser reimplantados na nuvem Harmony:

1. Exclua todas as atividades criadas a partir de conexões criadas usando o conector. Para excluir uma atividade, primeiro remova-a de qualquer operação em que ela seja usada. Em seguida, exclua a atividade do painel do projeto usando seu menu de ações. Para ambas as opções, consulte Menu Ações de Atividade em Noções básicas do conector.
2. Exclua todas as conexões criadas no conector. Consulte a opção Excluir em Configurar uma conexão em Configuração do usuário do Connector Builder.
3. Reimplante quaisquer operações que anteriormente dependiam das atividades agora excluídas. Como alternativa, você pode reimplantar todas as operações usadas pelos workflows de um projeto. Consulte Implantação do Projeto.

Isso removerá todas as referências ao conector nos projetos e nas implantações na nuvem Harmony.

Excluir um Conector¶

A exclusão de um conector exclui permanentemente o conector da organização.

A opção para excluir um conector está disponível como um link na parte inferior de cada etapa de configuração:

Ao clicar em Excluir, uma mensagem solicitará que você confirme que deseja excluir o conector:

Ao clicar em Continuar, o conector é excluído permanentemente e a configuração é fechada.

Se os componentes que dependem do conector ainda existirem na nuvem Harmony, uma mensagem de erro fornecerá os nomes de todos os projetos onde o conector ainda estiver "em uso":

Nesse caso, siga as etapas descritas em Excluir dependências do conector acima para primeiro excluir quaisquer componentes que dependam do conector e, em seguida, reimplantar quaisquer componentes anteriormente dependentes restantes na nuvem Harmony, como operações que anteriormente referenciavam as atividades.

Cancelar Publicação de um Conector¶

Cancelar a publicação de um conector oculta o conector dos usuários finais. Quando a publicação de um conector é cancelada, ele ainda fica acessível na página Construtor de Conector para a pessoa que o criou e para os membros da organização com permissão Admin, mas não fica mais visível para os usuários finais. Conectores não publicados podem ser republicados usando o botão Publicar.

A opção de cancelar a publicação de um conector está disponível como um link na parte inferior da Etapa 4: Resumo e configuração apenas para conectores que foram publicados:

Ao clicar em Cancelar publicação, a publicação do conector é imediatamente cancelada.

Se os componentes que dependem do conector ainda existirem na nuvem Harmony, uma mensagem de erro fornecerá os nomes de todos os projetos onde o conector ainda estiver "em uso":

Nesse caso, siga as etapas descritas em Excluir dependências do conector acima para primeiro excluir quaisquer componentes que dependam do conector e, em seguida, reimplantar quaisquer componentes anteriormente dependentes restantes na nuvem Harmony, como operações que anteriormente referenciavam as atividades.

Próximos Passos¶

Depois de publicar um conector, os membros da organização Harmony onde ele foi publicado terão acesso para configurar e usar o conector em projetos do Cloud Studio. Saiba mais em Configuração do usuário do Connector Builder.