练习 - 安装和使用开发人员工具

已完成

在本练习中,您将从 NuGet 安装一些开发人员工具。

重要提示

使用已预配 Microsoft Dataverse 的测试环境。 如果没有本环境,您可以注册社区计划

任务 1:安装开发人员工具

在本任务中,您将使用 PowerShell 脚本从 NuGet 安装工具。

  1. 在 Windows“开始”菜单中,键入 Windows PowerShell 并将其打开。

  2. 导航到要将工具安装到的文件夹。 例如,如果您要将它们安装在 C 盘的 devtools 文件夹中,如果本文件夹不存在,请键入 md C:\devtools 进行创建。

  3. 键入 cd C:\devtools 并按 Enter,更换到新文件夹。

  4. 复制以下 PowerShell 脚本并粘贴到 PowerShell 窗口,然后按 Enter。

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    $sourceNugetExe = "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe"
    $targetNugetExe = ".\nuget.exe"
    Remove-Item .\Tools -Force -Recurse -ErrorAction Ignore
    Invoke-WebRequest $sourceNugetExe -OutFile $targetNugetExe
    Set-Alias nuget $targetNugetExe -Scope Global -Verbose
    
    ##
    ##Download Plugin Registration Tool
    ##
    ./nuget install Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool -O .\Tools
    md .\Tools\PluginRegistration
    $prtFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.PluginRegistrationTool.'}
    move .\Tools\$prtFolder\tools\*.* .\Tools\PluginRegistration
    Remove-Item .\Tools\$prtFolder -Force -Recurse
    
    ##
    ##Download CoreTools
    ##
    ./nuget install  Microsoft.CrmSdk.CoreTools -O .\Tools
    md .\Tools\CoreTools
    $coreToolsFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.CoreTools.'}
    move .\Tools\$coreToolsFolder\content\bin\coretools\*.* .\Tools\CoreTools
    Remove-Item .\Tools\$coreToolsFolder -Force -Recurse
    
    ##
    ##Download Configuration Migration
    ##
    ./nuget install  Microsoft.CrmSdk.XrmTooling.ConfigurationMigration.Wpf -O .\Tools
    md .\Tools\ConfigurationMigration
    $configMigFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.ConfigurationMigration.Wpf.'}
    move .\Tools\$configMigFolder\tools\*.* .\Tools\ConfigurationMigration
    Remove-Item .\Tools\$configMigFolder -Force -Recurse
    
    ##
    ##Download Package Deployer 
    ##
    ./nuget install  Microsoft.CrmSdk.XrmTooling.PackageDeployment.WPF -O .\Tools
    md .\Tools\PackageDeployment
    $pdFolder = Get-ChildItem ./Tools | Where-Object {$_.Name -match 'Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf.'}
    move .\Tools\$pdFolder\tools\*.* .\Tools\PackageDeployment
    Remove-Item .\Tools\$pdFolder -Force -Recurse
    
    ##
    ##Remove NuGet.exe
    ##
    Remove-Item nuget.exe
    
  5. 在该脚本完成执行类型 Explorer .Explorer 后跟一个空格和一个点)之后,按 Enter。

  6. 您应该会看到名为 Tools 的单个文件夹,请双击 Tools

  7. 您现在应该会看到所安装工具的以下五个文件夹:

    资源管理器中的‘Tools’文件夹屏幕截图。

任务 2:使用插件注册工具探索已注册的插件

  1. 导航到 PluginRegistration 文件夹。

  2. 在列表中找到 PluginRegistration.exe 并双击启动。

    在文件列表中查找插件注册应用程序的屏幕截图。

  3. 选择创建新连接

  4. 选中显示可用组织的列表

    显示创建新连接并确保显示可用组织列表的屏幕截图。

  5. 选择登录并在系统提示时使用 Dataverse 环境凭据登录。

  6. 在组织(环境)列表中,选择您的测试环境。

  7. 您将看到系统插件的列表,如果您在具有自定义插件的环境中执行本操作,则也会在列表中看到它们。 (程序集)是用于实现插件的 .NET DLL。

    显示工具中插件列表的屏幕截图。

  8. 找到并展开 Microsoft.CDS.ApplicationUser.Plugins

    显示查找特定插件的屏幕截图。

  9. 每个子项均在程序集中实现。 展开其中一个项目,查看该单个插件的步骤注册。

    突出显示插件中步骤的屏幕截图。

  10. 步骤注册会将插件作为事件处理程序连接到事件。 在上述示例中,这用于处理应用程序用户表上的创建。

  11. 双击步骤以查看步骤配置详细信息,包括它在哪些消息和实体上注册、调用插件时的管道阶段、执行是同步还是异步等。

    显示步骤属性的屏幕截图。

当您创建自己的自定义插件时,您将使用本工具加载程序集,并注册要处理的事件的步骤。