SystemUser(사용자) 엔터티 메시지 및 메서드
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
시스템 사용자는 Microsoft Dynamics 365 온-프레미스 또는 Microsoft Dynamics 365(온라인)에 로그온할 수 있는 액세스가 있는 사용자입니다. 시스템 사용자 관리에는 다양한 활동이 포함됩니다. 여기에는 시스템 사용자 추가, 보안 역할 설정 및 시스템 사용자 보고 계층 구조에 배치 등이 포함됩니다. 이러한 각 기능에 대한 액세스는 시스템 사용자가 가진 보안 권한으로 보호됩니다. 이러한 권한은 시스템 사용자의 보안 역할을 기반으로 합니다. 시스템 사용자에게 보안 역할을 할당하거나 팀에 연결하려면 먼저 시스템 사용자 프로필을 만들고 저장해야 합니다. 이 엔터티의 스키마 이름은 SystemUser입니다.조직에 대한 엔터티 메타데이터를 보려면 조직에 대한 메타데이터 찾아보기에 설정된 메타데이터 브라우저 솔루션을 설치하십시오. SDK 다운로드의 최상위 폴더에 포함된 EntityMetadata.xlsx라는 Excel 파일에서 사용자 지정되지 않은 조직의 메타데이터를 볼 수도 있습니다.
Dynamics 365 시스템 사용자 계정은 활성화 또는 비활성화할 수 있습니다.Dynamics 365은 유료 라이선스로 활성화된 시스템 사용자의 애플리케이션 로그인만 허용합니다.
회사를 떠난 영업 직원의 거래처와 같은 기록 정보를 유지하기 위해 활성화된 시스템 사용자의 계정을 비활성화하도록 설정할 수 있습니다. 휴가 중과 같이 워크플로 프로세스에서 해당 사용자를 제거하려면 사용자 계정을 비활성화하도록 설정합니다. 비활성화된 시스템 사용자는 유료 라이선스에 포함되지 않으므로 시스템 사용자를 비활성화하면 사용 가능한 라이선스 수가 추가됩니다.
참고
온-프레미스 인스턴스 Microsoft Dynamics 365에서 시스템 사용자 엔터티의 인스턴스를 만들려면 먼저 시스템 사용자가 Active Directory에 있어야 합니다.
Microsoft Dynamics 365(온라인)에서 시스템 사용자 엔터티의 인스턴스를 만들려면 사용자의 Microsoft 계정가 있어야 합니다. 또한 Microsoft Dynamics 365(온라인)에 대해 사용자에게 초대장을 보내는 프로그래밍 방식이 없으므로 웹 응용 프로그램을 통해 사용자 초대를 보내야 합니다.
다음 표에서는 IOrganizationService.Execute 메서드와 사용하는 이 엔터티에 대한 메시지에 대해 설명합니다.
메시지 |
설명 |
|---|---|
관계에 참여하는 한 레코드와 하나 이상의 레코드 간에 링크를 만듭니다.IOrganizationService.Associate 메서드를 사용할 수도 있습니다.자세한 내용은 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords을 참조하십시오. 이 엔터티에 대한 기본 관계 목록은 SystemUser 엔터티 메타데이터를 참조하십시오.조직의 메타데이터에서 이 정보를 찾을 수 있습니다. 앞의 메타데이터 브라우저 정보를 참조하십시오. |
|
시스템 쿼리를 만듭니다.IOrganizationService.Create 메서드를 호출할 수도 있습니다. |
|
관계에 참여하는 한 레코드와 하나 이상의 레코드 간의 링크를 제거합니다.IOrganizationService.Disassociate 메서드를 사용할 수도 있습니다.자세한 내용은 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords을 참조하십시오. 이 엔터티에 대한 기본 관계 목록은 SystemUser 엔터티 메타데이터를 참조하십시오.조직의 메타데이터에서 이 정보를 찾을 수 있습니다. 앞의 메타데이터 브라우저 정보를 참조하십시오. |
|
두 엔터티에 대해 특성 맵이 정의된 경우 기존 레코드에서 새 레코드를 초기화합니다. 자세한 내용은 엔터티 사용자 지정 및 특성 매핑을 참조하십시오. |
|
중복 검색이 사용되고 엔터티에 대해 게시된 중복 검색 규칙이 있는 경우 지정된 레코드에 대한 중복 레코드를 감지하고 검색합니다. 자세한 내용은 중복 데이터 검색을 참조하십시오. |
|
지정된 시스템 사용자가 담당하는 모든 엔터티를 다른 시스템 사용자 또는 팀에 다시 할당합니다. |
|
시스템 사용자를 검색합니다.IOrganizationService.Retrieve 메서드를 호출할 수도 있습니다. |
|
레코드의 상위 항목을 제거합니다. |
|
지정된 시스템 사용자에게 보고하는 시스템 사용자 모음을 검색합니다. |
|
시스템 사용자 모음을 검색합니다.IOrganizationService.RetrieveMultiple 메서드를 호출할 수도 있습니다. |
|
사용자 또는 팀에서 직접 또는 간접적으로(팀 구성원을 통해) FieldSecurityProfile 엔터티에 연결된 모든 보안 특성 권한을 검색합니다. |
|
더 이상 사용되지 않습니다. RetrieveMultipleRequest 클래스를 사용합니다. 지정된 시스템 사용자가 구성원인 팀 모음을 검색합니다. |
|
지정된 사업부에서 역할을 통해 시스템 사용자(사용자)가 가진 모든 권한을 검색합니다. |
|
더 이상 사용되지 않습니다. RetrieveMultipleRequest 클래스를 사용합니다. 지정된 시스템 사용자에 대한 시스템 사용자 설정을 검색합니다. |
|
지정된 시스템 사용자에 대한 사업부를 설정합니다. |
|
지정된 시스템 사용자에 대한 상위 항목(관리자)을 설정합니다. |
|
시스템 사용자의 상태를 설정합니다. 가능한 상태는 SystemUser.Statecode 특성에 정의되어 있습니다. 초기 바인딩 유형을 사용할 경우 SystemUserState 열거형을 사용합니다. 상태 값의 목록은 SystemUser 엔터티 메타데이터를 참조하십시오.조직의 메타데이터에서 이 정보를 찾을 수 있습니다. 앞의 메타데이터 브라우저 정보를 참조하십시오. |
|
시스템 쿼리를 업데이트합니다.IOrganizationService.Update 메서드를 호출할 수도 있습니다. |
|
더 이상 사용되지 않습니다. UpdateRequest 클래스를 사용합니다. 시스템 사용자에 대한 시스템 사용자 설정을 업데이트합니다. |
참고 항목
사용자 및 팀 엔터티
엔터티별 권한
UserSettings 엔터티 메시지 및 메서드
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보