Dynamics Community Forum Thread Details

Documentation Discrepancy: IOrganizationServiceFactory.CreateOrganizationService

My question is more of a feedback, but since I can't seem to find any sort of feedback option on Microsoft Learn, I'm trying to get myself heard in here.

The feedback is regarding the method IOrganizationServiceFactory.CreateOrganizationService.

The Microsoft Learn page states:

https://learn.microsoft.com/en-us/dotnet/api/microsoft.xrm.sdk.iorganizationservicefactory.createorganizationservice?view=dataverse-sdk-latest&source=docs#microsoft-xrm-sdk-iorganizationservicefactory-createorganizationservice(system-nullable((system-guid)))

> When called in a plug-in, a null value indicates the SYSTEM user and a Guid.Empty value indicates the same user as IPluginExecutionContext. UserId.

While the SDK method summary states:

//
// Summary:
//     Interface to allow plug-ins to obtain IOrganizationService.
public interface IOrganizationServiceFactory
{
    //
    // Summary:
    //     Creates an instance of IOrganizationService initialized with a given user id.
    //     Null will use the current user id.
    //
    // Parameters:
    //   userId:
    //     Id of user.
    IOrganizationService CreateOrganizationService(Guid? userId);
}

Microsoft Learn is correct, while the SDK summary is wrong. This discrepancy should be corrected.

Or am I missing something?

The mentioned SDK DLL is included in the NuGet package Microsoft.CrmSdk.CoreAssemblies 9.0.2.56.

Categories:

Dynamics 365 general

There is a clear discrepancy between Microsoft Learn and the SDK documentation in Microsoft.CrmSdk.CoreAssemblies regarding the behavior of IOrganizationServiceFactory.CreateOrganizationService.

In plug-in context within Microsoft Dataverse:

null → executes as SYSTEM user
Guid.Empty → executes as current user (context.UserId)

However, the SDK summary incorrectly states that null uses the current user, which is misleading. Therefore, Microsoft Learn reflects the correct runtime behavior, while the SDK comment seems outdated.

The SDK says: