Atividade Criando ou editando um terminal para o JIRA

Os terminais fornecem as informações de configuração que o Studio e o Integration Appliance usam para se conectar à plataforma do JIRA. O conector JIRA suporta somente o mecanismo de autenticação Básica, para autorizar usuários a executar operações. O conector JIRA suporta a conexão HTTPS.

Selecionando ou editando um terminal JIRA

  1. Na área de janela Criar terminal ou Editar terminal, configure o terminal JIRA conforme descrito na tabela a seguir.
    Nota: Mudar as propriedades de configuração de um terminal afeta todas as orquestrações que usam esse terminal no projeto. As edições são globais, não locais.
  2. Clique em Conexão de teste para confirmar que os detalhes da conexão são válidos e que você é capaz de se conectar ao JIRA com sucesso.
  3. Clique em OK.
Tabela 1. Propriedades da Conexão
Nome do Campo Descrição
Nome do Host Nome do host para a instância do JIRA (no local ou nuvem).
Número da Porta Porta para a instância do JIRA
Nome do Usuário Nome do usuário de autenticação para acessar a instância do JIRA.
Senha Senha de autenticação para acessar a instância do JIRA.
Os parâmetros a seguir são necessários na tela de conexão de teste do terminal para fazer conexão via Proxy:
Nome do Host Nome do host da Rede proxy
Porta Número da porta da Rede proxy.
Nome do Usuário Nome do usuário para acessar serviço por meio da rede proxy.
Senha Senha para acessar serviço por meio da rede proxy.
Os parâmetros a seguir são necessários na tela de conexão de teste do terminal para fazer conexão HTTPS (HTTP sobre SSL):
HTTPS Caixa de seleção para indicar se HTTPS deve ser usado
Além dos parâmetros acima, há também uma provisão para que a configuração do Conector seguro conecte o Terminal à instância do JIRA no local.
Nota: Na seção Mapear entrada de cada atividade, campos relevantes do painel de terminal estão disponíveis para substituição no tempo de execução. É possível fornecer dados para vários grupos de parâmetros, como Detalhes do proxy, Detalhes da conexão ou Detalhes de autenticação a serem substituídos. Não é permitido substituir o fornecimento apenas de dados de campo parciais em um grupo selecionado.

Objetos suportados pelo conector JIRA

O conector JIRA suporta os objetos do JIRA conforme detalhado na tabela abaixo:

Tabela 2. Operações suportadas pelos objetos do JIRA
Objetos do JIRA Criar Atualizar Exclusão Recuperar Todos Retrieve Procura
Anexo Sim Sim Sim
Component Sim Sim
Filtro Sim Sim Sim Sim
Emitir Sim Sim Sim Sim Sim
IssueComment Sim Sim Sim Sim Sim
IssueLink Sim Sim Sim
IssueLinkType Sim Sim Sim Sim Sim
IssueWorkLog Sim Sim Sim Sim Sim
IssueVote Sim Sim
Versão Sim Sim Sim Sim
ProjectRole Sim Sim
Votos Sim
Observadores Sim Sim Sim
Group Sim
IssueType Sim Sim
Prioridade Sim Sim
Projeto Sim
Resolution Sim Sim
Status Sim Sim
Usuário Sim Sim
UserOverMultiProject Sim
AssignableUser Sim
UsersWithPermissions Sim

Suporte a objetos customizados

O JIRA não suporta objetos customizados.

Suporte aos campos customizados

A UI (interface com o usuário) do JIRA permite ao usuário incluir campos customizados. Esses campos estão associados apenas ao objeto 'Problema' do JIRA. O suporte para campos customizados é fornecido nas atividades do conector: Criar, Atualizar, Procurar e Recuperar do objeto Problema.

Em MapInputs para as atividades Criar e Atualizar, o objeto Problema terá nós adicionais para campos customizados para que o usuário possa fornecer valores para eles.

Para as atividades Procurar e Recuperar, MapOutputs terá nós adicionais para identificar os campos customizados.

O formato de campos customizados para essas atividades é como mostrado abaixo:
<customFields>
<customFieldId>dept-id</customFieldId>
 <customFieldName>deptName</customFieldName>
<customFieldType>FreeTextField</customFieldType>
 <customFieldValue>HR</customFieldValue>
 </customField>
Tabela 3. Operações suportadas pelos objetos do JIRA
Parâmetro de campo customizado Descrição
customFieldId O ID do campo customizado criado na UI (interface com o usuário) do JIRA. Entre Nome e ID do campo customizado, a precedência é dada para 'customFieldId'. Se houver múltiplos campos customizados com o mesmo nome, o customFieldId deverá ser fornecido para diferenciar os campos, caso contrário, serão exibidos erros apropriados.
customFieldName O nome do campo customizado que é fornecido na UI (interface com o usuário) do JIRA durante sua criação.
customFieldType

O tipo de campo customizado, exibido apenas para atividades Criar/Atualizar. Valores permitidos são:

  • DatePickerField
  • DateTimeField
  • FreeTextField
  • Checkboxes
  • Labels
  • MultiSelect
  • RadioButtons
  • SelectList
  • TextField
  • URLField
  • UserPicker
  • GroupPicker
  • MultiGroupPicker
  • MultiUserPicker
  • ProjectPicker
  • SingleVersionPicker
  • VersionPicker

Os tipos de campos customizados do JIRA ainda não suportados são:

  • CascadingSelectField
  • NumberField
customFieldValue O valor do campo customizado. Esse parâmetro é recorrente para suportar múltiplos valores de entrada do usuário. Se múltiplos valores forem fornecidos para um único campo de entrada, somente o primeiro valor será incluído.
Nota:
  1. O campo customizado é opcional.
  2. Se o valor não for fornecido para customFieldName/customFieldId, os outros 2 valores de parâmetros serão ignorados e o problema será criado/atualizado com êxito sem modificação em qualquer campo customizado.
  3. Se customFieldName, customFieldId e customFieldType forem fornecidos, uma mensagem de erro apropriada será exibida para o valor ausente para customFieldValue.