forked from MicrosoftDocs/powerapps-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into v-ljoel-how-to-architecture
- Loading branch information
Showing
412 changed files
with
3,075 additions
and
854 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -25,146 +25,15 @@ search.app: | |
| [!INCLUDE [cc-discovery-service-description](../includes/cc-discovery-service-description.md)] | ||
|
|
||
| To access the Discovery Service using SDK assembly APIs, add a reference to the `Microsoft.Xrm.Sdk.dll` assembly in your Visual Studio project, and then add a `using` statement to access the <xref:Microsoft.Xrm.Sdk.Discovery> namespace. | ||
|
|
||
| The <xref:Microsoft.Xrm.Sdk.WebServiceClient.DiscoveryWebProxyClient> implements the <xref:Microsoft.Xrm.Sdk.Discovery.IDiscoveryService> interface. | ||
|
|
||
| The <xref:Microsoft.Xrm.Sdk.Discovery.IDiscoveryService> interface provides <xref:Microsoft.Xrm.Sdk.Discovery.IDiscoveryService.Execute(Microsoft.Xrm.Sdk.Discovery.DiscoveryRequest)> method you will use to pass a instance of the abstract <xref:Microsoft.Xrm.Sdk.Discovery.DiscoveryRequest> class. | ||
|
|
||
| ## Regional Discovery services | ||
|
|
||
| When you instantiate the <xref:Microsoft.Xrm.Sdk.WebServiceClient.DiscoveryWebProxyClient> you will need to provide a URL for a regional data center using one of the following values. | ||
|
|
||
| [!INCLUDE [regional-discovery-services](../../../includes/regional-discovery-services.md)] | ||
|
|
||
| > [!NOTE] | ||
| > If you do not know the user's region, you need to loop through the available regions until you get results. A single global Discovery Service is also available. More information: [Discover the URL for your organization](../webapi/discover-url-organization-web-api.md) | ||
| ## Discovery service messages | ||
|
|
||
| There are three messages that you can use which all inherit from the abstract <xref:Microsoft.Xrm.Sdk.Discovery.DiscoveryRequest> class. | ||
|
|
||
| The following table lists the messages that are supported with <xref:Microsoft.Xrm.Sdk.Discovery.IDiscoveryService.Execute(Microsoft.Xrm.Sdk.Discovery.DiscoveryRequest)> method. | ||
|
|
||
| |Message|Description| | ||
| |-------------|-----------------| | ||
| |<xref:Microsoft.Xrm.Sdk.Discovery.RetrieveUserIdByExternalIdRequest>|Retrieves the logged-on user's ID in Microsoft Dataverse| | ||
| |<xref:Microsoft.Xrm.Sdk.Discovery.RetrieveOrganizationRequest>|Retrieves information about a single organization.| | ||
| |<xref:Microsoft.Xrm.Sdk.Discovery.RetrieveOrganizationsRequest>|Retrieves information about all organizations to which the user belongs.| | ||
|
|
||
| ## Example | ||
|
|
||
| The following code for a console application uses the <xref:Microsoft.Xrm.Sdk.Discovery.RetrieveOrganizationsRequest> message to retrieve all the organizations for a user. | ||
|
|
||
| ```csharp | ||
| using System; | ||
| using System.Linq; | ||
| using Microsoft.Xrm.Sdk.Discovery; | ||
| using Microsoft.IdentityModel.Clients.ActiveDirectory; | ||
| using Microsoft.Xrm.Sdk.WebServiceClient; | ||
|
|
||
| namespace DiscoveryServiceSample | ||
| { | ||
| class Program | ||
| { | ||
| //These sample application registration values are available for all online instances. | ||
| // this sample requires ADAL.net 5.2 or later | ||
| public static string clientId = "51f81489-12ee-4a9e-aaae-a2591f45987d"; | ||
|
|
||
| static OrganizationDetailCollection GetOrganizationDetails(DiscoveryWebProxyClient svc) | ||
| { | ||
|
|
||
| var request = new RetrieveOrganizationsRequest() | ||
| { | ||
| AccessType = EndpointAccessType.Default, | ||
| Release = OrganizationRelease.Current | ||
| }; | ||
| try | ||
| { | ||
| var response = (RetrieveOrganizationsResponse)svc.Execute(request); | ||
| return response.Details; | ||
| } | ||
| catch (Exception) | ||
| { | ||
| throw; | ||
| } | ||
| } | ||
| static void Main(string[] args) | ||
| { | ||
| string authority = @"https://login.microsoftonline.com/common"; | ||
| string northAmericaResourceUrl = "https://disco.crm.dynamics.com"; | ||
| string discoveryUrl = $"{northAmericaResourceUrl}/XRMServices/2011/Discovery.svc/web"; | ||
| Uri discoveryUri = new Uri(discoveryUrl); | ||
|
|
||
| AuthenticationContext authContext = new AuthenticationContext(authority, false); | ||
| string username = "[email protected]"; | ||
| string password = "yourPassword"; | ||
|
|
||
| AuthenticationResult authResult = null; | ||
| if (username != string.Empty && password != string.Empty) | ||
| { | ||
| UserPasswordCredential cred = new UserPasswordCredential(username, password); | ||
| authResult = authContext.AcquireTokenAsync(northAmericaResourceUrl, clientId, cred).Result; | ||
| } | ||
|
|
||
|
|
||
| using (var svc = new DiscoveryWebProxyClient(discoveryUri)) | ||
| { | ||
| svc.HeaderToken = authResult.AccessToken; | ||
|
|
||
| OrganizationDetailCollection details = GetOrganizationDetails(svc); | ||
|
|
||
| details.ToList().ForEach(x => | ||
| { | ||
| Console.WriteLine("Organization Name: {0}", x.FriendlyName); | ||
| Console.WriteLine("Unique Name: {0}", x.UniqueName); | ||
| Console.WriteLine("Endpoints:"); | ||
| foreach (var endpoint in x.Endpoints) | ||
| { | ||
| Console.WriteLine(" Name: {0}", endpoint.Key); | ||
| Console.WriteLine(" URL: {0}", endpoint.Value); | ||
| } | ||
| Console.WriteLine(); | ||
| }); | ||
| }; | ||
| Console.ReadLine(); | ||
| } | ||
| } | ||
| } | ||
|
|
||
| ``` | ||
|
|
||
| The results may look like this for a user with access to two instances: | ||
|
|
||
| ``` | ||
| Organization Name: Organization A | ||
| Unique Name: orga | ||
| Endpoints: | ||
| Name: WebApplication | ||
| URL: https://orgaservice.crm.dynamics.com/ | ||
| Name: OrganizationService | ||
| URL: https://orgaservice.api.crm.dynamics.com/XRMServices/2011/Organization.svc | ||
| Name: OrganizationDataService | ||
| URL: https://orgaservice.api.crm.dynamics.com/XRMServices/2011/OrganizationData.svc | ||
| Organization Name: Organization B | ||
| Unique Name: orgb | ||
| Endpoints: | ||
| Name: WebApplication | ||
| URL: https://orgbservice.crm.dynamics.com/ | ||
| Name: OrganizationService | ||
| URL: https://orgbservice.api.crm.dynamics.com/XRMServices/2011/Organization.svc | ||
| Name: OrganizationDataService | ||
| URL: https://orgbservice.api.crm.dynamics.com/XRMServices/2011/OrganizationData.svc | ||
| ``` | ||
|
|
||
| > [!NOTE] | ||
| > The `OrganizationDataService` is the deprecated Organization Data Service, not the Web API. This service does not include a URL for the Web API. | ||
| - Regional Discovery Services are no longer avaialble. | ||
| - To access Global Discovery functionality with the SDK going fowarded, see [here](/powerapps-docs/developer/data-platform/org-service/samples/access-discovery-service.md) | ||
|
|
||
| ## Globla Discovery Service Endpoints: | ||
| [!INCLUDE [global-discovery-services](../../../includes/global-discovery-services.md)] | ||
|
|
||
| ### See also | ||
|
|
||
| [Discovery Services](../discovery-service.md)<br /> | ||
| [Global Discovery Service Sample](https://github.com/Microsoft/PowerApps-Samples/tree/master/cds/orgsvc/C%23/DiscoveryService)<br /> | ||
| [Discover the URL for your organization](../webapi/discover-url-organization-web-api.md) | ||
|
|
||
| [!INCLUDE[footer-include](../../../includes/footer-banner.md)] | ||
| [!INCLUDE[footer-include](../../../includes/footer-banner.md)] | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| |Location|Global Discovery Web service URL| | ||
| |--------------|-------------------------------| | ||
| |Commercial|`https://disco.crm.dynamics.com/XRMServices/2011/Discovery.svc`| | ||
| |North America 2 (GCC)|`https://globaldisco.crm9.dynamics.com`| | ||
| |US Government L5 (DOD)|`https://globaldisco.crm.appsplatform.us`| | ||
| |US Government L4 (USG)|`https://globaldisco.crm.microsoftdynamics.us`| | ||
| |China operated by 21Vianet|`https://globaldisco.crm.dynamics.cn`| |
Oops, something went wrong.