다음을 통해 공유

비즈니스 데이터 연결 모델 디자인

  • 아티클

모델 파일에 엔터티 및 메서드를 추가하여 BDC(비즈니스 데이터 연결) 서비스에 대한 모델을 개발할 수 있습니다. 엔터티는 데이터 필드의 컬렉션을 설명합니다. 예를 들어 엔터티는 데이터베이스의 테이블을 나타낼 수 있습니다. 메서드는 엔터티가 나타내는 데이터의 추가, 삭제 또는 업데이트와 같은 작업을 수행합니다. 자세한 내용은 SharePoint에 비즈니스 데이터를 통합을 참조하세요.

엔터티 추가

Visual Studio 도구 상자의 엔터티를 BDC 디자이너로 끌거나 복사하여 엔터티를 추가할 수 있습니다. 자세한 내용은 방법: 모델에 엔터티 추가를 참조하세요.

클래스에 엔터티 필드를 정의합니다. 예를 들어 Address라는 필드를 Customer 클래스에 추가할 수 있습니다. 프로젝트에 새 클래스를 추가하거나 O/R 디자이너(개체 관계형 디자이너)와 같은 다른 도구를 사용하여 만든 기존 클래스를 사용할 수 있습니다. 엔터티의 이름 및 엔터티를 나타내는 클래스의 이름은 일치할 필요가 없습니다. 모델에서 메서드를 정의할 때 클래스를 엔터티와 연결합니다.

메서드 추가하기

BDC 서비스는 사용자가 모델을 기반으로 하는 목록 또는 웹 파트의 정보를 보거나, 추가하거나, 업데이트하거나, 삭제할 때 모델의 메서드를 호출합니다. 사용자가 수행할 수 있는 각 작업에 대한 메서드를 모델에 추가해야 합니다. BDC 메서드 세부 정보 창에서 다섯 가지 기본 메서드 형식 중에서 선택하여 메서드를 만듭니다. 다음 표에서는 BDC 모델의 다섯 가지 기본 메서드에 대해 설명합니다.

메서드 설명
Finder 엔터티 인스턴스의 컬렉션을 반환합니다. 사용자가 목록 또는 웹 파트를 열 때 호출됩니다. 자세한 내용은 방법: Finder 메서드 추가를 참조하세요.
SpecificFinder 특정 엔터티 인스턴스를 반환합니다. 사용자가 목록에서 특정 항목의 세부 정보를 볼 때 호출됩니다. 자세한 내용은 방법: 특정 Finder 메서드 추가를 참조하세요.
작성자 엔터티의 데이터 원본에 새 데이터를 추가합니다. 사용자가 모델을 기반으로 하는 목록의 리본에서 새 항목 단추를 선택하면 호출됩니다. 자세한 내용은 방법: Creator 메서드 추가를 참조하세요.
Updater 목록의 데이터를 수정합니다. 사용자가 목록의 정보를 업데이트할 때 호출됩니다. 자세한 내용은 방법: Updater 메서드 추가를 참조하세요.
Deleter 데이터를 제거합니다. 사용자가 목록에서 항목을 삭제할 때 호출됩니다. 자세한 내용은 방법: Deleter 메서드 추가를 참조하세요.

메서드 매개 변수 정의

메서드를 만들면 Visual Studio가 메서드 형식에 적합한 입력 및 출력 매개 변수를 추가합니다. 이러한 매개 변수는 자리 표시자일 뿐입니다. 대부분의 경우 매개 변수가 올바른 형식의 데이터를 전달하거나 반환할 수 있도록 매개 변수를 수정해야 합니다. 예를 들어 기본적으로 Finder 메서드는 문자열을 반환합니다. 대부분의 경우 엔터티 컬렉션을 반환하도록 Finder 메서드의 반환 매개 변수를 수정해야 합니다. 이 작업은 매개 변수의 형식 설명자를 수정하여 수행할 수 있습니다. 형식 설명자는 매개 변수의 데이터 형식을 설명하는 특성의 컬렉션입니다. 자세한 내용은 방법: 매개 변수의 형식 설명자 정의를 참조하세요.

