VS Code 확장 프로그램의 커스텀 쿼리

요약

GitLab for VS Code 확장 프로그램은 VS Code에 GitLab ( tanuki ) 패널을 추가하며, 이를 통해 프로젝트 작업을 수행할 수 있습니다. 기본적으로 패널의 Issues and merge requests 섹션에는 다음 검색 쿼리의 결과가 표시됩니다:

GitLab for VS Code 확장 프로그램은 VS Code에 GitLab ( tanuki ) 패널을 추가하며, 이를 통해 프로젝트 작업을 수행할 수 있습니다.

기본적으로 패널의 Issues and merge requests 섹션에는 다음 검색 쿼리의 결과가 표시됩니다:

나에게 할당된 이슈
내가 생성한 이슈
나에게 할당된 머지 리퀘스트
내가 생성한 머지 리퀘스트
내가 리뷰 중인 머지 리퀘스트

커스텀 쿼리를 사용하면 이 섹션을 맞춤 설정하여 원하는 정보를 표시할 수 있습니다.

커스텀 쿼리 생성#

커스텀 쿼리는 GitLab ( tanuki ) 패널의 Issues and merge requests 아래에 표시되는 기본 쿼리를 재정의합니다.

패널에 커스텀 쿼리를 사용하려면:

VS Code에서 Settings 편집기를 엽니다:

macOS의 경우 Command+,를 누릅니다.
Windows 또는 Linux의 경우 Control+,를 누릅니다.
오른쪽 상단에서 **Open Settings (JSON)**을 선택하여 settings.json 파일을 편집합니다.
파일에서 다음 예시와 같이 gitlab.customQueries를 정의합니다. 각 쿼리는 gitlab.customQueries JSON 배열의 항목이어야 합니다:

{
  "gitlab.customQueries": [
    {
      "name": "Issues assigned to me",
      "type": "issues",
      "scope": "assigned_to_me",
      "noItemText": "No issues assigned to you.",
      "state": "opened"
    }
  ]
}

선택 사항. 기본 쿼리를 유지하려면 확장 프로그램의 desktop.package.json 파일의 default 배열에서 해당 쿼리를 복사하여 gitlab.customQueries 배열에 추가 커스텀 쿼리로 추가합니다.
변경 사항을 저장합니다.

모든 쿼리에 지원되는 파라미터#

다음 파라미터는 모든 쿼리 유형에 적용됩니다:

파라미터	필수 여부	기본값	설명
name	check-sm	None	GitLab 패널에 표시할 라벨을 지정합니다.
noItemText	No	No items found.	쿼리 결과가 없을 때 표시할 텍스트를 지정합니다.
type	No	merge_requests	반환할 항목 유형을 지정합니다. 가능한 값: issues, merge_requests, epics, snippets, vulnerabilities. 스니펫은 다른 필터를 지원하지 않습니다. 에픽은 GitLab Premium 및 Ultimate에서만 사용할 수 있습니다.

이슈, 에픽, 머지 리퀘스트 쿼리에 지원되는 파라미터#

다음 파라미터는 모두 선택 사항입니다.

