Windows 7의 오류 메시지

참고

이 디자인 가이드는 Windows 7용으로 만들어졌으며 최신 버전의 Windows용으로 업데이트되지 않았습니다. 지침의 대부분은 여전히 원칙으로 적용되지만 프레젠테이션 및 예제에는 현재 디자인 지침이 반영되지 않습니다.

Windows 7의 오류 메시지는 이미 발생한 문제를 사용자에게 경고합니다. 반면 경고 메시지는 사용자에게 나중에 문제를 일으킬 수 있는 조건을 경고합니다. 모달 대화 상자, 현재 위치 메시지, 알림 또는 풍선을 사용하여 오류 메시지를 표시할 수 있습니다.

일반적인 모달 오류 메시지입니다.

효과적인 오류 메시지는 사용자에게 문제가 발생했음을 알리고, 문제가 발생한 이유를 설명하고, 사용자가 문제를 해결할 수 있도록 솔루션을 제공합니다. 사용자는 작업을 수행하거나 오류 메시지의 결과로 동작을 변경해야 합니다.

잘 작성된 유용한 오류 메시지는 양질의 사용자 환경에 매우 중요합니다. 잘못 작성된 오류 메시지는 제품 만족도가 낮으며 피할 수 있는 기술 지원 비용의 주요 원인입니다. 불필요한 오류 메시지는 사용자의 흐름을 중단합니다.

참고:대화 상자, 경고 메시지, 확인, 표준 아이콘, 알림 및 레이아웃 과 관련된 지침은 별도의 문서에 제공됩니다.

올바른 사용자 인터페이스인가요?

결정하기 전에 다음 사항을 고려합니다.

• 사용자 인터페이스(UI)가 이미 발생한 문제를 표시하고 있나요? 그렇지 않은 경우 메시지는 오류가 아닙니다. 사용자가 나중에 문제를 일으킬 수 있는 조건에 대해 경고를 받는 경우 경고 메시지를 사용합니다.
• 혼동을 일으키지 않고 문제를 방지할 수 있나요? 그렇다면 대신 문제를 방지합니다. 예를 들어 오류 메시지가 필요할 수 있는 제한되지 않은 컨트롤을 사용하는 대신 유효한 값으로 제한된 컨트롤을 사용합니다. 또한 클릭할 때 컨트롤을 사용하지 않도록 설정하면 컨트롤이 비활성화된 이유가 분명하기만 하면 오류가 발생합니다.
• 문제를 자동으로 수정할 수 있나요? 이 경우 문제를 처리하고 오류 메시지를 표시하지 않습니다.
• 사용자가 메시지의 결과로 작업을 수행하거나 동작을 변경할 가능성이 있나요? 그렇지 않은 경우 조건은 사용자 중단을 정당화하지 않으므로 오류를 표시하지 않는 것이 좋습니다.
• 사용자가 다른 프로그램을 적극적으로 사용하는 경우 문제가 관련되나요? 그렇다면 알림 영역 아이콘을 사용하여 문제를 표시하는 것이 좋습니다.
• 문제가 현재 사용자 활동과 관련이 없고, 즉각적인 사용자 작업이 필요하지 않으며, 사용자가 자유롭게 무시할 수 있나요? 그렇다면 작업 실패 알림을 대신 사용합니다.
• 이 문제는 기본 창 내 백그라운드 작업의 상태 관련됩니까? 그렇다면 상태 막대를 사용하여 문제를 표시하는 것이 좋습니다.
• 주요 대상 사용자 IT 전문가인가요? 그렇다면 로그 파일 항목 또는 전자 메일 경고와 같은 대체 피드백 메커니즘을 사용하는 것이 좋습니다. IT 전문가는 중요하지 않은 정보에 로그 파일을 사용하는 것이 좋습니다.

설계 개념

잘못된 오류 메시지의 특성

많은 성가신, 도움이되지 않는, 잘못 작성 된 오류 메시지가 있다는 것은 놀라운 일이 아니다. 또한 오류 메시지는 모달 대화 상자를 사용하여 표시되는 경우가 많기 때문에 사용자의 현재 활동을 중단하고 사용자가 계속 진행할 수 있도록 허용하기 전에 승인해야 합니다.

문제의 일부는 잘못 할 수있는 많은 방법이 있다는 것입니다. 오류 메시지 회관의 다음 예제를 고려합니다.

불필요한 오류 메시지

잘못된 예:

Windows XP의 이 예제는 최악의 오류 메시지일 수 있습니다. 이는 Windows 자체가 종료 중이기 때문에 프로그램을 시작할 수 없다는 것을 나타냅니다. 사용자가 이에 대해 수행할 수 있는 작업이나 이 작업을 수행하려는 작업은 없습니다(결국 사용자가 Windows를 종료하도록 선택). 이 오류 메시지를 표시하면 Windows에서 자체 종료를 방지할 수 있습니다.

문제: 오류 메시지 자체가 문제입니다. 오류 메시지를 해제하는 것 외에도 사용자가 수행할 작업은 없습니다.

주요 원인: 사용자의 목표 또는 관점에 관계없이 모든 오류 사례를 보고합니다.

권장되는 대안: 사용자가 신경 쓰지 않는 오류를 보고하지 마세요.

"성공" 오류 메시지

잘못된 예:

이 오류 메시지는 사용자가 프로그램 제거 직후 Windows를 다시 시작하지 않기로 결정하여 발생했습니다. 프로그램 제거가 사용자의 관점에서 성공적으로 수행되었습니다.

문제: 사용자의 관점에서 오류가 없습니다. 오류 메시지를 해제하는 것 외에도 사용자가 수행할 작업은 없습니다.

주요 원인: 사용자의 관점에서 작업이 성공적으로 완료되었지만 제거 프로그램의 관점에서 실패했습니다.

권장되는 대안: 사용자가 허용 가능한 것으로 간주하는 조건에 대한 오류를 보고하지 마세요.

완전히 쓸모없는 오류 메시지

잘못된 예:

사용자는 오류가 있다는 것을 알게 되지만 오류가 무엇인지 또는 어떻게 해야 할지 전혀 알지 못합니다. 그리고 아니, 그것은 괜찮지 않다!

문제: 오류 메시지는 특정 문제를 제공하지 않으며 사용자가 수행할 수 있는 작업은 없습니다.

주요 원인: 대부분의 경우 프로그램에 잘못된 오류 처리가 있습니다.

권장되는 대안: 프로그램에 대한 적절한 오류 처리를 디자인합니다.

이해할 수 없는 오류 메시지

잘못된 예:

이 예제에서 문제 설명은 명확하지만 추가 설명은 완전히 당황스럽습니다.

문제: 문제 설명 또는 해결 방법은 이해할 수 없습니다.

주요 원인: 사용자 대신 코드의 관점에서 문제를 설명합니다.

