SharePoint 솔루션 문제 해결

아티클
02/21/2013

Visual Studio 디버거를 사용하여 SharePoint 솔루션을 디버깅할 때는 다음 문제나 경고가 발생할 수 있습니다.자세한 내용은 Debugging SharePoint Workflow Solutions을 참조하십시오.

이 항목에는 다음 단원이 포함되어 있습니다.

샌드박스가 적용 된 Visual 웹 파트 토큰 제한
프로젝트와 프로젝트 항목 이름에서 문자 제한
사용자 지정 필드를 만드는 경우의 오류
배포 후 사이트 만들기 페이지에서 영어가 아닌 새 사이트 정의가 나타나지 않음
클린 시스템에 워크플로 프로젝트가 배포될 때 오류가 나타남
사용자가 디버깅 중에 업데이트된 이미지를 보려면 브라우저에서 응용 프로그램 페이지를 새로 고쳐야 함
오류: 사이트 위치가 올바르지 않음
사이트 삭제 웹 이벤트가 이벤트 수신자 프로젝트에서 발생하지 않음
비즈니스 데이터 연결 모델 프로젝트에서 식별자 이름이 변경된 후 배포 오류가 나타남
SharePoint에서 비주얼 웹 파트를 보려고 하면 오류가 나타남
작업 폼 필드가 포함된 가져온 다시 사용할 수 있는 워크플로가 실행될 때 오류가 나타남
이름을 바꾼 가져온 목록 인스턴스가 실행될 때 오류가 나타남
SharePoint 디버깅 세션이 IIS에 의해 종료됨
자동 취소를 수행하면 SharePoint에서 고아 목록 인스턴스가 남음
원래 SharePoint 솔루션이 내보낸 버전으로 대체됨
디버깅을 시작할 때 오류가 나타납니다.
관련 항목

샌드박스가 적용 된 Visual 웹 파트 토큰 제한

샌드박스가 적용 된 솔루션에 비주얼 웹 파트는 SharePoint 런타임 지원 $SPUrl 같은 표준 토큰을 처리할 수 없습니다.결과적으로 URL, 해결 되지 않은 및 사용자에 script 요소에 직접 같은 다음 예제에서 참조 하는 경우에 비주얼 웹 파트 디자이너의 디자인 뷰에서 내용을 미리 볼 수 없습니다.

<script src=”<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

이 문제를 해결 하는 토큰을 확인 하려면 리터럴을 사용 하 여 하를 참조.

<asp:literal ID="Literal1" runat="server" Text="&lt;script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' &gt;&lt;/script&gt;" />

프로젝트와 프로젝트 항목 이름에서 문자 제한

프로젝트 및 프로젝트 항목의 이름을 SharePoint 2010에서 배포 경로에 유효한 문자만 포함 될 수 있습니다.다른 문자는 허용되지 않습니다.

오류 메시지

"잘못된 문자" 오류 메시지

해결

SharePoint 프로젝트 및 프로젝트 항목의 이름에는 다음 문자만 사용 하십시오.

영숫자 ASCII 문자
공백
마침표(.)
쉼표(,)
밑줄(_)
파선(-)
백슬래시(\)

프로젝트가 패키지 될 때 유효성 검사 규칙이 배포 경로 속성 배포 하려는 각 파일에 대해 이러한 유효한 문자만 있는지 확인 합니다.

사용자 지정 필드를 만드는 경우의 오류

Visual Studio, 사용자 정의 필드는 XML에 정의 됩니다.필드가 없거나 정의 된 특정 형식을 사용 하 여 참조 하는 경우 오류가 발생할 수 있습니다.

오류 메시지

패키지 시 "잘못된 문자" 오류 메시지

해결

필드 정의 대 한 ID에서 다음 예제와 같이 중괄호로 묶은 GUID 여야 합니다.

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Type="Note" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Group="A Custom Group">
</Field>.

다음 예제에서 볼 수 있듯이, 콘텐츠 형식의 필드 참조 빈 요소 형식을 사용 하 여 정의 되어야 합니다 (<FieldRef/>), 시작/끝 요소를 사용 하 여 (<FieldRef> </FieldRef>):

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE"/>

