Windows 7의 오류 메시지

메모

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

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

오류 메시지의 이름을 바꿀 수 없습니다.

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

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

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

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

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

결정하려면 다음 질문을 고려합니다.

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

디자인 개념

오류 메시지의 특성이

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

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

불필요한 오류 메시지

틀렸습니다.

오류 메시지의 실패했습니다.

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

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

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

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

"성공" 오류 메시지

틀렸습니다.

오류 메시지의

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

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

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

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

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

틀렸습니다.

오류 메시지의

사용자는 오류가 발생했음을 알지만 오류가 무엇인지 또는 오류에 대해 무엇을 해야 할지 전혀 알지 못합니다. 그리고 아니, 그것은 괜찮지 않다!

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

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

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

이해할 수 없는 오류 메시지

틀렸습니다.

오류 메시지의

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

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

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

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

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

틀렸습니다.

매우 자세한 메시지screen shot of extremely verbose message 스크린샷

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

문제: 너무 많은 정보를.

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

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

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

틀렸습니다.

메시지의 찾을 수 없음

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

문제 : 프로그램의 톤은 불필요하게 가혹하거나 극적입니다.

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

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

사용자 비난하는 오류 메시지

틀렸습니다.

메시지의

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

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

선행 원인: 문제 대신 사용자의 동작에 중점을 둔감한 관용구를.

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

오류 메시지

틀렸습니다.

메시지의 오류

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

문제: 오류 메시지 문입니다.

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

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

프로그래머 오류 메시지

틀렸습니다.

메시지의

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

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

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

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

잘못 표시되는 오류 메시지

틀렸습니다.

메시지의

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

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

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

오류 처리의 특성은 이러한 실수의 대부분이 매우 쉽게 수행할 수 있도록 하는 것입니다. 대부분의 오류 메시지가 수치의 전당 후보가 될 수 있다는 것을 깨닫는 것은 불안합니다.

좋은 오류 메시지의 특징은

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

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

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

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

이러한 특성을 갖도록 오류 처리 환경을 디자인하여 프로그램의 오류 메시지를 오류 메시지 홀의 수치심에서 벗어날 수 있습니다.

불필요한 오류 메시지 방지

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

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

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

틀렸습니다.

메시지의 삭제할 수 없음

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

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

틀렸습니다.

메시지의 완료할 수 없음

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

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

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

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

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

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

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

필요한 오류 메시지 제공

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

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

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

틀렸습니다.

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

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

오류 처리 위한 디자인

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

틀렸습니다.

메시지의

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

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

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

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

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

문제 해결(및 이를 방지하는 방법)

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

틀렸습니다.

세 가지 원인diagram of one message stating three causes 나타내는 한 메시지의다이어그램

수정:

각diagram of three messages stating one cause each원인 1개를 나타내는 세 개의 메시지의다이어그램

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

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

틀렸습니다.

두 가지 원인screen shot of message stating two causes 나타내는 메시지의스크린샷

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

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

수정:

한 가지 원인screen shot of message stating one cause 나타내는 메시지의스크린샷

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

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

알 수 없는 오류 처리

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

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

메시지의

알 수 없는 오류를 표시할 수 없는 경우 정보 부족에 대해 앞에 두는 것이 좋습니다.

반면에 대부분의 경우 도움이 될 수 있는 경우 실행 가능한 특정 정보를 제공해야 합니다.

Office Communicator '서버를 사용할 수 없음' 메시지를 보여 주는

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

적절한 메시지 유형 확인

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

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

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

오류 메시지 프레젠테이션

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

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

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

메시지의 수행하는 작업을 중지합니다.

사용자가 닫기 단추를 클릭할 수 있도록 사용자를 중단해야 합니까? 그렇지 않은 경우 모달 대화 상자를 사용하는 대신 사용하는 것이 좋습니다.

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

과다 통신 방지

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

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

틀렸습니다.

자세한 메시지screen shot of verbose message 스크린샷