권장되는 대안: 대상 사용자가 쉽게 이해할 수 있는 오류 메시지 텍스트를 작성합니다. 사용자가 실제로 수행할 수 있는 솔루션을 제공합니다. 프로그램의 오류 메시지 환경을 디자인해도 프로그래머가 오류 메시지를 바로 작성할 수 없습니다.

과도하게 커밋되는 오류 메시지

잘못된 예:

이 예제에서 오류 메시지는 분명히 모든 문제 해결 단계를 설명하려고 시도합니다.

문제: 너무 많은 정보.

주요 원인: 너무 많은 세부 정보를 제공하거나 오류 메시지 내에서 복잡한 문제 해결 프로세스를 설명하려고 합니다.

권장되는 대안: 불필요한 세부 정보를 방지합니다. 또한 문제 해결사를 사용하지 마십시오. 문제 해결사에 필요한 경우 가장 가능성이 높은 솔루션에 집중하고 도움말의 적절한 항목에 연결하여 나머지를 설명합니다.

불필요하게 가혹한 오류 메시지

잘못된 예:

개체를 찾을 수 없는 프로그램의 무능력은 거의 치명적으로 들리지 않습니다. 그리고 그것이 치명적이라고 가정하면, 왜 응답이 괜찮습니까?

문제: 이 프로그램의 어조는 불필요하게 가혹하거나 극적입니다.

주요 원인: 문제는 프로그램의 관점에서 치명적인 것처럼 보이는 버그 때문입니다.

권장되는 대안: 사용자의 관점에 따라 언어를 신중하게 선택합니다.

사용자를 블레임 오류 메시지

잘못된 예:

사용자가 범죄자처럼 느껴지는 이유는 무엇인가요?

문제: 오류 메시지는 사용자가 오류를 발생시키는 것을 비난하는 방식으로 표현됩니다.

주요 원인: 문제 대신 사용자의 동작에 초점을 맞춘 둔감한 관용구입니다.

권장되는 대안: 필요에 따라 수동 음성을 사용하여 문제를 일으킨 사용자 작업이 아닌 문제에 집중합니다.

바보 같은 오류 메시지

잘못된 예:

이 예제에서 문제 설명은 매우 아이러니하며 솔루션이 제공되지 않습니다.

문제: silly 또는 non-sequitors인 오류 메시지 문입니다.

주요 원인: 컨텍스트에 주의를 기울이지 않고 오류 메시지를 만듭니다.

권장되는 대안: 작성자가 오류 메시지를 만들고 검토합니다. 오류를 검토할 때 컨텍스트 및 사용자의 마음 상태를 고려합니다.

프로그래머 오류 메시지

잘못된 예:

이 예제에서 오류 메시지는 프로그램에 버그가 있음을 나타냅니다. 이 오류 메시지는 프로그래머에게만 의미가 있습니다.

문제: 프로그램 개발자가 버그를 찾는 데 도움이 되는 메시지는 프로그램의 릴리스 버전에 남아 있습니다. 이러한 오류 메시지는 사용자에게 의미나 값이 없습니다.

주요 원인: 프로그래머는 일반 UI를 사용하여 자신에게 메시지를 만듭니다.

권장되는 대안: 개발자는 제품의 릴리스 버전에서 자동으로 제거되도록 이러한 모든 메시지를 조건부로 컴파일해야 합니다. 사용자만 프로그래머이기 때문에 이러한 오류를 사용자가 이해할 수 있게 만드는 데 시간을 낭비하지 마세요.

잘못 표시되는 오류 메시지

잘못된 예:

이 예제에는 많은 일반적인 프레젠테이션 실수가 있습니다.

문제: 오류 메시지 프레젠테이션에서 모든 세부 정보를 잘못 가져옵니다.

주요 원인: 오류 메시지 지침을 모르고 적용합니다. 기록기와 편집기를 사용하여 오류 메시지를 만들고 검토하지 않습니다.

오류 처리의 특성은 이러한 실수 중 많은 부분을 쉽게 만들 수 있다는 것입니다. 대부분의 오류 메시지가 수치의 전당 후보가 될 수 있다는 것을 깨닫는 것은 불안합니다.

좋은 오류 메시지의 특성

이전의 잘못된 예제와 달리 좋은 오류 메시지에는 다음이 있습니다.

• 문제입니다. 문제가 발생했음을 명시합니다.
• 원인입니다. 문제가 발생한 이유를 설명합니다.
• 솔루션). 사용자가 문제를 해결할 수 있도록 솔루션을 제공합니다.

또한 다음과 같은 방식으로 좋은 오류 메시지가 표시됩니다.

• 관련. 이 메시지는 사용자가 관심을 갖는 문제를 표시합니다.
• 실용적인. 사용자는 메시지의 결과로 작업을 수행하거나 동작을 변경해야 합니다.
• 사용자 중심입니다. 이 메시지는 코드가 불만족한 것이 아니라 대상 사용자 작업 또는 목표 측면에서 문제를 설명합니다.
• 간단한. 메시지는 가능한 한 짧지만 더 짧지는 않습니다.
• 명확한. 메시지는 일반 언어를 사용하여 대상 사용자가 문제 및 솔루션을 쉽게 이해할 수 있도록 합니다.
• 구체적. 이 메시지는 특정 언어를 사용하여 관련된 개체의 특정 이름, 위치 및 값을 제공하는 문제를 설명합니다.
• 정중함. 사용자는 비난하거나 바보 같은 느낌을 해서는 안됩니다.
• 매우 드물게 발생합니다. 자주 표시되지 않습니다. 자주 표시되는 오류 메시지는 잘못된 디자인의 징후입니다.

이러한 특성을 갖도록 오류 처리 환경을 설계하여 프로그램의 오류 메시지를 오류 메시지 창에서 제외할 수 있습니다.

불필요한 오류 메시지 방지

가장 좋은 오류 메시지는 오류 메시지가 없는 경우가 많습니다. 더 나은 디자인을 통해 많은 오류를 방지할 수 있으며 오류 메시지에 대한 더 나은 대안이 있는 경우가 많습니다. 일반적으로 오류를 보고하는 것보다 오류를 방지하는 것이 좋습니다.

피해야 할 가장 명백한 오류 메시지는 실행 불가능한 오류 메시지입니다. 사용자가 아무 작업이나 변경 없이 메시지를 해제할 가능성이 있는 경우 오류 메시지를 생략합니다.

일부 오류 메시지는 사용자의 관점에서 문제가 되지 않으므로 제거할 수 있습니다. 예를 들어 사용자가 이미 삭제 중인 파일을 삭제하려고 했다고 가정해 보겠습니다. 이는 코드의 관점에서 예기치 않은 경우일 수 있지만 원하는 결과가 달성되었기 때문에 사용자는 이 오류를 오류로 간주하지 않습니다.

잘못된 예:

사용자의 관점에서 작업이 성공했기 때문에 이 오류 메시지를 제거해야 합니다.

또 다른 예제에서는 사용자가 작업을 명시적으로 취소한다고 가정합니다. 사용자의 관점에서 다음 조건은 오류가 아닙니다.

잘못된 예:

사용자의 관점에서 작업이 성공했기 때문에 이 오류 메시지도 제거해야 합니다.

기술 대신 사용자의 목표에 집중하여 오류 메시지를 제거할 수 있는 경우가 있습니다. 이렇게 하면 오류가 실제로 무엇인지 다시 생각해 찾습니다. 사용자의 목표에 문제가 있나요, 아니면 프로그램의 목표 충족 능력과 관련이 있나요? 실제 환경에서 사용자의 동작이 타당하다면 소프트웨어에서도 의미가 있어야 합니다.

예를 들어 전자 상거래 프로그램 내에서 사용자가 검색을 사용하여 제품을 찾으려고 하지만 리터럴 검색 쿼리에 일치하는 항목이 없고 원하는 제품이 품절된 경우를 가정해 보겠습니다. 기술적으로 이것은 오류이지만 오류 메시지를 제공하는 대신 프로그램에서 다음을 수행할 수 있습니다.

• 쿼리와 가장 일치하는 제품을 계속 검색합니다.
• 검색에 명백한 실수가 있는 경우 수정된 쿼리를 자동으로 권장합니다.
• 맞춤법 오류, 대체 맞춤법, 다원화 및 동사 불일치와 같은 일반적인 문제를 자동으로 처리합니다.
• 제품이 재고가 될 시기를 나타냅니다.

사용자의 요청이 합리적인 경우 잘 설계된 전자 상거래 프로그램은 오류가 아닌 합리적인 결과를 반환해야 합니다.

오류 메시지를 방지하는 또 다른 좋은 방법은 처음에 문제를 방지하는 것입니다. 다음을 통해 오류를 방지할 수 있습니다.

• 제한된 컨트롤 사용. 유효한 값으로 제한되는 컨트롤을 사용합니다. 목록, 슬라이더, 검사 상자, 라디오 단추, 날짜 및 시간 선택기와 같은 컨트롤은 유효한 값으로 제한되지만 텍스트 상자는 그렇지 않고 오류 메시지가 필요할 수 있습니다. 그러나 특정 문자만 허용하고 최대 문자 수를 허용하도록 텍스트 상자를 제한할 수 있습니다.
• 제한된 상호 작용 사용. 끌기 작업의 경우 사용자가 유효한 대상에만 놓을 수 있도록 허용합니다.
• 비활성화된 컨트롤 및 메뉴 항목 사용 컨트롤 또는 메뉴 항목이 비활성화된 이유를 사용자가 쉽게 추론할 수 있는 경우 컨트롤 및 메뉴 항목을 사용하지 않도록 설정합니다.
• 좋은 기본값을 제공합니다. 사용자가 기본값을 수락할 수 있는 경우 입력 오류가 발생할 가능성이 적습니다. 사용자가 값을 변경하기로 결정하더라도 기본값을 통해 사용자는 예상 입력 형식을 알 수 있습니다.
• 일을 그냥 작동. 작업이 불필요하거나 자동으로 수행되는 경우 사용자가 실수를 할 가능성이 적습니다. 또는 사용자가 작은 실수를 하지만 의도가 명확하면 문제가 자동으로 해결됩니다. 예를 들어 사소한 서식 문제를 자동으로 수정할 수 있습니다.

필요한 오류 메시지 제공

경우에 따라 오류 메시지를 제공해야 하는 경우가 있습니다. 사용자가 실수를 하고, 네트워크 및 디바이스가 작동을 중지하고, 개체를 찾거나 수정할 수 없고, 작업을 완료할 수 없으며, 프로그램에 버그가 있습니다. 이상적으로 이러한 문제는 자주 발생하지 않습니다. 예를 들어 다양한 유형의 사용자 실수를 방지하기 위해 소프트웨어를 설계할 수 있지만 이러한 모든 문제를 방지하는 것은 현실적이지 않습니다. 그리고 이러한 문제 중 하나가 발생하면 유용한 오류 메시지가 사용자를 신속하게 다시 받습니다.

일반적인 믿음은 오류 메시지가 최악의 사용자 환경이며 모든 비용을 피해야 한다는 것입니다. 그러나 사용자 혼란이 최악의 환경이며 모든 비용을 피해야 한다고 말하는 것이 더 정확합니다. 경우에 따라 해당 비용이 유용한 오류 메시지입니다.

사용 안 함 컨트롤을 고려합니다. 대부분의 경우 컨트롤이 비활성화된 이유가 분명하므로 컨트롤을 사용하지 않도록 설정하는 것이 오류 메시지를 방지하는 좋은 방법입니다. 그러나 컨트롤을 사용하지 않도록 설정한 이유가 명확하지 않으면 어떻게 해야 할까요? 사용자는 계속 진행할 수 없으며 문제를 확인할 피드백이 없습니다. 이제 사용자가 중단되어 문제를 추론하거나 기술 지원을 받아야 합니다. 이러한 경우 컨트롤을 사용하도록 설정하고 대신 유용한 오류 메시지를 제공하는 것이 훨씬 낫습니다.

잘못된 예:

여기서 다음 단추를 사용하지 않도록 설정한 이유는 무엇인가요? 유용한 오류 메시지를 제공하여 사용하도록 설정하고 사용자 혼동을 방지하는 것이 좋습니다.

오류 메시지를 제공해야 하는지 확실하지 않은 경우 먼저 줄 수 있는 오류 메시지를 작성합니다. 사용자가 작업을 수행하거나 결과적으로 동작을 변경할 가능성이 있는 경우 오류 메시지를 제공합니다. 반면 사용자가 아무 작업이나 변경 없이 메시지를 해제할 가능성이 있는 경우 오류 메시지를 생략합니다.

적절한 오류 처리를 위한 디자인

좋은 오류 메시지 텍스트를 만드는 것은 어려울 수 있지만 프로그램에서 좋은 오류 처리 지원을 사용하지 않으면 불가능한 경우도 있습니다. 다음 오류 메시지를 고려합니다.

잘못된 예:

프로그램의 오류 처리 지원이 부족하기 때문에 문제가 실제로 알 수 없는 것일 수 있습니다.

이는 매우 잘못 작성된 오류 메시지일 수 있지만, 문제에 대해 알려진 특정 정보가 없는 기본 코드에 의한 좋은 오류 처리가 부족하다는 것을 반영할 가능성이 큽니다.

실행 가능한 특정 사용자 중심 오류 메시지를 만들려면 프로그램의 오류 처리 코드에서 특정 수준 오류 정보를 제공해야 합니다.

• 각 문제에는 고유한 오류 코드가 할당되어 있어야 합니다.
• 문제가 여러 가지 원인이 있는 경우 프로그램은 가능한 한 특정 원인을 결정해야 합니다.
• 문제에 매개 변수가 있는 경우 매개 변수를 유지 관리해야 합니다.
• 사용자의 관점에서 오류 메시지를 표시할 수 있도록 충분히 높은 수준에서 하위 수준 문제를 처리해야 합니다.