오류 "파일을 구문 분석할 수 없습니다." 필드에 대해 원본 XML 형식이 잘못 된 경우, 올바른 XML 파일이 아닙니다 또는 기타 문제가 발생 하는 경우에 발생 합니다.

배포 후 사이트 만들기 페이지에서 영어가 아닌 새 사이트 정의가 나타나지 않음

만들고 영어 이외의 버전을 사용 하 여 사이트 정의 배포 후 Visual Studio (버전 로캘, 즉 ID 가 1033), SharePoint 사용자 지정 탭에 표시 되지 않는 템플릿 선택 에서 상자와 새 사이트 템플릿이 나타나지는 새 SharePoint 사이트 페이지.

오류 메시지

없음

해결

이 문제는 webtemp_SiteDefinitionProject1.xml과 같은 webtemp 사이트 정의 구성 파일의 경로 속성에 잘못된 값이 있기 때문에 발생합니다.배포 위치 아래에 있는 webtemp 파일의 경로 속성에서 1033을 적절한 로캘 ID로 변경합니다.예를 들어, 일본어 로캘을 사용하려면 값을 1041로 변경합니다.자세한 내용은 MSDN 웹 사이트의 Locale IDs Assigned by Microsoft를 참조하십시오.

클린 시스템에 워크플로 프로젝트가 배포될 때 오류가 나타남

워크플로 프로젝트를 배포 하는 경우이 문제가 발생 Visual Studio 클린 시스템입니다.클린 시스템을 새로 설치 된 컴퓨터는 Visual Studio SharePoint 있지만 없음 워크플로 프로젝트를 배포 하 고 있습니다.

오류 메시지

SharePoint 목록을 찾을 수 없습니다. 워크플로 기록.

해결

이 오류는 워크플로 기록 목록이 없기 때문에 발생합니다.개발 환경이 클린 시스템이기 때문에 워크플로가 배포되지 않으며 워크플로 기록 목록이 아직 없습니다.이 문제를 해결하려면 워크플로 마법사를 다시 열어 워크플로 기록 목록이 만들어지도록 합니다.

워크플로 마법사에 다시 들어가려면

솔루션 탐색기, 워크플로우 노드를 선택 합니다.
에 속성 창에서 줄임표 단추가 있는 속성에서 줄임표 (...) 단추를 선택 합니다.

사용자가 디버깅 중에 업데이트된 이미지를 보려면 브라우저에서 응용 프로그램 페이지를 새로 고쳐야 함

HTML 이미지 컨트롤과 같이 이미지를 표시하는 컨트롤이 있는 응용 프로그램 페이지가 포함된 SharePoint 솔루션을 디버깅하는 경우 이미지의 변경 내용을 표시하려면 브라우저에서 페이지를 새로 고쳐야 합니다.

오류: 사이트 위치가 올바르지 않음

이 문제는 SharePoint Server 2010이 설치되어 있지 않은 경우 발생할 수 있습니다.또한 SharePoint 사용자 지정 마법사에서 지정된 SharePoint 웹 사이트에 대한 관리자 액세스 권한이 없는 경우에도 이 문제가 발생할 수 있습니다.

오류 메시지

SharePoint 사이트 위치가 잘못되었습니다.

해결

SharePoint Server 2010를 설치합니다.
SharePoint 웹 사이트에 대한 관리자 액세스 권한이 있는지 확인합니다.자세한 내용은 Office Online 문서 포털 사이트 액세스 허용을 참조하십시오.

사이트 삭제 웹 이벤트가 이벤트 수신자 프로젝트에서 발생하지 않음

이벤트 수신자 프로젝트를 만들고 "사이트 삭제 중" 같은 특정 웹 이벤트를 선택하면 해당 이벤트가 발생하지 않습니다.

오류 메시지

없음

해결

이 문제는 사이트 수준 이벤트를 처리하려면 기능 범위가 "사이트"여야 하지만 이벤트 수신자 프로젝트의 기본 기능 범위가 "웹"이기 때문에 발생합니다.영향을 받는 웹 이벤트는 다음과 같습니다.