Visual Studio를 사용하면 모델의 매개 변수 간에 형식 설명자를 복사할 수 있습니다. 예를 들어 GetCustomer 메서드의 반환 매개 변수에 대해 CustomerTD라는 형식 설명자를 정의할 수 있습니다. BDC 탐색기에서 CustomerTD 형식 설명자를 복사하여 CreateCustomer 메서드의 입력 매개 변수에 해당 형식 설명자를 붙여넣을 수 있습니다. 그러면 동일한 형식 설명자를 두 번 이상 정의할 필요가 없습니다.

메서드 인스턴스

메서드를 만들면 Visual Studio가 기본 메서드 인스턴스를 추가합니다. 메서드 인스턴스는 메서드에 대한 참조 및 매개 변수의 기본값입니다. 단일 메서드에는 여러 메서드 인스턴스가 있을 수 있습니다. 각 인스턴스는 메서드 시그니처와 기본값 집합의 조합입니다. 자세한 내용은 방법: 매개 변수의 형식 설명자 정의를 참조하세요.

프로젝트를 실행하면 메서드 인스턴스가 SharePoint 목록 위의 드롭다운 목록에 표시됩니다. 사용자는 메서드 인스턴스를 선택하여 데이터를 볼 수 있습니다.

메서드 인스턴스에 기본값을 추가하려면 모델의 XML을 직접 수정해야 합니다. 자세한 내용은 DefaultValue를 참조하세요.

필터 설명자 추가

모델 소비자는 일부 조건과 일치하는 엔터티의 인스턴스를 검색하기를 원할 수 있습니다. 이 기능을 사용하려면 메서드에 필터 설명자를 추가할 수 있습니다. 필터 설명자를 사용하면 모델 소비자가 실행 전에 메서드에 값을 전달하여 메서드 결과 집합을 필터링할 수 있습니다. 자세한 내용은 방법: 작업에 필터 매개 변수를 추가하여 외부 시스템의 인스턴스 제한을 참조하세요.

SharePoint는 사용자가 필터 값을 제공할 수 있는 몇 가지 기능을 제공합니다. 예를 들어 비즈니스 데이터 웹 파트는 필터 텍스트 상자를 제공합니다. 사용자는 텍스트 상자에 값을 입력하여 목록에서 데이터를 제한할 수 있습니다. 메서드에 필터 설명자를 추가하는 방법에 대한 자세한 내용은 방법: Finder 메서드에 필터 설명자 추가를 참조하세요.

필터 설명자 속성

필터 설명자의 연결된 형식 설명자, 이름 및 형식 속성 값을 설정해야 합니다. 다른 속성은 모두 선택 항목입니다.

연결된 형식 설명자 속성은 필터 설명자를 입력 매개 변수와 연결합니다. 사용자가 필터 값을 제공하면 BDC 서비스는 입력 매개 변수를 사용하여 해당 값을 메서드에 전달합니다.

형식 속성은 사용하려는 필터링 패턴을 설명합니다. SharePoint에서 사용자가 선택한 필터링 패턴은 UI(사용자 인터페이스)에 표시되는 텍스트에 영향을 미칩니다. 예를 들어 비교자 필터링 패턴의 경우 텍스트 is equal to는 비즈니스 데이터 웹 파트 위에 컨트롤로 나타납니다. 각 필터링 패턴에 관한 자세한 내용은 BDC에서 지원하는 필터 형식을 참조하세요.

필터 설명자의 속성에 대한 자세한 내용은 FilterDescriptor를 참조하세요.

기본값 제공

경우에 따라 사용자가 필터 값을 제공하지 않을 수 있습니다. 메서드 인스턴스에 기본값을 추가하거나 메서드 코드에서 기본값을 설정하여 기본값을 제공할 수 있습니다. 메서드 인스턴스에 기본값을 추가하는 방법에 대한 자세한 내용은 MethodInstance를 참조하세요. 메서드 코드에서 입력 매개 변수의 기본값을 설정하는 방법에 대한 예제는 방법: Finder 메서드에 필터 설명자 추가를 참조하세요.

모델 유효성 검사

개발하는 동안 모델의 유효성을 검사할 수 있습니다. Visual Studio는 모델이 예상대로 작동하지 않을 수 있는 문제를 식별합니다. 이러한 오류는 Visual Studio 오류 목록에 표시됩니다.