좋은 오류 메시지는 단지 UI 문제가 아니라 소프트웨어 디자인 문제입니다. 좋은 오류 메시지 환경은 나중에 압정할 수 있는 것이 아닙니다.

문제 해결(및 방지 방법)

여러 가지 원인에 대한 문제가 단일 오류 메시지와 함께 보고되는 경우의 문제 해결 결과입니다.

잘못된 예:

올바름:

단일 오류 메시지와 함께 여러 문제가 보고되는 경우의 문제 해결 결과입니다.

다음 예제에서는 항목이 이미 이동 또는 삭제되었거나 액세스가 거부되어 항목을 이동할 수 없습니다. 프로그램에서 원인을 쉽게 확인할 수 있는 경우 특정 원인을 파악하기 위해 사용자에게 부담을 주세요.

잘못된 예:

글쎄, 그것은 무엇입니까? 이제 사용자가 문제를 해결해야 합니다.

프로그램에서 액세스가 거부되었는지 확인할 수 있으므로 특정 오류 메시지와 함께 이 문제를 보고해야 합니다.

올바름:

특정 원인으로 인해 문제 해결이 필요하지 않습니다.

특정 원인을 확인할 수 없는 경우에만 여러 원인이 있는 메시지를 사용합니다. 이 예제에서는 프로그램에서 항목이 이동 또는 삭제되었는지 확인하기 어렵기 때문에 여러 원인이 있는 단일 오류 메시지가 여기에 사용될 수 있습니다. 그러나 예를 들어 삭제된 파일을 이동할 수 없는 경우 사용자가 신경 쓰지 않을 가능성이 낮습니다. 이러한 원인의 경우 오류 메시지도 필요하지 않습니다.

알 수 없는 오류 처리

어떤 경우에는 문제, 원인 또는 솔루션을 진정으로 알 수 없습니다. 오류를 표시하지 않는 것이 현명하지 않은 경우 옳지 않을 수 있는 문제, 원인 또는 해결 방법을 제시하는 것보다 정보 부족에 대해 선행하는 것이 좋습니다.

예를 들어 프로그램에 처리되지 않은 예외가 있는 경우 다음 오류 메시지가 적합합니다.

알 수 없는 오류를 표시할 수 없는 경우 정보 부족에 대해 미리 파악하는 것이 좋습니다.

반면에 대부분의 경우 도움이 될 수 있는 구체적인 실행 가능한 정보를 제공하세요.

이 오류 메시지는 일반적으로 네트워크 연결이 문제인 경우 알 수 없는 오류에 적합합니다.

적절한 메시지 유형 확인

일부 문제는 강조 및 구문에 따라 오류, 경고 또는 정보로 표시될 수 있습니다. 예를 들어 웹 페이지에서 현재 Windows 인터넷 Explorer 구성에 따라 서명되지 않은 ActiveX 컨트롤을 로드할 수 없다고 가정합니다.

• 오류. "이 페이지는 서명되지 않은 ActiveX 컨트롤을 로드할 수 없습니다." (기존 문제로 표현되었습니다.)
• 경고. "Windows Internet Explorer 서명되지 않은 ActiveX 컨트롤을 로드하도록 구성되지 않았으므로 이 페이지가 예상대로 작동하지 않을 수 있습니다." 또는 "이 페이지에서 서명되지 않은 ActiveX 컨트롤을 설치하도록 허용하시겠습니까? 신뢰할 수 없는 원본에서 수행하면 컴퓨터에 해를 끼칠 수 있습니다." (둘 다 향후 문제를 일으킬 수 있는 조건으로 표현되었습니다.)
• 정보. "서명되지 않은 ActiveX 컨트롤을 차단하도록 Windows 인터넷 Explorer 구성했습니다." (사실의 진술로 표현됩니다.)

적절한 메시지 유형을 확인하려면 사용자가 알고 있거나 조치를 취해야 하는 문제의 가장 중요한 측면에 초점을 맞춥니다. 일반적으로 문제가 사용자가 진행하지 못하도록 차단하는 경우 오류로 표시해야 합니다. 사용자가 계속 진행할 수 있으면 경고로 표시합니다. 해당 포커스를 기반으로 기본 명령 또는 기타 해당 텍스트를 만든 다음 텍스트와 일치하는 아이콘(표준 또는 기타)을 선택합니다. 기본 명령 텍스트와 아이콘은 항상 일치해야 합니다.

오류 메시지 프레젠테이션

Windows 프로그램의 대부분의 오류 메시지는 모달 대화 상자를 사용하여 표시되지만(이 문서의 대부분의 예제와 같이) 다른 옵션이 있습니다.

• 현재 위치
• 풍선 도움말
• 공지
• 알림 영역 아이콘
• 상태 표시줄
• 로그 파일(IT 전문가를 대상으로 하는 오류의 경우)

모달 대화 상자에 오류 메시지를 배치하면 사용자의 즉각적인 주의와 승인을 요구할 수 있습니다. 그러나 이러한 주의가 필요하지 않은 경우 이는 주요 단점이기도 합니다.

사용자가 닫기 단추를 클릭할 수 있도록 사용자를 중단해야 합니까? 그렇지 않은 경우 모달 대화 상자 사용에 대한 대안을 고려합니다.

모달 대화 상자는 사용자가 계속하기 직전에 문제를 인정해야 할 때 좋은 선택이지만, 그렇지 않으면 종종 잘못된 선택입니다. 일반적으로 작업을 잘 수행하는 가장 가벼운 가중치 프레젠테이션을 사용하는 것이 좋습니다.

과다 통신 방지

일반적으로 사용자는 읽지 않고 스캔합니다. 텍스트가 많을수록 텍스트를 스캔하기가 더 어려워지고 사용자가 텍스트를 전혀 읽지 않을 가능성이 높습니다. 따라서 텍스트를 필수 항목으로 줄이고 필요한 경우 점진적 공개 및 도움말 링크를 사용하여 추가 정보를 제공하는 것이 중요합니다.

많은 극단적 인 예가 있지만, 한 가지 더 일반적인 살펴보겠습니다. 다음 예제에는 좋은 오류 메시지의 특성이 대부분 있지만 텍스트는 간결하지 않으며 읽기 동기가 필요합니다.

잘못된 예:

이 예제는 좋은 오류 메시지이지만 과도하게 통신합니다.

이 모든 텍스트가 실제로 말하는 것은 무엇입니까? 예를 들면 다음과 같습니다.

올바름:

이 오류 메시지는 기본적으로 동일한 정보를 가지고 있지만 훨씬 더 간결합니다.

도움말을 사용하여 세부 정보를 제공하면 이 오류 메시지에는 반전된 피라미드 스타일의 프레젠테이션이 있습니다.