사이트 삭제 중(WebDeleting)
사이트 삭제됨(WebDeleted)
사이트 이동 중(WebMoving)
사이트 이동됨(WebMoved)

이 문제를 해결하려면 이벤트 수신자의 기능 범위를 다음과 같이 변경합니다.

이벤트 수신자의 기능 범위를 변경하려면

솔루션 탐색기, 이벤트 수신자.feature 파일을 열고를 기능 디자이너 파일을 두 번 클릭 하거나 해당 바로 가기 메뉴 및 선택 하 고 열기 열.
옆에 있는 화살표를 선택한 범위, 다음 선택 사이트 에 표시 되는 목록.

비즈니스 데이터 연결 모델 프로젝트에서 식별자 이름이 변경된 후 배포 오류가 나타남

이 문제는 BDC(비즈니스 데이터 연결) 모델에서 엔터티의 식별자 이름을 변경한 후 솔루션을 배포하려고 하는 경우 발생합니다.

오류 메시지

<model name>에 다음 외부 콘텐츠 형식 활성화 오류가 있습니다.
이름이 '<model name>'인 IMetadataObject의 필드 'name'에 중복되는 값이 있습니다.

해결

이 문제를 해결하려면 수동으로 모델을 삭제한 다음 솔루션을 다시 배포합니다.모델은 다음 도구 중 하나를 사용하여 삭제할 수 있습니다.

SharePoint 2010 중앙 관리.자세한 내용은 Microsoft TechNet 웹 사이트의 BDC 모델 관리(SharePoint Server 2010)를 참조하십시오.
Windows PowerShell.명령 프롬프트에서 Remove-SPBusinessDataCatalogModel 명령을 입력하여 모델을 삭제할 수 있습니다.자세한 내용은 Microsoft TechNet 웹 사이트의 일반 cmdlet(SharePoint Server 2010)을 참조하십시오.

SharePoint에서 비주얼 웹 파트를 보려고 하면 오류가 나타남

이 문제는 사용자 정의 컨트롤의 경로 속성이 "CONTROLTEMPLATES\" 문자열로 시작되지 않는 경우 발생합니다.

오류 메시지

'/_CONTROLTEMPLATES/<project name>/<Web Part name>/<user control name>.ascx' 파일이 없습니다.
'/' 응용 프로그램의 서버 오류

해결

이 문제를 해결하려면

솔루션 탐색기를 가진 파일 이름 확장명이.ascx가 사용자 정의 컨트롤 파일을 선택 합니다.
메뉴 모음에서 보기, 속성 창을 선택합니다.
속성 창에서 배포 위치 노드를 확장합니다.
값을 확인은 경로 속성이 문자열 "CONTROLTEMPLATES\"로 시작 합니다.

작업 폼 필드가 포함된 가져온 다시 사용할 수 있는 워크플로가 실행될 때 오류가 나타남

이 문제는 필드가 있는 작업 폼이 포함된 워크플로를 가져온 다음 이 워크플로를 가져온 동일한 시스템에서 새 워크플로를 실행하는 경우 발생합니다.

오류 메시지

배포 단계 '기능 활성화'에서 오류가 발생했습니다. 기능 [Guid]에 ID [Guid](으)로 정의된 필드가 현재 사이트 모음 또는 하위 사이트에서 발견되었습니다.

해결

이 오류는 Visual Studio에서 다시 사용할 수 있는 워크플로 프로젝트를 가져올 때 작업 폼 필드 ID가 변경되지 않기 때문에 발생하는 필드 ID 충돌의 결과입니다.가져온 워크플로를 원래 워크플로가 포함된 동일한 서버에 배포하는 경우 필드 ID 충돌이 발생합니다.

이 문제를 해결하려면 찾기 및 바꾸기 기능을 사용하여 모든 가져온 워크플로 파일에서 필드 ID 특성의 값을 변경합니다.

이름을 바꾼 가져온 목록 인스턴스가 실행될 때 오류가 나타남

이 문제는 가져온 목록 인스턴스의 이름을 바꾼 다음 Visual Studio에서 실행하는 경우 발생합니다.

오류 메시지