BDC 디자이너에 대한 바로 가기 메뉴를 열고 유효성 검사를 선택하여 모델의 유효성을 검사할 수 있습니다. 모델에 오류가 포함된 경우 해당 오류가 오류 목록에 표시됩니다. 목록에서 오류를 두 번 클릭하여 오류가 포함된 코드로 빠르게 커서를 이동할 수 있습니다. 또는 F8 키 또는 Shift+F8 키를 반복적으로 선택하여 목록의 오류에서 앞뒤로 이동할 수 있습니다.

모델 규칙을 위반하는 경우 유효성 검사 오류가 발생할 수 있습니다. 예를 들어 형식 설명자의 IsCollection 속성이 true로 설정되어 있지만 자식 형식 설명자가 없는 경우 유효성 검사 오류가 표시됩니다. Visual Studio 오류 목록에 표시되는 일부 오류를 이해하려면 BDC 모델의 규칙을 참조해야 할 수 있습니다. BDC 모델의 규칙에 대한 자세한 내용은 BDCMetadata 스키마를 참조하세요.

모델이 포함된 솔루션 디버그

Visual Studio에서 코드를 디버그할 때와 같이 코드를 디버그할 수 있습니다. 코드를 디버그하려면 코드의 아무 곳에나 중단점을 설정한 다음 디버거를 시작합니다. Visual Studio가 SharePoint 사이트를 엽니다. SharePoint에서 비즈니스 데이터를 사용하는 목록 또는 웹 파트를 만듭니다. 그런 다음 코드를 단계별로 실행할 수 있습니다. SharePoint 프로젝트를 디버그하는 방법에 대한 자세한 내용은 SharePoint 솔루션 문제 해결을 참조하세요.

또한 프로젝트에 추가하는 사용자 지정 어셈블리에서 코드를 디버그할 수도 있습니다. 그러나 사용자 지정 어셈블리의 코드를 디버그하려면 어셈블리를 솔루션 패키지에 추가해야 합니다. 자세한 내용은 방법: 추가 어셈블리 추가 및 제거를 참조하세요.

사용자 지정 어셈블리를 프로젝트에 추가하는 방법에 대한 자세한 내용은 방법: BDC 기능에 사용자 지정 어셈블리 포함을 참조하세요.

BDC 보안 구성

솔루션을 디버그하려면 SharePoint 보안 설정을 수정해야 할 수 있습니다. 이러한 설정을 수정하려면 SharePoint 2010 중앙 관리 웹 사이트에서 비즈니스 데이터 연결 서비스 애플리케이션을 엽니다. 메타데이터 저장소 권한 설정 대화 상자에서 사용자 계정을 추가하고 다음 옵션 중 하나를 선택합니다.

작업 옵션
BDC 서비스에 모델을 배포합니다. 편집
모델에서 외부 콘텐츠 형식(엔터티)을 사용하여 목록 및 웹 파트를 만듭니다. 클라이언트에서 선택 가능
엔터티 데이터를 만들고, 읽고, 업데이트하고, 삭제합니다. 실행

이러한 설정에 대한 자세한 내용은 비즈니스 데이터 연결 서비스 관리를 참조하세요.

개별 모델 또는 외부 콘텐츠 형식에 대한 보안 권한을 설정할 수도 있습니다. 모델의 보안 권한을 설정하는 방법에 대한 자세한 내용은 BDC 모델 관리를 참조하세요. 외부 콘텐츠 형식의 보안 권한을 설정하는 방법에 대한 자세한 내용은 외부 콘텐츠 형식 관리를 참조하세요.

참고 항목

이러한 설정을 사용하여 로컬 SharePoint 서버에서 솔루션을 디버그할 수 있습니다. 프로덕션 SharePoint 서버에서 BDC 관련 보안 설정을 구성하는 방법에 대한 자세한 내용은 비즈니스 데이터 연결 서비스 보안 개요를 참조하세요.

손상된 모델 취소

디버거를 처음 시작하면 Visual Studio에서 전체 모델을 SharePoint에 배포합니다. 그 이후에는 Visual Studio가 SharePoint의 모델을 배포 간 변경 내용으로 업데이트합니다.