초과 통신에 대한 자세한 지침 및 예제는 사용자 인터페이스 텍스트를 참조하세요.

8가지 작업을 수행하는 경우

1. 오류 처리를 위해 프로그램을 디자인합니다.
2. 불필요한 오류 메시지를 제공하지 마세요.
3. 필요한 오류 메시지를 제공하여 사용자 혼동을 방지합니다.
4. 오류 메시지가 문제, 원인 및 해결 방법을 제공하는지 확인합니다.
5. 오류 메시지가 관련성이 있고, 실행 가능하고, 짧고, 명확하고, 구체적이고, 정중하며, 드문지 확인합니다.
6. 프로그램의 관점이 아닌 사용자의 관점에서 오류 메시지를 디자인합니다.
7. 사용자가 문제 해결에 참여하지 않도록 하려면 검색 가능한 각 원인에 대해 다른 오류 메시지를 사용합니다.
8. 작업을 잘 수행하는 가장 가벼운 가중치 프레젠테이션 방법을 사용합니다.

사용 패턴

오류 메시지에는 다음과 같은 몇 가지 사용 패턴이 있습니다.

레이블	값
시스템 문제 운영 체제, 하드웨어 디바이스, 네트워크 또는 프로그램이 실패했거나 작업을 수행하는 데 필요한 상태가 아닙니다.	사용자가 많은 시스템 문제를 해결할 수 있습니다. 디바이스를 켜고, 디바이스를 다시 연결하고, 미디어를 삽입하여 디바이스 문제를 해결할 수 있습니다. 네트워크 문제는 실제 네트워크 연결을 확인하고 네트워크 진단 및 복구를 실행하여 해결할 수 있습니다. 프로그램 옵션을 변경하거나 프로그램을 다시 시작하여 프로그램 문제를 해결할 수 있습니다. 이 예제에서는 프로그램에서 사용자 작업을 수행할 카메라를 찾을 수 없습니다. 이 예제에서는 작업을 수행하는 데 필요한 기능을 켜야 합니다.
파일 문제 사용자가 시작한 작업에 필요한 파일 또는 폴더를 찾을 수 없거나, 이미 사용 중이거나, 필요한 형식이 없습니다.	이 예제에서는 파일 또는 폴더를 찾을 수 없으므로 삭제할 수 없습니다. 이 예제에서 프로그램은 지정된 파일 형식을 지원하지 않습니다.
보안 문제 사용자에게 리소스에 액세스할 수 있는 권한이 없거나 사용자가 시작한 작업을 수행할 수 있는 충분한 권한이 없습니다.	이 예제에서는 사용자에게 리소스에 액세스할 수 있는 권한이 없습니다. 이 예제에서는 사용자에게 작업을 수행할 권한이 없습니다.
작업 문제 사용자가 시작한 작업(시스템, 파일을 찾을 수 없음, 파일 형식 또는 보안 문제 이외의)을 수행하는 특정 문제가 있습니다.	이 예제에서는 클립보드 데이터를 그림판에 붙여넣을 수 없습니다. 이 예제에서는 사용자가 소프트웨어 업그레이드를 설치할 수 없습니다.
사용자 입력 문제 사용자가 잘못되었거나 다른 사용자 입력과 일치하지 않는 값을 입력했습니다.	이 예제에서 사용자가 잘못된 시간 값을 입력했습니다. 이 예제에서 사용자 입력은 올바른 형식이 아닙니다.

지침

프레젠테이션

• 적절한 경우 작업 대화 상자를 사용하여 일관된 모양과 레이아웃을 얻을 수 있습니다. 작업 대화 상자에는 Windows Vista 이상이 필요하므로 이전 버전의 Windows에는 적합하지 않습니다. 메시지 상자를 사용해야 하는 경우 기본 지침을 보조 명령과 두 줄 바꿈으로 구분합니다.

사용자 입력 오류

• 가능하면 다음을 수행하여 사용자 입력 오류를 방지하거나 줄입니다.
  • 유효한 값으로 제한되는 컨트롤 사용
  • 컨트롤 및 메뉴 항목을 클릭할 때 사용하지 않도록 설정하면 컨트롤 또는 메뉴 항목이 비활성화된 이유가 분명하기만 하면 오류가 발생합니다.
  • 좋은 기본값을 제공합니다.

잘못된 예:

이 예제에서는 제한된 입력에 제한되지 않은 텍스트 상자가 사용됩니다. 대신 슬라이더를 사용합니다.

• 상황에 맞는 사용자 입력 문제에는 모덜리스 오류 처리(현재 위치 오류 또는 풍선)를 사용합니다.
• 텍스트 상자에서 또는 텍스트 상자에서 포커스가 손실된 직후 감지된 중요하지 않은 단일 지점 사용자 입력 문제에 풍선을 사용합니다.풍선에는 현재 위치 메시지를 표시하는 데 필요한 사용 가능한 화면 공간 또는 동적 레이아웃이 필요하지 않습니다. 한 번에 하나의 풍선만 표시합니다. 문제가 중요하지 않으므로 오류 아이콘이 필요하지 않습니다. 풍선은 클릭할 때, 문제가 해결될 때 또는 시간 제한 후에 사라집니다.

이 예제에서 풍선은 컨트롤에 있는 동안 입력 문제를 나타냅니다.

• 지연된 오류 검색을 위해 현재 위치 오류를 사용합니다 . 일반적으로 커밋 단추를 클릭하여 발견된 오류입니다. (즉시 커밋된 설정에는 현재 위치 오류를 사용하지 마세요.) 한 번에 여러 가지 현재 위치 오류가 있을 수 있습니다. 가능한 경우 일반 텍스트와 16x16 픽셀 오류 아이콘을 사용하여 문제 바로 옆에 배치합니다. 사용자가 커밋하고 다른 오류를 찾을 수 없는 한 현재 위치 오류는 사라지지 않습니다.

이 예제에서는 커밋 단추를 클릭하여 발견된 오류에 대해 현재 위치 오류가 사용됩니다.

• 모달 오류 처리(작업 대화 상자 또는 메시지 상자)는 여러 컨트롤이 관련되거나 커밋 단추를 클릭하여 발견된 비사정적 또는 비입력 오류인 오류를 포함하여 다른 모든 문제에 사용합니다.
• 사용자 입력 문제가 보고되면 입력 포커스를 잘못된 데이터가 있는 첫 번째 컨트롤로 설정합니다. 필요한 경우 컨트롤을 보기로 스크롤합니다. 컨트롤이 텍스트 상자인 경우 전체 내용을 선택합니다. 오류 메시지가 무엇을 참조하는지 항상 분명해야 합니다.
• 잘못된 입력을 지우지 마세요. 대신 사용자가 다시 시작하지 않고 문제를 보고 수정할 수 있도록 그대로 둡니다.
  • 예외: 사용자가 마스킹된 입력을 효과적으로 수정할 수 없으므로 잘못된 암호 및 PIN 텍스트 상자를 지웁니다.