빌드 오류: 배포 단계 '기능 활성화'에서 오류가 발생했습니다. Template\Features\[import projectfeaturename]\Files\Lists\[oldlist name]\Schema.xml 파일이 없습니다.

해결

목록 인스턴스를 가져오는 경우 CustomSchema라는 특성이 목록 인스턴스의 Elements.xml 파일에 추가됩니다.Elements.xml에는 목록 인스턴스에 대한 사용자 지정 schema.xml의 경로가 포함됩니다.Visual Studio에서 목록 인스턴스의 이름을 바꾼 경우 사용자 지정 schema.xml의 배포 경로가 변경되지만 CustomSchema 특성의 경로 값은 업데이트되지 않습니다.따라서 목록 인스턴스에서는 기능이 활성화될 때 CustomSchema 특성으로 지정된 이전 경로에서 schema.xml 파일을 찾을 수 없습니다.

이 문제를 해결하려면 CustomSchema 특성에서 schema.xml 파일의 배포 위치 경로를 업데이트합니다.

SharePoint 디버깅 세션이 IIS에 의해 종료됨

중단점을 설정 하는 경우이 문제가 발생 한 Visual Studio SharePoint 솔루션을 F5 키를 실행 하 고 중단점 90 초 이상 유지를 선택 합니다.

오류 메시지

디버깅 중이던 웹 서버 프로세스가 IIS(Internet Information Services)에 의해 종료되었습니다.IIS에서 응용 프로그램 풀 ping 설정을 구성 하 여이 문제를 방지할 수 있습니다.자세한 내용은 도움말을 참조하십시오.

해결

기본적으로 IIS 응용 프로그램 풀은 응용 프로그램이 응답할 때까지 90초 동안 대기한 후 응용 프로그램을 닫습니다.이 프로세스를 응용 프로그램 "Ping"이라고 합니다.이 문제를 해결하려면 대기 시간을 늘리거나 응용 프로그램 Ping을 완전히 사용하지 않도록 설정하면 됩니다.

IIS 응용 프로그램 풀 설정에 액세스하려면

IIS 관리자를 엽니다.
에 연결 창에서 SharePoint 서버 노드를 확장 한 다음 선택 된 응용 프로그램 풀 노드.
에 응용 프로그램 풀 페이지에서 SharePoint 응용 프로그램 풀 (일반적으로 "SharePoint-80")를 선택 한 다음의 작업 창에서 선택의 고급 설정 링크.
IIS 시간 제한 전에 대기 시간을 향상 시키려면 값을 변경 합니다. Ping 최대 응답 시간 (초) 을 90 초 보다 큰 값입니다.
IIS Ping을 사용하지 않도록 설정하려면 Ping 사용을 False로 설정합니다.

자동 취소를 수행하면 SharePoint에서 고아 목록 인스턴스가 남음

이 문제는 다음 단계를 수행하는 경우 발생합니다.

Visual Studio에서 목록 인스턴스가 있는 목록 정의를 만듭니다.
솔루션을 실행 하려면 F5 키를 선택 합니다.
디버깅을 중지하거나 SharePoint 사이트를 닫습니다.
SharePoint 사이트를 다시 열고 목록 인스턴스를 엽니다.

오류 메시지

'/' 응용 프로그램의 서버 오류

해결

이 문제는 SharePoint 솔루션의 디버그 세션을 닫은 후 자동 취소 기능으로 솔루션이 취소되기 때문에 발생합니다.취소를 통해 SharePoint에서 목록 정의가 삭제되지만 목록의 인스턴스는 삭제되지 않습니다.기본 목록 정의는 목록 인스턴스에 필요하지 않습니다.

이 문제를 해결 하려면 메뉴 모음을 선택 하 여 솔루션을 배포 합니다. 빌드, 배포.(솔루션 F5 키를 선택 하 여 디버깅 하지 마십시오.) 그런 다음 SharePoint에서 목록 인스턴스를 삭제합니다.

원래 SharePoint 솔루션이 내보낸 버전으로 대체됨

