GitLab Query Language (GLQL)과 함께 함수를 사용하여 동적 쿼리를 만듭니다.

쿼리 내 함수#

쿼리를 컨텍스트에 맞게 만들려면 쿼리 내부에 함수를 사용합니다. 예를 들어 현재 사용자나 날짜로 필터링합니다.

현재 사용자#

함수 이름: currentUser

매개변수: 없음

구문: currentUser()

설명: 현재 인증된 사용자로 평가됩니다.

추가 세부 정보:

• 쿼리에서 이 함수를 사용하면 인증되지 않은 사용자에 대해 쿼리가 실패합니다.

예시:

• 현재 인증된 사용자가 담당자인 모든 이슈 목록:

  assignee = currentUser()
  

• 현재 인증된 사용자가 담당자이지만 작성자가 아닌 모든 머지 리퀘스트 목록:

  type = MergeRequest and assignee = currentUser() and author != currentUser()
  

오늘#

함수 이름: today

매개변수: 없음

구문: today()

설명: 사용자의 시간대에서 00:00의 오늘 날짜로 평가됩니다.

추가 세부 정보:

• = 연산자와 함께 사용하면 사용자의 시간대에서 00:00부터 23:59까지의 시간 범위가 고려됩니다.

예시:

• 오늘 생성된 모든 이슈 목록:

  created = today()
  

• 오늘 머지된 모든 머지 리퀘스트 목록:

  type = MergeRequest and merged = today()
  

임베디드 뷰의 함수#

임베디드 뷰의 기존 필드에서 새 컬럼을 도출하려면 fields 매개변수에 함수를 포함합니다.

새 컬럼으로 레이블 추출#

함수 이름: labels

매개변수: 하나 이상의 String 값

구문: labels("field1", "field2")

설명:

labels 함수는 하나 이상의 레이블 이름 문자열 값을 매개변수로 받아 이슈에서 해당 레이블만 포함하는 필터링된 컬럼을 만듭니다. 이 함수는 추출기로도 작동하므로, 레이블이 추출되면 일반 labels 컬럼도 표시하도록 선택한 경우에는 해당 컬럼에 더 이상 표시되지 않습니다.

추가 세부 정보:

• 기본적으로 이 함수는 레이블 이름과 정확하게 일치하는 것을 찾습니다. 문자열에 와일드카드 문자(*)를 사용하여 모든 문자와 일치시킬 수 있습니다.
• labels 함수에 최소 1개, 최대 100개의 레이블 이름을 전달할 수 있습니다.
• 이 함수에 전달되는 레이블 이름은 대소문자를 구분하지 않습니다. 예를 들어 Deliverable과 deliverable은 동일합니다.

예시:

• 컬럼에 모든 workflow 범위 레이블 포함:

  labels("workflow::*")
  

• Deliverable, Stretch, Spike 레이블 포함:

  labels("Deliverable", "Stretch", "Spike")
  

• backend, frontend 등 end로 끝나는 모든 레이블 포함:

  labels("*end")
  

임베디드 뷰에 labels 함수를 포함하려면:

```glql
display: list
fields: title, health, due, labels("workflow::*"), labels
limit: 5
query: project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```