문제 해결

• 문제 해결을 만들지 않습니다. 검색 가능한 여러 원인으로 문제를 보고하기 위해 단일 오류 메시지를 사용하지 마세요.
• 검색 가능한 각 원인에 대해 다른 오류 메시지(일반적으로 다른 추가 지침)를 사용합니다. 예를 들어 여러 가지 이유로 파일을 열 수 없는 경우 각 이유로 별도의 추가 지침을 제공합니다.
• 특정 원인을 확인할 수 없는 경우에만 여러 원인이 있는 메시지를 사용합니다. 이 경우 문제를 해결할 가능성 순서대로 솔루션을 제시합니다. 이렇게 하면 사용자가 문제를 보다 효율적으로 해결할 수 있습니다.

아이콘

• 모달 오류 메시지 대화 상자에 제목 표시줄 아이콘이 없습니다. 제목 표시줄 아이콘은 기본 창과 보조 창 간의 시각적 구별으로 사용됩니다.

• 오류 아이콘을 사용합니다. 예외:

  • 오류가 모달 대화 상자 또는 풍선을 사용하여 표시되는 사용자 입력 문제인 경우 아이콘을 사용하지 마세요. 이렇게 하는 것은 Windows의 고무적인 어조에 반하는 것입니다. 그러나 현재 위치 오류 메시지는 작은 오류 아이콘(16x16 픽셀)을 사용하여 오류 메시지로 명확하게 식별해야 합니다.

    

    

    이러한 예제에서는 사용자 입력 문제에 오류 아이콘이 필요하지 않습니다.

    

    이 예제에서는 오류 메시지를 오류 메시지로 명확하게 식별하려면 현재 위치 오류 메시지에 작은 오류 아이콘이 필요합니다.

• 사용자 입력 문제가 아닌 아이콘이 있는 기능에 문제가 있는 경우 오류 오버레이와 함께 기능 아이콘을 사용할 수 있습니다. 이렇게 하면 기능 이름도 오류의 주체로 사용합니다.

  

  이 예제에서는 기능 아이콘에 오류 오버레이가 있고 기능이 오류의 주체입니다.

• 오류에는 경고 아이콘을 사용하지 마세요. 이 작업은 프레젠테이션이 덜 심각해지도록 하기 위해 수행되는 경우가 많습니다. 오류는 경고가 아닙니다.

  잘못된 예:

  

  이 예제에서는 오류의 심각도가 낮아지도록 경고 아이콘을 잘못 사용합니다.

자세한 지침 및 예제는 표준 아이콘을 참조하세요.

점진적 공개

• 세부 정보 표시/숨기기 점진적 공개 단추를 사용하여 오류 메시지에서 고급 또는 자세한 정보를 숨깁니다. 이렇게 하면 일반적인 사용에 대한 오류 메시지가 간소화됩니다. 사용자가 정보를 찾을 수 없으므로 필요한 정보를 숨기지 마세요.

이 예제에서 점진적 공개 단추를 사용하면 사용자가 원하는 경우 더 자세히 드릴다운하거나 그렇지 않은 경우 UI를 간소화할 수 있습니다.

• 세부 정보가 실제로 없는 한 세부 정보 표시/숨기기를 사용하지 마세요. 기존 정보를 보다 자세한 형식으로 다시 표시하지 마세요.
• 세부 정보 표시/숨기기를 사용하여 도움말 정보를 표시하지 마세요. 대신 도움말 링크를 사용합니다.

레이블 지정 지침은 점진적 공개 제어를 참조하세요.

이 메시지를 다시 표시하지 마세요.

• 오류 메시지에 이 옵션이 필요한 경우 오류 및 빈도를 다시 고려합니다. 적절한 오류의 모든 특성(관련성이 있고 실행 가능하며 드문 경우)이 있는 경우 사용자가 이를 표시하지 않는 것이 합리적이면 안 됩니다.

자세한 지침은 대화 상자를 참조하세요.

기본값

• 가장 안전하거나 파괴적이지 않거나 가장 안전한 응답을 기본값으로 선택합니다. 안전이 요인이 아닌 경우 가장 가능성이 높거나 편리한 명령을 선택합니다.

도움말

• 도움말이 필요하지 않도록 오류 메시지를 디자인합니다. 일반적으로 사용자는 솔루션에 몇 가지 단계가 필요하지 않은 한 문제를 이해하고 해결하기 위해 외부 텍스트를 읽을 필요가 없습니다.
• 도움말 콘텐츠가 관련성이 있고 유용한지 확인합니다. 오류 메시지를 세부 정보로 다시 표시해서는 안 되며 나중에 문제를 방지하는 방법과 같이 오류 메시지의 scope 이외의 유용한 정보를 포함해야 합니다. 가능하기 때문에 도움말 링크를 제공하지 마세요.
• 특정하고 간결하며 관련 도움말 링크를 사용하여 도움말 콘텐츠에 액세스합니다. 이 목적을 위해 명령 단추 또는 점진적 공개를 사용하지 마세요.
• 구체적이고 실행 가능하게 만들 수 없는 오류 메시지의 경우 온라인 도움말 콘텐츠에 대한 링크를 제공하는 것이 좋습니다. 이렇게 하면 프로그램이 릴리스된 후 업데이트할 수 있는 추가 정보를 사용자에게 제공할 수 있습니다.

자세한 지침은 도움말을 참조 하세요.

오류 코드

• 구체적이고 실행 가능하지 않거나 도움말의 이점을 얻을 수 있는 오류 메시지의 경우 오류 코드도 제공하는 것이 좋습니다. 사용자는 종종 이러한 오류 코드를 사용하여 인터넷을 검색하여 추가 정보를 검색합니다.
• 항상 문제 및 솔루션에 대한 텍스트 설명을 제공합니다. 이 목적을 위해 오류 코드에만 의존하지 마세요.

잘못된 예:

이 예제에서는 오류 코드가 솔루션 텍스트 대신 사용됩니다.

• 각 다른 원인에 대해 고유한 오류 코드를 할당합니다. 이렇게 하면 문제 해결이 방지됩니다.
• 인터넷에서 쉽게 검색할 수 있는 오류 코드를 선택합니다. 32비트 코드를 사용하는 경우 선행 "0x" 및 대문자로 16진수 표현을 사용합니다.

올바름:

1234

0xC0001234

잘못된 예:

-1

-67113524

• 세부 정보 표시/숨기기를 사용하여 오류 코드를 표시합니다. 오류 코드로 구: <error code>.

이 예제에서는 오류 코드를 사용하여 추가 정보를 활용할 수 있는 오류 메시지를 보완합니다.

소리

• 소리 효과 또는 경고음과 함께 오류 메시지를 동반하지 마세요. 이렇게 하는 것은 혼란스럽고 불필요합니다.
  • 예외: 문제가 컴퓨터 작동에 중요한 경우 위험 중지 소리 효과를 재생하고, 사용자는 심각한 결과를 방지하기 위해 즉각적인 조치를 취해야합니다.

