히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

고객 관계 관리(CRM)를 사용하면 연락처(개인)와 조직(회사)의 레코드를 만들고 이를 작업 항목과 연결할 수 있습니다.

기본적으로 연락처와 조직은 최상위 그룹에서만 만들 수 있습니다. 다른 그룹에서 연락처와 조직을 만들려면 해당 그룹을 연락처 소스로 지정합니다.

연락처와 조직을 사용해 청구 및 보고 목적으로 업무를 고객과 연결할 수 있습니다. 향후 계획에 대한 자세한 내용은 이슈 2256을 참고합니다.

권한#

고객 관계 관리(CRM) 활성화#

고객 관계 관리 기능은 그룹 단위로 켭니다. 하위 그룹에서 CRM 기능을 사용하려면 해당 하위 그룹에서도 기능을 켜야 합니다.

그룹 또는 하위 그룹에서 고객 관계 관리를 켜려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹 또는 하위 그룹을 찾습니다.
2. Settings > General을 선택합니다.
3. Permissions and group features를 확장합니다.
4. Customer relations is enabled를 선택합니다.
5. Save changes를 선택합니다.

연락처 소스 구성#

히스토리

• GitLab 17.6에서 사용할 수 있습니다.

기본적으로 연락처는 작업 항목의 최상위 그룹에서 가져옵니다.

그룹의 연락처 소스는 연락처 소스가 따로 구성되지 않은 한 모든 하위 그룹에 적용됩니다.

그룹 또는 하위 그룹의 연락처 소스를 구성하려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹 또는 하위 그룹을 찾습니다.
2. Settings > General을 선택합니다.
3. Permissions and group features를 확장합니다.
4. Contact source > Search for a group을 선택합니다.
5. 연락처를 가져올 그룹을 선택합니다.
6. Save changes를 선택합니다.

연락처#

그룹에 연결된 연락처 보기#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

그룹의 연락처를 보려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.

연락처 만들기#

사전 요구 사항:

• 그룹에 대한 Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

연락처를 만들려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. New contact를 선택합니다.
4. 필수 필드를 모두 입력합니다.
5. Create new contact를 선택합니다.

GraphQL API 로도 연락처를 만들 수 있습니다.

연락처 편집#

사전 요구 사항:

• 그룹에 대한 Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

기존 연락처를 편집하려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 편집할 연락처 옆에서 Edit (✏️)를 선택합니다.
4. 필요한 필드를 수정합니다.
5. Save changes를 선택합니다.

GraphQL API 로도 연락처를 편집할 수 있습니다.

연락처 상태 변경#

각 연락처는 다음 두 가지 상태 중 하나입니다:

• Active: 이 상태의 연락처는 작업 항목에 추가할 수 있습니다.
• Inactive: 이 상태의 연락처는 작업 항목에 추가할 수 없습니다.

연락처의 상태를 변경하려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 편집할 연락처 옆에서 Edit (✏️)를 선택합니다.
4. Active 체크박스를 선택하거나 선택 해제합니다.
5. Save changes를 선택합니다.

조직#

조직 보기#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

그룹의 조직을 보려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 오른쪽 위에서 Organizations를 선택합니다.

조직 만들기#

사전 요구 사항:

• 그룹에 대한 Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

조직을 만들려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 오른쪽 위에서 Organizations를 선택합니다.
4. New organization을 선택합니다.
5. 필수 필드를 모두 입력합니다.
6. Create new organization을 선택합니다.

GraphQL API 로도 조직을 만들 수 있습니다.

조직 편집#

사전 요구 사항:

• 그룹에 대한 Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

기존 조직을 편집하려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 오른쪽 위에서 Organizations를 선택합니다.
4. 편집할 조직 옆에서 Edit (✏️)를 선택합니다.
5. 필요한 필드를 수정합니다.
6. Save changes를 선택합니다.

GraphQL API 로도 조직을 편집할 수 있습니다.

티켓#

Service Desk를 사용해 이메일로 티켓을 만들면, 티켓은 이메일의 발신자와 참조에 있는 이메일 주소와 일치하는 연락처에 연결됩니다.

연락처에 연결된 작업 항목 보기#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

연락처의 작업 항목을 보려면 작업 항목 사이드바에서 연락처를 선택하거나, 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 작업 항목을 확인할 연락처 옆에서 View work items ([work-items])를 선택합니다.

조직에 연결된 작업 항목 보기#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

조직의 작업 항목을 보려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Customer relations를 선택합니다.
3. 오른쪽 위에서 Organizations를 선택합니다.
4. 작업 항목을 확인할 조직 옆에서 View work items ([work-items])를 선택합니다.

작업 항목에 연결된 연락처 보기#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

작업 항목에 연결된 연락처는 오른쪽 사이드바에서 확인할 수 있습니다.

연락처의 상세 정보를 보려면 연락처 이름 위에 마우스를 올립니다.

GraphQL API 로도 작업 항목 연락처를 확인할 수 있습니다.

작업 항목에 연락처 추가#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

작업 항목에 활성 연락처를 추가하려면 /add_contacts 퀵 액션과 [contact:address@example.com]을 함께 사용합니다.

GraphQL API 로도 작업 항목 연락처를 추가, 제거, 교체할 수 있습니다.

작업 항목에서 연락처 제거#

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

작업 항목에서 연락처를 제거하려면 /remove_contacts 퀵 액션과 [contact:address@example.com]을 함께 사용합니다.

GraphQL API 로도 작업 항목 연락처를 추가, 제거, 교체할 수 있습니다.

연락처 자동 완성#

/add_contacts 퀵 액션을 사용할 때 뒤에 [contact:를 입력하면 활성 연락처 자동 완성 목록이 나타납니다:

/add_contacts [contact:

/remove_contacts 퀵 액션을 사용할 때 뒤에 [contact:를 입력하면 작업 항목에 추가된 연락처의 자동 완성 목록이 나타납니다:

/remove_contacts [contact:

CRM 항목이 있는 개체 이동#

작업 항목이나 프로젝트를 이동하면 결과는 상위 그룹의 연락처 소스에 따라 달라집니다:

• 소스가 동일하면 작업 항목은 연락처를 유지합니다.
• 소스가 달라지면 작업 항목은 연락처를 잃습니다.

연락처 소스가 구성된 그룹을 이동하거나 연락처 소스가 그대로인 경우, 작업 항목은 연락처를 유지합니다.

그룹을 이동해 연락처 소스가 바뀌는 경우:

• 중복되지 않는 모든 연락처와 조직이 새 최상위 그룹으로 마이그레이션됩니다.
• 이미 존재하는 연락처는(이메일 주소 기준) 중복으로 간주되어 삭제됩니다.
• 이미 존재하는 조직은(이름 기준) 중복으로 간주되어 삭제됩니다.
• 모든 작업 항목은 연락처를 유지하거나, 동일한 이메일 주소를 가진 연락처를 가리키도록 업데이트됩니다.

새 최상위 그룹에서 연락처와 조직을 만들 권한이 없으면 그룹 이전이 실패합니다.