Ações do Jira

Acesso antecipado — Agente de fluxo de trabalho

Este recurso está sujeito aos "Termos da Pré-GA" nos Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos Pré-lançamento de IA Generativa. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

Ação: Get project

Campos de entrada

Propriedade	Descrição	Tipo
ID	O ID do projeto.	integer

Variáveis de saída

Propriedade	Descrição	Tipo
entidades	O tipo de atribuição do projeto.	object
ComponentsAggregate	Os componentes do projeto.	string
Descrição	A descrição do projeto.	string
E-mail	O e-mail do projeto.	string
ID	O ID do projeto.	integer
IssueTypesAggregate	Os tipos de problema do projeto.	string
ItemURL	Um link navegável do projeto.	string
Key	A chave do projeto.	string
LeadAccountId	O ID do líder do projeto.	string
LeadDisplayName	O nome de exibição do líder do projeto.	string
LeadEmailAddress	O endereço de e-mail do líder do projeto.	string
Nome	O nome do projeto.	string
ProjectCategoryDescription	A descrição da categoria do projeto.	string
ProjectCategoryId	O ID da categoria do projeto.	string
ProjectCategoryName	O nome da categoria do projeto.	string
ProjectKeysAggregate	As chaves do projeto.	string
ProjectTypeKey	A chave do tipo de projeto. Não aplicável para atualização.	string
RolesAggregate	As funções do projeto.	string
Simplificado	Se o projeto é gerenciado por equipe ou não.	boolean
Url	O URL do projeto.	string
VersionsAggregate	As versões do projeto.	string

Ação: listar projetos

Campos de entrada

Propriedade	Descrição	Tipo
Consulta de filtro	Cláusula de filtro a ser aplicada à lista. Precisa ser um critério válido semelhante ao SQL em que os valores de coluna usam aspas simples. Isso é opcional.	string
Tamanho da página	O número de itens a serem retornados por página. Isso é opcional.	integer
Token de página	Token para a próxima página de resultados. Isso é opcional.	string

Variáveis de saída

Propriedade	Descrição	Tipo
entidades	O tipo de atribuição do projeto.	string
ComponentsAggregate	Os componentes do projeto.	string
Descrição	A descrição do projeto.	string
E-mail	O e-mail do projeto.	string
ID	O ID do projeto.	integer
IssueTypesAggregate	Os tipos de problema do projeto.	string
ItemURL	Um link navegável do projeto.	string
Key	A chave do projeto.	string
LeadAccountId	O ID do líder do projeto.	string
LeadDisplayName	O nome de exibição do líder do projeto.	string
LeadEmailAddress	O endereço de e-mail do líder do projeto.	string
Nome	O nome do projeto.	string
ProjectCategoryDescription	A descrição da categoria do projeto.	string
ProjectCategoryId	O ID da categoria do projeto.	string
ProjectCategoryName	O nome da categoria do projeto.	string
ProjectKeysAggregate	As chaves do projeto.	string
ProjectTypeKey	A chave do tipo de projeto. Não aplicável para atualização.	string
RolesAggregate	As funções do projeto.	string
Simplificado	Se o projeto é gerenciado por equipe ou não.	boolean
Url	O URL do projeto.	string
VersionsAggregate	As versões do projeto.	string

Ação: listar prioridades de problemas

Campos de entrada

Propriedade	Descrição	Tipo
Token de página	Token para a próxima página de resultados. Isso é opcional.	string
Cláusula de filtro	Uma cláusula de filtro semelhante a SQL para aplicar à lista de prioridades. Isso permite pesquisar com base em atributos de prioridade. Precisa ser um critério válido semelhante ao SQL em que os valores de coluna usam aspas simples.	string
Tamanho da página	O número de itens a serem retornados por página. Isso é opcional.	integer

Variáveis de saída