Visual Studio가 모델을 SharePoint에서 완전히 취소하도록 하려는 상황이 있을 수 있습니다. 예를 들어 모델이 손상되었을 수 있습니다. 모델을 SharePoint에 다시 배포하려면 모델의 증분 업데이트 속성을 False로 설정한 다음 디버거를 시작합니다. 증분 업데이트 속성은 BDC 탐색기에서 모델을 나타내는 노드를 선택하면 속성 창에 표시됩니다. 기본적으로 모델의 이름은 BdcModel1입니다.

모델에서 엔터티의 식별자 이름 변경

모델을 배포한 후 식별자의 이름을 변경하면 배포 오류가 발생할 수 있습니다. 모델의 증분 업데이트 속성을 False로 설정하여 이 오류를 해결할 수는 없습니다. 모델을 수동으로 취소한 다음 솔루션을 다시 배포해야 합니다. 자세한 내용은 SharePoint 솔루션 문제 해결을 참조하세요. 모델을 처음 배포하기 전에 증분 업데이트 속성을 False로 설정하여 이 오류를 방지할 수 있습니다.

BDC 모델 요소에 대한 설명서 찾기

Visual Studio는 사용자가 만든 각 엔터티, 메서드 또는 기타 항목에 대한 XML 요소를 모델에 추가합니다. 요소 특성은 속성 창에 속성으로 표시됩니다. 모델을 디자인할 때 Visual Studio에서 생성하는 요소와 특성에 대한 자세한 내용은 BDCMetadata 스키마를 참조하세요.

제목 설명
BDC 모델 디자인 도구 개요 BDC용 모델을 시각적으로 디자인하는 데 사용할 수 있는 도구에 대해 설명합니다.
방법: 모델에 엔터티 추가 외부 콘텐츠 형식 또는 엔터티를 모델에 추가하는 방법을 보여 줍니다.
방법: Finder 메서드 추가 사용자가 목록 또는 웹 파트에서 엔터티 목록을 볼 수 있도록 하는 메서드를 추가하는 방법을 보여 줍니다.
방법: 특정 Finder 메서드 추가 사용자가 특정 엔터티의 세부 정보를 볼 수 있도록 하는 메서드를 추가하는 방법을 보여 줍니다.
방법: Creator 메서드 추가 사용자가 목록 또는 웹 파트에서 직접 데이터 원본에 레코드를 추가할 수 있도록 하는 메서드를 추가하는 방법을 보여 줍니다.
방법: Deleter 메서드 추가 사용자가 목록 또는 웹 파트의 UI(사용자 인터페이스)에서 옵션을 사용하여 데이터 원본에서 데이터를 제거할 수 있도록 하는 메서드를 추가하는 방법을 보여 줍니다.
방법: Updater 메서드 추가 사용자가 목록 또는 웹 파트에서 직접 데이터 원본의 데이터 레코드를 변경할 수 있도록 하는 메서드를 추가하는 방법을 보여 줍니다.
방법: 메서드에 매개 변수 추가 Visual Studio에서 메서드 세부 정보 창을 사용하여 메서드에 입력 및 반환 매개 변수를 추가하는 방법을 보여 줍니다.
방법: 매개 변수의 형식 설명자 정의 모델에서 매개 변수 데이터 형식을 정의하는 방법을 보여 줍니다.
방법: 메서드 인스턴스 정의 BDC가 실행하는 메서드의 인스턴스를 만드는 방법을 보여 줍니다.
방법: Finder 메서드에 필터 설명자 추가 사용자가 Finder 메서드에서 반환하는 인스턴스 수를 제한할 수 있도록 하는 방법을 보여 줍니다.
엔터티 간 연결 만들기 모델에서 엔터티 간의 관계를 정의하는 방법을 설명합니다. 비즈니스 데이터 웹 파트, 외부 목록 및 사용자 지정 애플리케이션은 UI(사용자 인터페이스)에 이러한 데이터 관계를 표시할 수 있습니다.
방법: 엔터티 간 연결 만들기 모델에서 엔터티 간의 관계를 정의하는 방법을 보여 줍니다.
연습: 비즈니스 데이터를 사용하여 SharePoint에 외부 목록 만들기 SharePoint 외부 목록에 연락처를 표시하는 모델을 만들고 테스트하는 방법을 보여 주는 단계별 지침을 제공합니다.
SharePoint에 비즈니스 데이터 통합 BDC 서비스용 모델을 만들고 디자인하는 방법에 대한 개요를 제공합니다.