이 예제는 좋은 오류 메시지이지만 과도하게 커밋됩니다.

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

수정:

메시지의

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

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

초과 커뮤니케이션에 대한 자세한 지침 및 예제는 사용자 인터페이스 텍스트참조하세요.

8가지

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

사용 패턴

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

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

지침

프레젠테이션

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

사용자 입력 오류

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

틀렸습니다.

스피커 볼륨 레이블이screen shot of text box with speaker volume label 있는 텍스트 상자의 스크린샷

이 예제에서는 제한되지 않은 입력란이 제한된 입력에 사용됩니다. 대신 슬라이더를 사용합니다.

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

메시지의

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

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

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

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

문제 해결

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

아이콘

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

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

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

    잘못된 우편 형식screen shot of message incorrect postal format메시지 스크린샷

    메시지 컴퓨터 이름의 스크린샷이 너무 오래screen shot of message computer name too long.

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

    

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

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

  재생할 수 없음

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

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

  틀렸습니다.

  screen shot of message fast switching not enabled 빠른 메시지 전환의 스크린샷을 사용할 수 없습니다.

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

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

점진적 공개

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

메시지의

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

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

레이블 지정 지침은 점진적 공개 컨트롤참조하세요.

이 메시지를 다시 표시 안 함

• 오류 메시지에 이 옵션이 필요한 경우 오류 및 빈도를 다시 고려합니다. 좋은 오류의 모든 특성(관련, 실행 가능 및 드문 경우)이 있는 경우 사용자가 이를 표시하지 않는 것은 의미가 없습니다.

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

기본값

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

도움말

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

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

오류 코드

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

틀렸습니다.

메시지의 열 수 없음

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

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

수정:

1234

0xC0001234

틀렸습니다.

-1

-67113524

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

초기화하지 않았습니다.

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

소리

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

문자 메시지

일반

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

틀렸습니다.

메시지의

수정:

메시지 스크린샷

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

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

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

틀렸습니다.

수정:

메시지의

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

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

틀렸습니다.

잘못된 로그온screen shot of message you entered incorrect logon 입력한 메시지 스크린샷

수정:

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

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

틀렸습니다.

파일을 찾을 수 없습니다.

디스크가 가득 찼습니다.

범위를 벗어난 값입니다.

문자가 잘못되었습니다.

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

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

• 구체적인 문제, 원인 또는 해결 방법을 제공하지 마세요. 옳을 가능성이 없다면 문제, 원인 또는 솔루션을 제공하지 마십시오. 예를 들어 부정확할 가능성이 있는 오류보다 알 수 없는 오류가 발생했다고 말하는 것이 좋습니다.
• 사용자에게 불편한 일(예: 대기)을 하라는 요청을 받거나 소프트웨어가 상황을 비난하는 경우를 제외하고는 "제발"이라는 단어를 사용하지.

수정:

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

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

수정:

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

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

틀렸습니다.

Microsoft Office Outlook '이 항목을 열 수 없습니다.' 메시지를 보여 주는

수정:

메시지 스크린샷을

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

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

수정:

메시지의 사용할 수 없습니다

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

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

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

타이틀

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

틀렸습니다.

'새 폴더의 이름을 바꿀 수 없음' 메시지를 보여 주는

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

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

기본 지침

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

틀렸습니다.

메시지의

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

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

삭제할 수 없음

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

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

메시지의

이 예제에서는 사용자가 Windows 탐색기에서 파일 이름을 변경합니다. 이 경우 컨텍스트에서 알 수 있으므로 전체 파일 경로가 필요하지 않습니다.

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

기본 명령 템플릿

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

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

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

추가 지침

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

틀렸습니다.

메시지 스크린샷

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

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

메시지의

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

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

수정:

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

틀렸습니다.

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

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

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

틀렸습니다.

메시지 스크린샷

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

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

틀렸습니다.

'이 항목을 열 수 없습니다.' 메시지를 보여 주는

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

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

커밋 단추

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

문서조사

오류를 참조하는 경우:

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

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