SharePoint 워크플로 솔루션 문제 해결
업데이트: 2007년 11월
적용 대상 |
|---|
이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다. 프로젝트 형식
Microsoft Office 버전
자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오. |
Visual Studio Tools for Office를 사용하여 SharePoint 워크플로 솔루션을 개발할 때는 다음 문제가 발생할 수 있습니다.
중단점에서 실행이 두 번 중지된다.
이 문제는 워크플로의 표시 이름을 변경할 경우에 발생할 수 있습니다. Visual Studio 디버거를 시작하면 워크플로 개발 프로세스에서는 워크플로 어셈블리와 라이브러리 또는 목록 간에 새 연결을 만듭니다.
표시 이름을 변경하기 전의 기존 연결은 SharePoint 웹 사이트에서 유지됩니다. 두 연결은 모두 동일한 워크플로 ID를 참조하므로 워크플로 어셈블리가 두 번 실행됩니다.
이 문제를 해결하려면 SharePoint의 라이브러리 또는 목록에서 기존 연결을 수동으로 제거합니다. 라이브러리 또는 목록에서 워크플로 연결을 수동으로 제거하는 방법에 대한 자세한 내용은 Office Online 문서 Add or change a workflow for a list, library, or content type을 참조하십시오.
자세한 내용은 SharePoint 워크플로 솔루션 디버깅을 참조하십시오.
SharePoint 워크플로 프로젝트에서 관리자가 액세스해야 한다는 메시지가 표시된다.
이 문제는 개발 컴퓨터에 관리자로 로그온하지 않고 다음 작업을 수행할 경우에 발생할 수 있습니다.
새 Office SharePoint 워크플로 마법사를 사용하여 새 프로젝트를 만드는 경우
새 Office SharePoint 워크플로 마법사를 사용하여 기존 프로젝트를 수정하는 경우
Visual Studio 디버거를 사용하여 SharePoint 워크플로 프로젝트를 디버깅하는 경우
오류 메시지
SharePoint 워크플로 프로젝트에서 작업하려면 관리자로 로그인해야 합니다.
해결
Administrators 그룹에 속한 계정을 사용하여 개발 컴퓨터에 로그온합니다.
디버깅
Visual Studio 디버거를 사용하여 SharePoint 워크플로 서식 파일을 디버깅할 때는 다음 문제가 발생할 수 있습니다. 자세한 내용은 SharePoint 워크플로 솔루션 디버깅을 참조하십시오.
사이트 위치가 올바르지 않다.
이 문제는 SharePoint Server 2007이 설치되어 있지 않은 경우에 발생할 수 있습니다. 또한 새 Office SharePoint 워크플로 마법사에서 지정한 SharePoint Server 웹 사이트에 대한 관리자 액세스 권한이 없는 경우에도 이 문제가 발생할 수 있습니다.
오류 메시지
- SharePoint 사이트 위치가 잘못되었습니다.
해결
Microsoft Office SharePoint Server 2007을 설치합니다.
SharePoint 웹 사이트에 대한 관리자 액세스 권한이 있는지 확인합니다. 자세한 내용은 Office Online 문서 Grant access to the portal site를 참조하십시오.
대상 디렉터리를 만들 수 없거나 대상 디렉터리 경로를 찾을 수 없다.
이 문제는 워크플로 배포 프로세스에서 기능 디렉터리를 만들 수 없을 때 발생할 수 있습니다.
오류 메시지
<file> 파일에 대한 대상 디렉터리를 만들 수 없습니다.
feature.xml 배포 대상 경로를 찾을 수 없습니다.
workflow.xml 배포 대상 경로를 찾을 수 없습니다.
배포할 workflow.xml 대상 경로를 확인할 수 없습니다.
해결
레지스트리에서 키가 누락되어 있으므로 SharePoint Server 2007의 설치를 복구합니다. 워크플로 배포 프로세스에서는 이 키를 사용하여 기능 디렉터리를 만들 위치를 확인합니다. SharePoint Server 2007을 설치하면 이 키가 레지스트리에 추가됩니다. 자세한 내용은 Working with Features를 참조하십시오.
파일을 찾거나 복사할 수 없다.
이 문제는 워크플로 배포 프로세스에서 기능 정의 파일 및 워크 플로 정의 파일을 SharePoint 기능 디렉터리에 복사할 수 없을 때 발생합니다. 해당 파일의 이름이 바뀌었거나 프로젝트에서 파일이 삭제되었을 수 있습니다.
오류 메시지
<path>에서 파일을 찾을 수 없습니다.
<file>을(를) <path>에 복사할 수 없습니다.
<file> 파일을 찾을 수 없습니다.
프로젝트에서 feature.xml을 찾을 수 없습니다.
프로젝트에서 workflow.xml을 찾을 수 없습니다.
workflow.xml 파일을 <path>에 복사할 수 없습니다.
해결
솔루션 탐색기에서 프로젝트 노드 아래에 기능 및 워크플로 정의 파일이 나타나는지 확인합니다. 기능 정의 파일의 이름은 feature.xml이어야 하고 워크플로 정의 파일의 이름은 workflow.xml이어야 합니다. 누락된 파일을 바꾸려면 다음 단계를 따릅니다.
새 SharePoint 워크플로 프로젝트를 만듭니다.
새 프로젝트의 feature.xml 또는 workflow.xml 파일을 해당 파일이 누락된 프로젝트에 복사합니다.
새 feature.xml 파일에서 Feature 요소의 Title 및 Description 특성을 수정합니다.
새 workflow.xml 파일에서 Name, Description, CodeBesideClass 및 CodeBesideAssembly 특성을 수정합니다.
기능 정의 파일에 대한 자세한 내용은 Feature.xml Files를 참조하십시오. 워크플로 정의 파일에 대한 자세한 내용은 Workflow Definition Schema를 참조하십시오.
전역 어셈블리 캐시에 어셈블리를 설치할 수 없다.
오류 메시지
다음 빌드 위치에서 어셈블리를 찾을 수 없습니다. <path>.
.NET Framework가 제대로 설치되지 않았습니다.
어셈블리가 서명되었는지 확인하십시오.
해결
이러한 문제를 해결하려면 다음과 같은 방법을 사용해 봅니다.
어셈블리가 제대로 빌드되었고 워크플로 어셈블리가 프로젝트의 빌드 출력 위치에 만들어졌는지 확인합니다.
.NET Framework가 제대로 설치되었는지 확인합니다.
다음 세 단계를 수행하여 어셈블리가 서명되어 있는지 확인합니다.
프로젝트에 key.snk라는 강력한 이름의 키 파일이 포함되어 있는지 확인합니다.
솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다. 서명 탭을 클릭하고 어셈블리 서명이 선택되어 있는지 확인합니다.
workflow.xml을 열고 CodeBesideAssembly 특성에 올바른 공개 키 토큰이 포함되어 있는지 확인합니다.
어셈블리에 수동으로 서명할 수도 있습니다. 이렇게 하려면 다음 단계를 수행합니다.
강력한 이름의 키 파일을 새로 만들고 해당 파일의 이름을 key.snk로 지정합니다. 자세한 내용은 방법: 어셈블리 서명(Visual Studio)을 참조하십시오.
워크플로 어셈블리에 대한 공개 및 개인 키 쌍을 만듭니다. 자세한 내용은 방법: 공개/개인 키 쌍 만들기를 참조하십시오.
workflow.xml 파일에서 방금 만든 공개 키를 CodeBesideAssembly 특성 문자열에 추가합니다.
IIS(인터넷 정보 서비스)를 다시 시작할 수 없다.
워크플로 배포 프로세스에서는 IIS를 다시 시작해야 Visual Studio 디버거를 Windows SharePoint Services 프로세스(w3wp.exe)에 연결할 수 있습니다.
오류 메시지
Windows 서비스 관리자를 찾을 수 없습니다.
W3SVC 서비스를 찾을 수 없습니다.
W3SVC 서비스 상태를 쿼리할 수 없습니다.
IIS가 시작되지 않았습니다.
IIS를 중지하지 못했습니다.
해결
컴퓨터에 IIS가 설치되어 있고 World Wide Web Publishing Service가 시작되어 있는지 확인합니다. IIS를 설치하는 방법에 대한 자세한 내용은 Installing IIS를 참조하십시오. 서비스를 시작하는 방법에 대한 자세한 내용은 방법: 서비스 시작을 참조하십시오.
워크플로 서식 파일을 설치할 수 없다.
이 문제는 워크플로 배포 프로세스에서 SharePoint Server 웹 사이트의 기능을 활성화할 수 없을 때 발생할 수 있습니다.
오류 메시지
- feature.xml 파일에서 기능 ID가 잘못되었습니다. <file name>.
해결
- feature.xml 파일을 열고 Feature 요소의 Id 특성에 올바른 GUID가 포함되어 있는지 확인합니다. GUID 형식에 대한 자세한 내용은 GUID를 참조하십시오.
새 GUID를 생성하려면 guidgen.exe를 사용합니다. 자세한 내용은 GUIDGEN 샘플: GUID 생성을 참조하십시오.
Feature.xml 또는 workflow.xml이 올바르지 않다.
이 문제는 워크플로 배포 프로세스에서 기능 또는 워크플로 정의 파일을 구문 분석할 수 없을 때 발생합니다.
오류 메시지
Feature.xml이 잘못되었습니다.
Workflow.xml이 잘못되었습니다.
해결
feature.xml 및 workflow.xml 파일의 형식이 올바른지 확인합니다. 올바른 형식의 XML에 대한 자세한 내용은 XML 용어집을 참조하십시오.
특성이 올바른 값으로 설정되어 있는지 확인합니다. 잘못된 값이 있으면 수정합니다. 오류가 계속 발생하면 Visual Studio를 다시 시작합니다.
요소 이름이 변경되지 않았는지 확인합니다. 잘못된 요소 이름이 있으면 수정합니다. 오류가 계속 발생하면 Visual Studio를 다시 시작합니다.
워크플로를 SharePoint의 라이브러리 또는 목록에 연결할 수 없다.
이 문제는 워크플로 배포 프로세스에서 대상 사이트 프로젝트 속성에 지정된 라이브러리 또는 목록에 워크플로 서식 파일을 자동으로 추가할 수 없을 때 발생합니다.
오류 메시지
GUID가 <GUID>인 워크플로 서식 파일을 찾을 수 없습니다.
SharePoint 목록을 찾을 수 없습니다. <list name>.
Workflow.xml 파일에 지정된 워크플로 ID의 형식이 잘못되었습니다.
해결
workflow.xml 파일을 열고 Workflow 요소의 Id 특성에 올바른 GUID가 포함되어 있는지 확인합니다. GUID 형식에 대한 자세한 내용은 GUID를 참조하십시오. 새 GUID를 생성하려면 guidgen.exe를 사용합니다. 자세한 내용은 GUIDGEN 샘플: GUID 생성을 참조하십시오.
속성 창에서 대상 목록 필드에 지정된 라이브러리 또는 목록이 SharePoint 웹 사이트의 올바른 라이브러리 또는 목록을 식별하는지 확인합니다.
SharePoint 진단 로그 파일을 검사합니다. 이 로그 파일의 기본 위치는 drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\LOGS입니다. 이 위치에서 로그 파일을 찾을 수 없으면 SharePoint 중앙 관리 도구에서 진단 로깅 설정을 참조합니다. 자세한 내용은 Office SharePoint Server 2007에 대한 설명서를 참조하십시오.
SharePoint 사이트 또는 SharePoint Server 인스턴스를 찾을 수 없다.
이 문제는 워크플로 배포 프로세스에서 SharePoint 사이트를 열 수 없을 때 발생할 수 있습니다.
오류 메시지
SharePoint 서버를 사용할 수 없습니다.
SharePoint 서버 인스턴스를 찾을 수 없습니다.
지정된 SharePoint 사이트를 찾을 수 없습니다. <site URL>.
해결
SharePoint Server가 실행 중인지 확인합니다.
속성 창에서 대상 사이트 필드에 지정된 사이트가 올바른 SharePoint 사이트인지 확인합니다.
SharePoint 진단 로그 파일을 검사합니다. 이 로그 파일의 기본 위치는 drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\LOGS입니다. 이 위치에서 로그 파일을 찾을 수 없으면 SharePoint 중앙 관리 도구에서 진단 로깅 설정을 참조합니다. 자세한 내용은 Office SharePoint Server 2007에 대한 설명서를 참조하십시오.
자세한 내용은 Office Online 문서 Troubleshoot common site issues를 참조하십시오.
Visual Studio에서 프로젝트가 저장될 때까지 SharePoint 사이트가 열리지 않는다.
이 문제는 임시 프로젝트를 만든 다음 Visual Studio 디버거를 시작할 때 발생할 수 있습니다. 임시 프로젝트는 디스크 위치를 지정하지 않고 만들 수 있는 프로젝트입니다. 자세한 내용은 임시 프로젝트를 참조하십시오.
오류 메시지
- 프로젝트를 추가하려면 먼저 현재 프로젝트를 저장해야 합니다.
해결
Visual Studio 디버거를 시작하기 전에 다음 단계 중 하나를 수행합니다.
프로젝트를 저장합니다.
Internet Explorer에서 스크립트 디버깅을 해제합니다. 이를 수행하는 방법에 대한 자세한 내용은 What should you do about Internet Explorer script errors?를 참조하십시오.
참고 항목
작업
방법: SharePoint 솔루션을 디버깅할 때 도우미 파일 포함
연습: SharePoint 워크플로 솔루션 만들기 및 디버깅