Propriedade	Descrição	Tipo
results	A descrição da prioridade do problema.	object
IconUrl	O URL do ícone da prioridade do problema.	string
ID	O ID da prioridade do problema.	string
Nome	O nome da prioridade do problema.	string
ProjectId	O ID do projeto	string
StatusColor	A cor usada para indicar a prioridade do problema.	string
URL	O URL da prioridade do problema.	string

Ação: receber comentário

Campos de entrada

Propriedade	Descrição	Tipo
ID	O ID do comentário.	integer
ID do problema	O ID do problema a que o comentário pertence.	integer

Variáveis de saída

Propriedade	Descrição	Tipo
entidades	O nome do autor do comentário.	object
AuthorDisplayName	O nome de exibição do autor do comentário.	string
AuthorEmail	O endereço de e-mail do autor do comentário.	string
Body	O corpo do comentário.	string
Criado em	A data em que o comentário foi criado.	string
ID	O ID do comentário.	integer
IssueCreatedDate	A data de criação do problema a que o comentário pertence.	string
IssueId	O ID do problema.	integer
IssueKey	A chave do problema.	string
IssueUpdatedDate	A data da última atualização do problema a que o comentário pertence.	string
ItemURL	Um link navegável do comentário.	string
JQL	A JQL (Jira Query Language) permite criar consultas estruturadas.	string
ProjectId	O ID do projeto do comentário.	integer
ProjectName	O nome do projeto do comentário.	string
RenderedBody	O corpo renderizado do comentário.	string
UpdateAuthorAccountId	O ID do autor que editou o comentário.	string
UpdateAuthorEmail	O endereço de e-mail do autor que editou o comentário.	string
UpdateDisplayName	O nome de exibição do autor que mudou o comentário.	string
Atualizada	A data em que o comentário foi atualizado.	string
VisibilityType	O tipo de visibilidade do comentário.	string
VisibilityValue	O valor de visibilidade do comentário.	string

Ação: listar comentários

Campos de entrada

Propriedade	Descrição	Tipo
Cláusula de filtro	Cláusula de filtro a ser aplicada à lista de comentários. Precisa ser um critério válido semelhante ao SQL em que os valores de coluna usam aspas simples.	string
Tamanho da página	O número de itens a serem retornados por página. Isso é opcional.	integer
Token de página	Token para a próxima página de resultados. Isso é opcional.	string

Variáveis de saída

Propriedade	Descrição	Tipo
entidades	O nome do autor do comentário.	object
AuthorDisplayName	O nome de exibição do autor do comentário.	string
AuthorEmail	O endereço de e-mail do autor do comentário.	string
Body	O corpo do comentário.	string
Criado em	A data em que o comentário foi criado.	string
ID	O ID do comentário.	integer
IssueCreatedDate	A data de criação do problema a que o comentário pertence.	string
IssueId	O ID do problema.	integer
IssueKey	A chave do problema.	string
IssueUpdatedDate	A data da última atualização do problema a que o comentário pertence.	string
ItemURL	Um link navegável do comentário.	string
JQL	A JQL (Jira Query Language) permite criar consultas estruturadas.	string
ProjectId	O ID do projeto do comentário.	integer
ProjectName	O nome do projeto do comentário.	string
RenderedBody	O corpo renderizado do comentário.	string
UpdateAuthorAccountId	O ID do autor que editou o comentário.	string
UpdateAuthorEmail	O endereço de e-mail do autor que editou o comentário.	string
UpdateDisplayName	O nome de exibição do autor que mudou o comentário.	string
Atualizada	A data em que o comentário foi atualizado.	string
VisibilityType	O tipo de visibilidade do comentário.	string
VisibilityValue	O valor de visibilidade do comentário.	string

Ação: listar tipos de problemas

Campos de entrada

Propriedade	Descrição	Tipo
Cláusula de filtro	Cláusula de filtro a ser aplicada à lista de tipos de problema. Precisa ser um critério válido semelhante ao SQL em que os valores de coluna usam aspas simples.	string
Tamanho da página	O número de itens a serem retornados por página. Isso é opcional.	integer
Token de página	Token para a próxima página de resultados. Isso é opcional.	string

Variáveis de saída

Propriedade	Descrição	Tipo
entidades	O ID do tipo de problema	integer
Descrição	A descrição do tipo de problema.	string
EntityId	ID exclusivo para projetos de próxima geração.	string
HierarchyLevel	Nível de hierarquia do tipo de problema.	integer
IconUrl	O URL do ícone do tipo de problema.	string
ID	O ID do tipo de problema.	string
Nome	O nome do tipo de problema.	string
Scope	Detalhes dos projetos de última geração em que o tipo de problema está disponível.	string
Self	O URL desses detalhes do tipo de problema.	string
Subtarefa	A subtarefa do tipo de problema. Não aplicável para atualização.	boolean

Ação: criar problema

Campos de entrada

Propriedade	Descrição	Tipo
Agregação de versões afetadas	Uma lista separada por vírgulas de nomes de versões afetadas por esse problema.	string
Usuário atribuído	O nome de usuário do atribuidor, usado em instâncias mais antigas do Jira. Tente extrair o nome do destinatário do contexto para os resultados da pesquisa.	string
Descrição	Uma explicação detalhada do problema	string
Data de conclusão	A data em que o problema deve ser concluído, no formato YYYY-MM-DD.	string
ID do tipo de problema	O identificador numérico exclusivo do tipo de problema que está sendo criado (por exemplo, bug, tarefa ou história). O identificador interno do tipo de problema. Pode haver vários identificadores numéricos para um determinado tipo de problema. Por exemplo, o tipo de problema "Bug" pode ter vários identificadores numéricos. Nesses casos, prefira o que é específico para o projeto.	string
Marcadores	Uma lista de rótulos separados por vírgulas a serem aplicados ao problema para categorização ou filtragem. Exemplo: label1,label2	string
Prioridade	O nome de exibição da prioridade do problema, como High ou Medium.	string
ID do projeto	O identificador numérico exclusivo do projeto em que o problema será criado. Ele serve como o identificador exclusivo do projeto que contém o problema.	string
Chave do projeto	A chave exclusiva do projeto, geralmente usada como prefixo em chaves de problema (por exemplo, PROJ).	string
Status	O nome legível do status do problema.	string
Resumo	Um breve resumo ou título que ofereça uma visão geral do problema. Exemplo: Bug in login page	string

Variáveis de saída

Propriedade	Descrição	Tipo
ID	O ID do problema.	integer

Ação: receber problema

Campos de entrada

Propriedade	Descrição	Tipo
ID	O ID do problema.	integer

Variáveis de saída

Propriedade	Descrição	Tipo
entidades	As versões afetadas do problema.	string
AggregateProgress	O progresso agregado do problema.	integer
AggregateTimeEstimate	A estimativa de tempo agregada do problema.	integer
AggregateTimeOriginalEstimate	A estimativa de tempo agregada original do problema.	integer
AggregateTimeSpent	O tempo total gasto no problema.	integer
AssigneeAccountId	O ID da conta do destinatário.	string
AssigneeDisplayName	Nome de exibição do destinatário.	string
AssigneeEmail	O e-mail da pessoa responsável pelo problema.	string
AssigneeKey	[DESCONTINUADO] A chave do atribuidor do problema.	string
AssigneeName	O nome do responsável pelo problema.	string
Anexos	Pesquise problemas com ou sem anexos. É possível consultar essa coluna com IS NULL ou IS NOT NULL.	string
Categoria	Pesquise problemas que pertencem a projetos em uma categoria específica.	string
Comentário	Pesquise problemas que tenham um comentário com um texto específico.	string
ComponentsAggregate	Pesquise problemas que pertencem a um componente específico de um projeto. Você pode pesquisar por nome ou ID do componente.	string
Criado em	A data de criação do problema.	string
CreatorAccountId	O ID da conta do criador de conteúdo.	string
CreatorDisplayName	Nome de exibição do criador do problema.	string
CreatorEmail	O e-mail do criador do problema.	string
CreatorKey	[DESCONTINUADO] A chave do criador do problema.	string
CreatorName	O nome do criador do problema.	string
Descrição	A descrição do problema.	string
DueDate	A data de conclusão do problema.	string
Ambiente	O ambiente de um problema.	string
Filtrar	Pesquise problemas de filtros salvos. É possível consultar essa coluna com o nome ou ID do filtro.	string
FixVersionsAggregate	As versões de correção do problema	string
HasVotes	O status do voto no problema.	boolean
ID	O ID do problema.	integer
IsWatching	Se o usuário autenticado no momento está acompanhando o problema.	boolean
IssueLinksAggregate	Os links do problema.	string
IssueTypeId	O ID do tipo de problema.	string
IssueTypeName	O nome do tipo de problema.	string
ItemURL	Um link navegável do problema.	string
JQL	A JQL (Jira Query Language) permite criar consultas estruturadas.	string
Key	A chave do problema.	string
Marcadores	Os rótulos de um problema.	string
LastViewed	A última vez que o problema foi visualizado.	string
OriginalEstimate	A estimativa de tempo original do problema.	string
OriginalEstimateSeconds	A estimativa de tempo original em segundos do problema.	integer
ParentId	O ID do problema	integer
ParentIssueTypeId	O ID do tipo de problema	string
ParentIssueTypeName	O nome do tipo de problema.	string
ParentKey	A chave do problema	string
ParentStatusId	O ID do status do problema	string
ParentStatusName	O nome do status do problema	string
PriorityId	O ID da prioridade do problema.	string
PriorityName	O nome da prioridade do problema.	string
ProjectId	O ID do projeto do problema.	string
ProjectKey	A chave do projeto do problema.	string
ProjectName	O nome do projeto do problema.	string
RemainingEstimate	A estimativa de tempo do problema.	string
RemainingEstimateSeconds	A estimativa de tempo em segundos do problema.	integer
ReporterAccountId	O ID da conta do denunciante.	string
ReporterDisplayName	Nome de exibição do criador do relatório de problema.	string
ReporterEmail	O e-mail do denunciante do problema.	string
ReporterKey	[DESCONTINUADO]A chave do denunciante do problema.	string
ReporterName	O nome de quem enviou o alerta sobre o problema.	string
ResolutionDate	A data de resolução do problema.	string
ResolutionDescription	A descrição da resolução do problema.	string
ResolutionId	O ID da resolução do problema.	string
ResolutionName	O nome da resolução do problema.	string
SecurityLevel	O nível de segurança de um problema.	string
SprintId	Pesquise problemas que pertencem a um sprint específico, especificando o ID dele.	integer
SprintName	Pesquise problemas que pertencem a um sprint específico, especificando o nome dele.	string
StatusCategoryId	O ID da categoria de status do problema.	string
StatusCategoryKey	A chave da categoria de status do problema.	string
StatusCategoryName	O nome da categoria de status do problema.	string
StatusId	O ID do status do problema.	string
StatusName	O nome do status do problema.	string
SubtasksAggregate	As subtarefas do problema.	string
Resumo	O resumo do problema.	string
TimeSpent	O tempo gasto no problema.	string
TimeSpentSeconds	O tempo gasto no problema em segundos.	integer
TotalProgress	O progresso total agregado do problema.	integer
Atualizada	A data atualizada do problema.	string
Votos	Votos do problema.	integer
WatchCount	O número de observações do problema.	integer
WorkRatio	A proporção de trabalho do problema.	integer

Ação: atualizar problema

Campos de entrada