SharePoint 솔루션을 내보내고 Visual Studio로 가져온 다음 내보낸 동일한 사이트에 솔루션을 다시 배포하는 경우 원래 SharePoint 솔루션이 대체됩니다.이 문제는 원래 솔루션이 활성화되지 않은 서버에 솔루션을 배포하는 경우 발생하지 않습니다.

오류 메시지

없음

해결

솔루션을 내보낸 사이트에서 솔루션을 덮어쓰지 않으려면 Visual Studio 프로젝트에서 모든 가져온 기능의 기능 ID와 SolutionID의 GUID를 변경합니다.

디버깅을 시작할 때 오류가 나타납니다.

Visual Studio SharePoint 솔루션을 디버깅을 시작할 때 지정 된 키가 사전에 없습니다 때문에 Visual Studio Web.config 파일을 로드할 수 없습니다는 오류를 나타냅니다.

오류 메시지

Web.config 구성 파일을 로드할 수 없습니다.파일에서 구성이 잘못된 XML 요소가 있는지 확인한 후 다시 시도하십시오.다음 오류가 발생했습니다. 지정한 키가 사전에 없습니다.

해결

이 문제를 해결 하려면 URL을 웹 응용 프로그램의 대체 액세스 매핑에 대 한 기본 영역에 할당 된 Visual Studio SharePoint 프로젝트의 사이트 URL 속성 값과 일치 하는지 확인 하십시오.인트라넷과 같은 다른 영역 URL을 사용 하 여 오류를 해결할 수 있습니다.사이트 프로젝트 URL을 및 URL의 기본 영역에 일치 해야 합니다.대체 액세스 매핑에 액세스 하려면 SharePoint 2010 중앙 관리 유틸리티를 엽니다, 선택은 응용 프로그램 관리 링크, 다음, 웹 응용 프로그램, 선택은 대체 액세스 매핑 구성 링크.자세한 내용은 웹 응용 프로그램용 영역 만들기를 참조하십시오.

참고 항목

개념

SharePoint 패키징 및 배포 문제 해결

기타 리소스

SharePoint 솔루션 빌드 및 디버깅

Visual Studio의 디버깅

다음을 통해 공유

SharePoint 솔루션 문제 해결

샌드박스가 적용 된 Visual 웹 파트 토큰 제한

프로젝트와 프로젝트 항목 이름에서 문자 제한

오류 메시지

해결

사용자 지정 필드를 만드는 경우의 오류

오류 메시지

해결

배포 후 사이트 만들기 페이지에서 영어가 아닌 새 사이트 정의가 나타나지 않음

오류 메시지

해결

클린 시스템에 워크플로 프로젝트가 배포될 때 오류가 나타남

오류 메시지

해결

워크플로 마법사에 다시 들어가려면

사용자가 디버깅 중에 업데이트된 이미지를 보려면 브라우저에서 응용 프로그램 페이지를 새로 고쳐야 함

오류: 사이트 위치가 올바르지 않음

오류 메시지

해결

사이트 삭제 웹 이벤트가 이벤트 수신자 프로젝트에서 발생하지 않음

오류 메시지

해결

이벤트 수신자의 기능 범위를 변경하려면

비즈니스 데이터 연결 모델 프로젝트에서 식별자 이름이 변경된 후 배포 오류가 나타남

오류 메시지

해결

SharePoint에서 비주얼 웹 파트를 보려고 하면 오류가 나타남

오류 메시지

해결

이 문제를 해결하려면

작업 폼 필드가 포함된 가져온 다시 사용할 수 있는 워크플로가 실행될 때 오류가 나타남

오류 메시지

해결

이름을 바꾼 가져온 목록 인스턴스가 실행될 때 오류가 나타남

오류 메시지

해결

SharePoint 디버깅 세션이 IIS에 의해 종료됨

오류 메시지

해결

IIS 응용 프로그램 풀 설정에 액세스하려면

자동 취소를 수행하면 SharePoint에서 고아 목록 인스턴스가 남음

오류 메시지

해결

원래 SharePoint 솔루션이 내보낸 버전으로 대체됨

오류 메시지

해결

디버깅을 시작할 때 오류가 나타납니다.

오류 메시지

해결

참고 항목

개념

기타 리소스

추가 리소스