파라미터	기본값	설명
assignee	None	주어진 사용자 이름에 할당된 항목을 반환합니다. None은 할당되지 않은 GitLab 항목을 반환합니다. Any는 담당자가 있는 GitLab 항목을 반환합니다. 에픽 및 취약점에는 사용할 수 없습니다.
author	None	주어진 사용자 이름이 생성한 항목을 반환합니다.
confidential	None	비공개 또는 공개 이슈를 반환합니다. 이슈에만 사용할 수 있습니다.
createdAfter	None	주어진 날짜 이후에 생성된 항목을 반환합니다.
createdBefore	None	주어진 날짜 이전에 생성된 항목을 반환합니다.
draft	no	드래프트 상태로 필터링된 머지 리퀘스트를 반환합니다. yes는 드래프트 상태의 머지 리퀘스트만 반환하고, no는 드래프트 상태가 아닌 머지 리퀘스트만 반환합니다. 머지 리퀘스트에만 사용할 수 있습니다.
excludeAssignee	None	주어진 사용자 이름에 할당되지 않은 항목을 반환합니다. 이슈에만 사용할 수 있습니다. 현재 사용자는 <current_user>로 설정합니다.
excludeAuthor	None	주어진 사용자 이름이 생성하지 않은 항목을 반환합니다. 이슈에만 사용할 수 있습니다. 현재 사용자는 <current_user>로 설정합니다.
excludeLabels	[]	주어진 배열의 라벨이 하나도 없는 항목을 반환합니다. 이슈에만 사용할 수 있습니다. 미리 정의된 이름은 대소문자를 구분하지 않습니다.
excludeMilestone	None	주어진 마일스톤 제목을 제외한 항목을 반환합니다. 이슈에만 사용할 수 있습니다.
excludeSearch	None	제목 또는 설명에 검색 키워드가 없는 항목을 반환합니다. 이슈에만 작동합니다.
labels	[]	주어진 배열의 모든 라벨이 있는 항목을 반환합니다. None은 라벨이 없는 항목을 반환합니다. Any는 라벨이 하나 이상 있는 항목을 반환합니다. 미리 정의된 이름은 대소문자를 구분하지 않습니다.
maxResults	20	이 숫자까지의 결과를 반환합니다.
milestone	None	주어진 마일스톤 제목과 일치하는 항목을 반환합니다. None은 마일스톤이 없는 모든 항목을 반환합니다. Any는 마일스톤이 할당된 모든 항목을 반환합니다. 에픽 및 취약점에는 사용할 수 없습니다.
orderBy	created_at	선택한 값으로 정렬된 항목을 반환합니다. 가능한 값: created_at, updated_at, priority, due_date, relative_position, label_priority, milestone_due, popularity, weight. 일부 값은 이슈 전용이고, 일부는 머지 리퀘스트 전용입니다. 자세한 내용은 머지 리퀘스트 목록을 참조하세요.
reviewer	None	주어진 사용자 이름이 리뷰어로 지정된 머지 리퀘스트를 반환합니다. 현재 사용자는 <current_user>로 설정합니다. None은 리뷰어가 없는 항목을 반환합니다. Any는 리뷰어가 있는 항목을 반환합니다.
scope	all	주어진 범위의 항목을 반환합니다. 에픽에는 적용되지 않습니다. 가능한 값: assigned_to_me, created_by_me, all.
search	None	제목 및 설명에 주어진 검색어가 포함된 항목을 반환합니다.
searchIn	all	excludeSearch 속성의 범위를 주어진 값으로 제한한 결과를 반환합니다. 가능한 값: all, title, description. 이슈에만 작동합니다.
sort	desc	이슈를 오름차순 또는 내림차순으로 정렬하여 반환합니다. 가능한 값: asc, desc.
state	opened	모든 이슈 또는 특정 상태와 일치하는 이슈만 반환합니다. 가능한 값: all, opened, closed.
updatedAfter	None	주어진 날짜 이후에 업데이트된 항목을 반환합니다.
updatedBefore	None	주어진 날짜 이전에 업데이트된 항목을 반환합니다.

취약점 보고서 쿼리에 지원되는 파라미터#

취약점 보고서는 다른 항목 유형과 공통 쿼리 파라미터를 공유하지 않습니다. 이 테이블에 나열된 각 파라미터는 취약점 보고서에만 작동하며, 모든 파라미터는 선택 사항입니다:

파라미터	기본값	설명
confidenceLevels	all	주어진 신뢰 수준의 취약점을 반환합니다. 가능한 값: undefined, ignore, unknown, experimental, low, medium, high, confirmed.
reportTypes	None	주어진 보고서 유형의 취약점을 반환합니다. 가능한 값: sast, dast, dependency_scanning, container_scanning.
scope	dismissed	주어진 범위의 취약점을 반환합니다. 가능한 값: all, dismissed. 자세한 내용은 취약점 결과 API를 참조하세요.
severityLevels	all	주어진 심각도 수준의 취약점을 반환합니다. 가능한 값: undefined, info, unknown, low, medium, high, critical.