텍스트

일반

• 중복 텍스트를 제거합니다. 제목, 기본 지침, 추가 지침, 명령 링크 및 커밋 단추에서 찾습니다. 일반적으로 지침 및 대화형 컨트롤에 전체 텍스트를 그대로 두고 다른 위치에서 중복성을 제거합니다.
• 사용자 중심 설명을 사용합니다. 소프트웨어가 불만족하는 것이 아니라 사용자 작업 또는 목표 측면에서 문제를 설명합니다. 대상 사용자가 이해하고 사용하는 언어를 사용합니다. 기술 전문 용어를 사용하지 않습니다.

잘못된 예:

올바름:

이러한 예제에서 올바른 버전은 사용자의 언어를 말하는 반면 잘못된 버전은 지나치게 기술적입니다.

• 다음 단어를 사용하지 마세요.
  • 오류, 실패(대신 문제 사용)
  • 실패함(대신 사용할 수 없음)
  • 불법, 유효하지 않음, 잘못된 항목(대신 잘못된 사용)
  • 중단, 종료, 종료(대신 중지 사용)
  • 치명적, 치명적(대신 심각한 사용)

이러한 용어는 불필요하며 Windows의 고무적인 어조와는 반대입니다. 올바르게 사용하면 오류 아이콘이 문제가 있음을 충분히 알 수 있습니다.

잘못된 예:

올바름:

잘못된 예제에서는 "치명적인" 및 "실패"라는 용어가 필요하지 않습니다.

• 사용자를 비난하거나 사용자 오류를 암시하는 관용구를 사용하지 마세요. 구문에서 사용자와 을 사용하지 마십시오. 활성 음성은 일반적으로 선호되지만 사용자가 주체일 때 수동 음성을 사용하고 활성 음성을 사용한 경우 오류에 대한 비난을 느낄 수 있습니다.

잘못된 예:

올바름:

잘못된 예제는 활성 음성을 사용하여 사용자를 비난합니다.

• 구체적으로 설명합니다. 구문 오류 및 잘못된 작업과 같은 모호한 표현을 피합니다. 관련된 개체의 특정 이름, 위치 및 값을 제공합니다.

잘못된 예:

파일을 찾을 수 없습니다.

디스크가 꽉 찼습니다.

값이 범위를 벗어났습니다.

문자가 잘못되었습니다.

디바이스를 사용할 수 없습니다.

이러한 문제는 특정 이름, 위치 및 값으로 훨씬 쉽게 해결할 수 있습니다.

• 구체적으로 설명하려는 경우 가능성이 낮은 문제, 원인 또는 솔루션을 제공하지 마세요. 문제, 원인 또는 해결 방법이 옳지 않으면 제공하지 마세요. 예를 들어 부정확할 수 있는 오류보다 알 수 없는 오류가 발생했다고 말하는 것이 좋습니다.
• 사용자에게 불편한 작업(예: 대기 중)을 수행하라는 메시지가 표시되거나 소프트웨어가 상황을 블레임 경우를 제외하고는 "제발"이라는 단어를 사용하지 마세요.

올바름:

Windows에서 파일을 컴퓨터에 복사하는 동안 잠시 기다려 주세요.

• 사용자에게 심각한 문제를 초래하는 오류 메시지(예: 데이터 손실 또는 컴퓨터를 사용할 수 없음)에서만 "sorry"라는 단어를 사용합니다. 프로그램의 정상적인 작동 중에 문제가 발생한 경우(예: 사용자가 네트워크 연결을 찾을 때까지 기다려야 하는 경우) 사과하지 마세요.

올바름:

죄송합니다. 하지만 Fabrikam Backup에서 복구할 수 없는 문제를 감지하고 컴퓨터의 파일을 보호하기 위해 종료되었습니다.

• 짧은 이름을 사용하여 제품을 참조하세요. 전체 제품 이름 또는 상표 기호를 사용하지 마세요. 사용자가 회사 이름을 제품과 연결하지 않는 한 회사 이름을 포함하지 마세요. 프로그램 버전 번호를 포함하지 마세요.

잘못된 예:

올바름:

잘못된 예제에서는 전체 제품 이름 및 상표 기호가 사용됩니다.

• 개체 이름 주위에 큰따옴표를 사용합니다. 이렇게 하면 텍스트를 더 쉽게 구문 분석하고 잠재적으로 당황스러운 문을 방지할 수 있습니다.
  • 예외: 정규화된 파일 경로, URL 및 도메인 이름은 큰따옴표로 묶을 필요가 없습니다.

올바름:

이 예제에서는 개체 이름이 따옴표가 아닌 경우 오류 메시지가 혼동됩니다.

• 개체 이름으로 문장을 시작하지 마세요. 이렇게 하면 구문 분석하기가 어려운 경우가 많습니다.
• 느낌표나 단어를 모든 대문자로 사용하지 마세요. 느낌표와 대문자는 사용자에게 소리를 지르는 것처럼 느껴집니다.

자세한 지침 및 예제는 스타일 및 톤을 참조하세요.

제목

• 제목을 사용하여 오류가 발생한 명령 또는 기능을 식별합니다. 예외:
  • 여러 다른 명령으로 오류가 표시되는 경우 프로그램 이름을 대신 사용하는 것이 좋습니다.
  • 해당 타이틀이 중복되거나 기본 명령과 혼동되는 경우 프로그램 이름을 대신 사용합니다.
• 제목을 사용하여 기본 명령의 목적인 문제를 설명하거나 요약하지 마세요.

잘못된 예:

이 예제에서는 제목이 문제를 설명하는 데 잘못 사용되고 있습니다.

• 문장 부호를 끝내지 않고 제목 스타일 대문자를 사용합니다.

주 지침

• 기본 명령을 사용하여 명확하고 일반적인 특정 언어로 문제를 설명합니다.
• 단 하나의 완전한 문장만 간결하게 사용해야 합니다. 기본 지침을 필수 정보로 구문 분석합니다. 프로그램 또는 사용자인 경우 제목을 암시적으로 그대로 둘 수 있습니다. 간결하게 수행할 수 있는 경우 문제의 이유를 포함합니다. 자세히 설명해야 하는 경우 추가 지침을 사용합니다.

잘못된 예:

이 예제에서는 전체 오류 메시지가 기본 명령에 포함되므로 읽기가 어렵습니다.

• 관련된 개체가 있는지 구체적으로 지정하고 이름을 지정합니다.
• 기본 명령에 전체 파일 경로 및 URL을 배치하지 마세요. 대신 짧은 이름(예: 파일 이름)을 사용하고 전체 이름(예: 파일 경로)을 추가 지침에 넣습니다. 그러나 오류 메시지에 추가 지침이 필요하지 않은 경우 기본 명령에 단일 전체 파일 경로 또는 URL을 넣을 수 있습니다.