Propriedade	Descrição	Tipo
Nome do atribuidor	O nome de usuário do atribuidor, usado em instâncias mais antigas do Jira. Sempre tente extrair o AssigneeName do contexto ou dos resultados da pesquisa.	string
Descrição	A nova descrição detalhada do problema. Isso vai substituir a descrição atual. Aceita o formato de documento da Atlassian (ADF) para rich text.	string
Data de conclusão	A nova data de conclusão do problema, no formato YYYY-MM-DD.	string
ID do problema	O identificador numérico exclusivo do problema a ser atualizado. Isso corresponde ao campo "Id" nos problemas.	string
Marcadores	Uma lista separada por vírgulas de rótulos a serem definidos no problema (por exemplo, bug,ui).	string
Prioridade	O nome de exibição da prioridade do problema, como High.	string
Status	O nome legível do status do problema.	string
Resumo	O novo resumo ou título do problema. Um breve resumo ou título que ofereça uma visão geral do problema.	string

Variáveis de saída

Propriedade	Descrição	Tipo
AccountId	O campo "AccountId" em "Users".	string

Ação: Get user

Campos de entrada

Propriedade	Descrição	Tipo
AccountId	O identificador exclusivo da conta da Atlassian do usuário.	string

Variáveis de saída

Propriedade	Descrição	Tipo
AccountId	O accountId do usuário, que o identifica de forma exclusiva em todos os produtos da Atlassian.	string
AccountType	O accountType do usuário.	string
Ativo	Indica se o usuário está ativo.	boolean
DisplayName	O nome de exibição do usuário.	string
EmailAddress	O endereço de e-mail do usuário.	string
GroupId	Obsoleto. O ID do grupo de que o usuário faz parte.	string
GroupName	Obsoleto. O nome do grupo de que o usuário faz parte.	string
IssueKey	Pesquise usuários que podem navegar por um problema específico.	string
Locale	A localidade do usuário.	string
Produtos	Uma string delimitada de produtos do Jira a que o usuário tem acesso. Por exemplo: jira-core,jira-servicedesk,jira-product-discovery,jira-software	string
ProjectKey	Pesquise usuários que podem navegar por qualquer problema em um projeto.	string
TimeZone	O fuso horário especificado no perfil do usuário.	string

Ação: listar usuários

Campos de entrada

Propriedade	Descrição	Tipo
Iniciar em	O índice baseado em zero do primeiro usuário a ser retornado para paginação.	integer
Max Results	O número máximo de usuários a serem retornados por página.	integer
Cláusula de filtro	Uma cláusula de filtro semelhante a SQL para aplicar à lista de usuários. Isso permite consultas avançadas com base nos atributos do usuário.	string
Tamanho da página	O número de itens a serem retornados por página. Isso é opcional.	integer
Token de página	Token para a próxima página de resultados. Isso é opcional.	string

Variáveis de saída

Propriedade	Descrição	Tipo
results	O accountId do usuário, que o identifica de forma exclusiva em todos os produtos da Atlassian.	string
AccountType	O accountType do usuário.	string
Ativo	Indica se o usuário está ativo.	boolean
DisplayName	O nome de exibição do usuário.	string
EmailAddress	O endereço de e-mail do usuário.	string
GroupId	Obsoleto. O ID do grupo de que o usuário faz parte.	string
GroupName	Obsoleto. O nome do grupo de que o usuário faz parte.	string
IssueKey	Pesquise usuários que podem navegar por um problema específico.	string
Locale	A localidade do usuário.	string
Produtos	Uma string delimitada de produtos do Jira a que o usuário tem acesso. Por exemplo: jira-core,jira-servicedesk,jira-product-discovery,jira-software	string
ProjectKey	Pesquise usuários que podem navegar por qualquer problema em um projeto.	string
TimeZone	O fuso horário especificado no perfil do usuário.	string

Ação: criar comentário

Campos de entrada

Propriedade	Descrição	Tipo
Chave do problema	Pesquisável (problemas do Jira). Por exemplo: PROJ-123	string
Comentário	Insira o conteúdo do seu comentário aqui.	string

Variáveis de saída

Propriedade	Descrição	Tipo
id	O identificador exclusivo do comentário criado.	string