이 예제에서는 파일 이름만 기본 명령에 있습니다. 전체 경로는 추가 지침에 있습니다.

• 컨텍스트에서 명백한 경우 전체 파일 경로 및 URL을 전혀 제공하지 마세요.

이 예제에서는 사용자가 Windows Explorer 파일의 이름을 변경합니다. 이 경우 컨텍스트에서 명확하기 때문에 전체 파일 경로가 필요하지 않습니다.

• 가능하면 언제든지 현재 시제를 사용합니다.
• 문장 스타일의 대문자를 사용합니다.
• 명령이 문인 경우 최종 기간을 포함하지 마세요. 명령이 질문인 경우 최종 물음표를 포함합니다.

기본 명령 템플릿

구문에 대한 엄격한 규칙은 없지만 가능한 경우 다음 기본 명령 템플릿을 사용해 보세요.

• [선택적 주체 이름]은 [작업 수행]을 수행할 수 없습니다.
• [선택적 주체 이름]은 [이유] 때문에 [작업 수행]을 수행할 수 없습니다.
• [선택적 주체 이름]에서 "[개체 이름]"에 [작업 수행]을 수행할 수 없습니다.
• [선택적 주체 이름]은 [reason] 때문에 [개체 이름]에 [작업 수행]을 수행할 수 없습니다.
• [작업 수행]에 [리소스]가 충분하지 않습니다.
• [주체 이름]에 [목적]에 필요한 [개체 이름]이 없습니다.
• [원치 않는 결과]가 되도록 [디바이스 또는 설정]이 꺼져 있습니다.
• [디바이스 또는 설정]이(가) [사용 가능 | 찾을 수 있음 | 켜짐 | 사용]
• "[개체 이름]"을(를) 현재 사용할 수 없습니다.
• 사용자 이름 또는 암호가 정확하지 않음
• "[개체 이름]"에 액세스할 수 있는 권한이 없습니다.
• [작업 수행] 권한이 없습니다.
• [프로그램 이름]에 심각한 문제가 발생했으며 즉시 닫아야 합니다.

물론 기본 명령이 문법적으로 정확하고 기본 지침 지침을 준수하도록 필요에 따라 변경합니다.

추가 지침

• 추가 지침을 사용하여 다음을 수행합니다.
  • 문제에 대한 추가 세부 정보를 제공합니다.
  • 문제의 원인을 설명합니다.
  • 사용자가 문제를 해결하기 위해 수행할 수 있는 단계를 나열합니다.
  • 문제가 재발하지 않도록 하는 조치를 제공합니다.
• 가능하면 사용자가 문제를 해결할 수 있도록 실용적이고 유용한 솔루션을 제안합니다. 그러나 제안된 솔루션이 문제를 해결할 수 있는지 확인합니다. 가능하지만 불가능할 수 있는 솔루션을 제안하여 사용자의 시간을 낭비하지 마세요.

잘못된 예:

이 예제에서는 문제 및 권장 솔루션이 가능하지만 가능성은 매우 낮습니다.

• 사용자가 입력한 잘못된 값인 경우 추가 지침을 사용하여 올바른 값을 설명합니다. 사용자는 다른 원본에서 이 정보를 확인할 필요가 없습니다.
• 문제 설명에서 사소하게 추론할 수 있는 경우 솔루션을 제공하지 마세요.

이 예제에서는 추가 지침이 필요하지 않습니다. 해결 방법은 문제 설명에서 간단하게 추론할 수 있습니다.

• 솔루션에 여러 단계가 있는 경우 완료해야 하는 순서대로 단계를 표시합니다. 그러나 사용자가 두 개 또는 세 개 이상의 간단한 단계를 기억하기 어렵기 때문에 다단계 솔루션을 사용하지 마십시오. 더 많은 단계가 필요한 경우 적절한 도움말 항목을 참조하세요.
• 추가 지침을 간결하게 유지합니다. 사용자가 알아야 할 사항만 제공합니다. 불필요한 세부 정보를 생략합니다. 보통 길이의 최대 3개의 문장을 목표로 합니다.
• 사용자가 지침을 수행하는 동안 실수를 방지하려면 결과를 작업 앞에 배치합니다.

올바름:

Windows를 다시 시작하려면 확인을 클릭합니다.

잘못된 예:

확인을 클릭하여 Windows를 다시 시작합니다.

잘못된 예제에서 사용자는 실수로 확인을 클릭할 가능성이 더 높습니다.

• 문제에 대한 가장 가능성이 높은 해결 방법 중 하나일 경우 관리자에게 문의하지 않는 것이 좋습니다. 관리자만 해결할 수 있는 문제에 대해 이러한 솔루션을 예약합니다.

잘못된 예:

이 예제에서는 사용자의 네트워크 연결에 문제가 있는 것일 가능성이 높으므로 관리자에게 문의할 필요가 없습니다.

• 기술 지원에 문의하지 않는 것이 좋습니다. 문제를 해결하기 위해 기술 지원에 문의하는 옵션은 항상 사용할 수 있으며 오류 메시지를 통해 승격할 필요가 없습니다. 대신 사용자가 기술 지원에 문의하지 않고 문제를 해결할 수 있도록 유용한 오류 메시지를 작성하는 데 집중합니다.

잘못된 예:

이 예제에서 오류 메시지는 기술 지원에 문의하는 것이 잘못 권장됩니다.

• 전체 문장, 문장 스타일 대문자 표시 및 끝 문장 부호를 사용합니다.

커밋 단추

• 오류 메시지가 문제를 해결하는 명령 단추 또는 명령 링크를 제공하는 경우 대화 상자에서 해당 지침을 따릅니다.
• 오류로 인해 프로그램을 종료해야 하는 경우 프로그램 종료 단추를 제공합니다. 혼동을 방지하려면 이 목적을 위해 Close를 사용하지 마세요.
• 그렇지 않으면 닫기 단추를 제공합니다. 오류 메시지에는 확인을 사용하지 마세요. 이 단어는 문제가 정상임을 의미하기 때문입니다.
  • 예외: 오류 보고 메커니즘에 고정 레이블이 있는 경우(MessageBox API와 마찬가지로) 확인을 사용합니다.

설명서

오류를 참조하는 경우:

• 기본 명령으로 오류를 참조하세요. 기본 명령이 길거나 자세한 경우 요약합니다.
• 필요한 경우 오류 메시지 대화 상자를 메시지로 참조할 수 있습니다. 를 프로그래밍 및 기타 기술 설명서에서만 오류 메시지로 참조합니다.
• 가능하면 굵게를 사용하여 텍스트의 서식을 지정합니다. 그렇지 않으면 혼동을 방지하기 위해 필요한 경우에만 텍스트를 따옴표로 묶습니다.

예제:드라이브 메시지에 CD 디스크가 없음 메시지가 표시되면 드라이브에 새 CD 디스크를 삽입하고 다시 시도합니다.