Ação: problemas de pesquisa

Campos de entrada

Propriedade	Descrição	Tipo
Consulta JQL	Por exemplo: project = PROJ AND status = 'In Progress'	string
Ordenar por	Por exemplo: priority, dueDate	string
Max Results	Por exemplo: 50	integer
Token da próxima página	Insira o token da próxima página	string

Filtros de pesquisa

Filtro	Operadores	Descrição
Projeto	=, !=	Corresponda a problemas no projeto pesquisável do Jira selecionado.
Tipo de problema	=, !=	Corresponda o tipo de problema (por exemplo: bug, história, tarefa).
Responsável	=, !=	Corresponde aos problemas atribuídos ao usuário pesquisável do Jira selecionado.
Status	=, !=	Corresponda o status do problema (por exemplo: a fazer, em andamento, concluído).
Prioridade	=, !=, >, >=, <, <=	Corresponda à prioridade do problema. Use operadores de comparação para variar entre prioridades. Prioridades pesquisáveis do Jira.
Rótulos	=, !=	Corresponde a problemas marcados com o rótulo especificado.
ID	=, !=	Corresponda ao ID interno do problema.
Chave do problema	=, !=	Faça a correspondência com a chave do problema (por exemplo, PROJ-123).

Variáveis de saída

Propriedade	Descrição	Tipo
results	A lista de problemas que correspondem aos critérios de pesquisa.	array

Ação: fazer upload de um anexo

Campos de entrada

Propriedade	Descrição	Tipo
Nome do arquivo de entrada	Insira o nome do arquivo para fazer upload (por exemplo, debug.log).	string
Chave do problema	Pesquisável (problemas do Jira). Por exemplo: PROJ-123	string
Nome do anexo	Nome a ser exibido no Jira (opcional).	string
Conteúdo de texto	Insira o conteúdo de texto aqui (opcional).	string

Variáveis de saída

Propriedade	Descrição	Tipo
id	O identificador exclusivo do anexo enviado.	string

Ação: atualizar comentário

Campos de entrada

Propriedade	Descrição	Tipo
ID do comentário	Pesquisável (comentários do Jira). Insira o ID do comentário (por exemplo, 10001).	string
Chave do problema	Pesquisável (problemas do Jira). Insira a chave do problema (por exemplo, PROJ-101).	string
ID do problema (numérico)	Pesquisável (problemas do Jira). Insira o ID do problema (por exemplo: 10001)	string
Corpo do comentário	Insira o conteúdo atualizado do comentário.	string

Variáveis de saída

Propriedade	Descrição	Tipo
id	O identificador exclusivo do comentário atualizado.	string

Ação: mudar o status do problema

Campos de entrada

Propriedade	Descrição	Tipo
Chave do problema	Pesquisável (problemas do Jira). Por exemplo: PROJ-123	string
ID da transição	Por exemplo: 10001	string

Variáveis de saída

Propriedade	Descrição	Tipo
newStatus	O status resultante da transição.	string

Gatilho: quando um problema é criado ou atualizado

Filtros de acionador

Filtro	Operadores	Descrição
Projeto	=, !=	Corresponda a problemas no projeto pesquisável do Jira selecionado.
Tipo de problema	=, !=	Corresponda o tipo de problema (por exemplo: bug, história, tarefa).
Responsável	=, !=	Corresponde aos problemas atribuídos ao usuário pesquisável do Jira selecionado.
Status	=, !=	Corresponda o status do problema (por exemplo: a fazer, em andamento, concluído).
Prioridade	=, !=, >, >=, <, <=	Corresponda à prioridade do problema. Use operadores de comparação para variar entre prioridades. Prioridades pesquisáveis do Jira.
Rótulos	=, !=	Corresponde a problemas marcados com o rótulo especificado.
ID	=, !=	Corresponda ao ID interno do problema.
Chave do problema	=, !=	Faça a correspondência com a chave do problema (por exemplo, PROJ-123).