Hướng dẫn cài đặt thêm các gói cho visual studio

Chọn loại project là Console App (.NET framework). Khi chọn loại project chúng ta có thể thiết lập các tham số sau:

• Name: tên dự án, đây cũng là tên mặc định của chương trình về sau;
• Location: thư mục chứa tất cả file của dự án;
• Solution name: solution cho phép quản lý nhiều dự án có liên quan (và sử dụng chung code với nhau);
• Framework: lựa chọn phiên bản của .NET framework; nếu lựa chọn phiên bản nào, khi triển khai ứng dụng đòi hỏi trên hệ thống của người dùng phải cài đặt .NET framework phiên bản tương đương hoặc cao hơn;
• Create directory for solution: tốt nhất luôn check mục này, đặt tất cả các dự án trong cùng một thư mục chung;
• Add to source control: chọn mục này nếu bạn sử dụng một chương trình kiểm soát mã nguồn nào đó (như Git). Mục này tạm thời không check.

Các khái niệm solution và project sẽ được xem xét chi tiết ở bài sau.

Điền thông tin như sau:

Điền thông tin cho dự án

Viết code cho chương trình đầu tiên “Hello world”

Click đúp vào file “Program.cs” để mở trong trình soạn thảo code.

Thêm code như sau vào thân phương thức static void Main(string[] args)

using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace ConsoleApp {

class Program  
{  
    static void Main(string[] args)  
    {  
        Console.WriteLine("Hello world from C#");  
        Console.WriteLine("Press any key to quit");  
        Console.ReadKey();  
    }  
}  

}

Giao diện code editor của Visual Studio

Nếu để ý chúng ta sẽ thấy, khi gõ một vài ký tự, Visual Studio sẽ tự động liệt kê các code có chứa những chữ này. Chúng ta có thể trực tiếp lựa chọn bằng cách di chuyển tới mục mong muốn bằng các phím mũi tên, sau đó ấn phím tab mà không cần gõ hết câu.

Tính năng này của trình soạn thảo C# trong Visual Studio được gọi là IntelliSense. IntelliSense giúp việc soạn thảo code C# đặc biệt nhanh chóng và tiện lợi, cũng như giúp giải phóng người lập trình khỏi việc phải ghi nhớ máy móc tất cả các tên gọi. Sau này chúng ta sẽ còn sử dụng nhiều tính năng khác của IntelliSense.

Biên dịch và chạy debug

• Dịch và chạy chương trình ở chế độ debug: F5
• Dịch và chạy chương trình (không debug): Ctrl + F5

Cũng có thể gọi các lệnh này qua menu Debug => Start Debugging hoặc Start Without Debugging

Chọn lệnh debug

Kết quả chạy chương trình

Kết quả chạy chương trình

Mặc dù chương trình của chúng ta chưa thực hiện được chức năng gì nhưng đến đây xin chức mừng bạn đã viết được chương trình đầu tiên với C# và .NET framework.

Debug là chế độ hoạt động mà chương trình được gắn vào một chương trình đặc biệt gọi là debugger (ở đây là Visual Studio Debugger) để giúp chúng ta theo dõi được hoạt động của chương trình, như là giá trị của các biến.

Chương trình chạy ở chế độ debug có thể được dừng tại bất kỳ câu lệnh nào (bằng cách đánh dấu break ở câu lệnh đó) và tiếp tục chạy/dừng theo yêu cầu của người lập trình.

Debug giúp chúng ta phát hiện các lỗi logic của chương trình. Đối với lỗi cú pháp, trình soạn thảo của C# có thể trực tiếp hiển thị trong quá trình viết code mà không cần chạy thử.

Thực hành 3: thêm project mới vào solution

Trong bài thực hành 2, chúng ta mới tạo ra một project đầu tiên cho solution.

Trong Visual Studio, một solution có thể chứa nhiều project. Chúng ta sẽ thêm một project thứ hai vào solution. Cách thực hiện xem trong hình minh họa dưới đây.

Hãy nâng cấp lên Microsoft Edge để tận dụng các tính năng mới nhất, bản cập nhật bảo mật và hỗ trợ kỹ thuật.

Triển khai các gói bằng Package Deployer và Windows PowerShell

• Bài viết
• 03/27/2023

Trong bài viết này

Microsoft Dynamics CRM Package Deployer cho phép quản trị viên triển khai các gói vào một môi trường.

Lưu ý

Package deployer cũng hoạt động với các tổ chức Dynamics 365 Customer Engagement (on-premises).

Một "gói" có thể bao gồm bất kỳ hoặc tất cả những điều sau đây:

• Một hoặc nhiều Dataverse tệp giải pháp.
• Tệp mỏng hoặc tệp dữ liệu được xuất từ công cụ Configuration Migration. Để biết thêm thông tin về công cụ Configuration Migration, hãy xem Quản lý dữ liệu cấu hình của bạn.
• Mã tùy chỉnh có thể chạy trong hoặc sau khi gói được triển khai vào một môi trường.
• Nội dung HTML cụ thể cho các gói phần mềm mà có thể hiển thị ở đầu và cuối của quá trình triển khai gói. Điều này có thể hữu ích để cung cấp một mô tả về các giải pháp và tệp đã được triển khai trong gói. Nhà phát triển tạo ra gói bằng cách sử dụng bản mẫu triển khai gói trong Visual Studio. Thông tin thêm: Tạo gói cho Package Deployer Sau khi một gói được tạo, bạn có thể triển khai gói này bằng cách chạy CRM Package Deployer hoặc bằng cách sử dụng các lệnh ghép ngắn của Windows PowerShell cho công cụ.

Quan trọng

Trước khi bạn nhập và chạy một gói trong tổ chức sản xuất, hãy kiểm tra gói trên hình ảnh phản chiếu phi sản xuất của tổ chức sản xuất.

Luôn sao lưu tổ chức sản xuất trước khi bạn triển khai một gói.

Bạn có thể sử dụng công cụ Package Deployer (packagedeployer.exe) để triển khai các gói trong các cách sau.

Công cụ Package Deployer chỉ có thể xử lý một gói tại một thời điểm. Tuy nhiên, nó cung cấp cho người dùng khả năng để chọn một gói để triển khai từ nhiều gói có sẵn trong thư mục công cụ Package Deployer. Một số màn hình và hành động trong các công cụ khác dựa trên định nghĩa gói. Bạn không phải cài đặt công cụ Package Deployer. Chỉ cần tải về và chạy nó.

1. Nhận được gói để triển khai. Gói là một tập hợp gồm các tệp và thư mục được tạo trong thư mục dự án Visual Studio (\Bin\Debug) khi bạn tạo dự án gói trong Visual Studio. Sao chép mục sau đây từ thư mục gỡ lỗi dự án của bạn:
   • Thư mục : Thư mục này chứa các giải pháp, cấu hình nhập và nội dung cho gói của bạn.
   • .dll: Tập hợp này chứa mã cho gói của bạn. Theo mặc định, tên của cụm chính là tên dự án Visual Studio của bạn. Để có thông tin chi tiết về tao gói bằng cách sử dụng Visual Studio, xem Tạo một gói cho công cụ Package Deployer. Để biết về chủ đề này, chúng ta hãy giả định rằng các cụm và thư mục gói từ Visual Studio thư mục gỡ lỗi dự án (\Bin\Debug) được sao chép vào thư mục c:\DeployPackage.
2. Lấy công cụ Package Deployer. Công cụ Package Deployer có sẵn dưới dạng gói NuGet. Để sử dụng Package Deployer, bạn phải tải về và trích xuất vào máy tính cục bộ bằng cách dùng nuget.exe.

   Tải nuget.exe xuống từ https://www.nuget.org/downloads rồi lưu vào máy tính, chẳng hạn như d:\. Sau đó chạy lệnh sau ở dấu nhắc lệnh để trích xuất nội dung gói vào một thư mục, chẳng hạn như PD, trên máy tính của bạn:

   d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD Sau khi đã trích xuất công cụ Package Deployer, hãy duyệt tới thư mục [ExtractedLocation]\tools để tìm tệp PackageDeployer.exe.
3. Sao chép thư mục gói và tập hợp từ c:\DeployPackage đến thư mục [ExtractedLocation]\tools.
4. Sau khi sao chép tệp, chạy công cụ bằng cách bấm đúp vào tệp PackageDeployer.exe trong thư mục [ExtractedLocation]\tools.
5. Bấm vào Tiếp tục trên màn hình chính của công cụ.
6. Trên màn hình Kết nối với Microsoft Dynamics 365 for Customer Engagement, cung cấp thông tin xác thực chi tiết để kết nối với Dynamics 365 Server mà bạn muốn triển khai gói. Nếu bạn có nhiều tổ chức và muốn chọn tổ chức nơi bạn muốn triển khai gói, chọn hộp kiểm Luôn hiển thị danh sách tổ chức có sẵn. Bấm vào đăng nhập.
7. Nếu bạn có nhiều tổ chức trên Dynamics 365 Server, hãy chọn một tổ chức trong các ứng dụng Dynamics 365 để kết nối.
8. Chọn gói cần triển khai và bấm vào Tiếp theo.
9. Thực hiện theo các hướng dẫn trên màn hình tiếp theo để hoàn thành việc triển khai các gói của bạn. Các màn hình xuất hiện dựa trên định nghĩa của gói bạn đã chọn để triển khai. Nếu triển khai gói đầu cuối bằng công cụ Package Deployer, hãy xem chủ đề về cách triển khai gói Unified Service Desk: Triển khai ứng dụng Unified Service Desk mẫu cho Máy chủ CRM bằng Package Deployer

Quản trị viên hệ thống và người tùy chỉnh có thể chuyển các tham số, chẳng hạn như mã ngôn ngữ vùng đến packagedeployer.exe từ dòng lệnh. Các tham số này chỉ có thể được cấu hình bằng cách chạy công cụ Package Deployer tại dòng lệnh.

Lưu ý

Tính năng này được giới thiệu lần đầu tiên trong Dynamics CRM Online 2016 Bản cập nhật 0.1.

Các tham số khả dụng có trong bảng này.

Tham số Description Giá trị Mặc định Thiết đặt Gói Thời gian chạy Hướng dẫn packagedeployer.exe chấp nhận các tham số dòng lệnh như LCID và SkipChecks. Không áp dụng LCID=ID ngôn ngữ Chỉ định ID ngôn ngữ, chẳng hạn như 1033 cho tiếng Anh-Mỹ hoặc 1036 cho tiếng Pháp-Pháp, từ ID ngôn ngữ có sẵn trong gói. Nếu không xác định, ngôn ngữ mặc định sẽ được sử dụng. Sử dụng ngôn ngữ mặc định SkipChecks = đúng/sai Chỉ sử dụng tham số này khi môi trường mục tiêu không chứa bất kỳ giải pháp hay tùy chỉnh nào khác. Khi được đặt thành đúng, nhập giải pháp sẽ bỏ qua một số kiểm tra an toàn, có thể cải thiện hiệu suất nhập. Sai

Sau đây là ví dụ hướng dẫn CRM Package Deployer bỏ qua một số kiểm tra an toàn và đặt ngôn ngữ để nhập là tiếng Ba Lan.

packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"

Lưu ý

Sử dụng dấu gạch dọc | để phân tách các tham số khi bạn chạy packagedeployer.exe tại dòng lệnh có nhiều tham số.

Để biết thêm thông tin về tham số và giá trị có thể được chuyển đến packagedeployer.exe, hãy xem Tạo gói cho CRM Package Deployer.

Sử dụng Windows PowerShell để triển khai gói

Công cụ Package Deployer cũng hỗ trợ Windows PowerShell để triển khai gói. Thông tin thêm: Bắt đầu sử dụng mô-đun triển khai gói

Khắc phục sự cố các vấn đề triển khai gói bằng cách sử dụng tệp nhật ký

Công cụ Package Deployer cung cấp trợ giúp đăng nhập để có thông tin chi tiết về lỗi có thể xảy ra khi ai đó đăng nhập vào phiên bản Microsoft Dynamics 365 for Customer Engagement bằng cách sử dụng công cụ và triển khai các gói. Theo mặc định, công cụ tạo ba tệp nhật ký sẵn có tại vị trí sau đây trên máy tính, nơi bạn chạy công cụ: c:\Users\\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\. Để chỉ định một thư mục khác, hãy sử dụng tham số -LogWriteDirectory trong lệnh ghép ngắn của PowerShell. Thông tin thêm:

• Login_ErrorLog.log: Cung cấp thông tin về các vấn đầy xảy ra khi bạn sử dụng công cụ để đăng nhập vào phiên bản Dynamics 365. Nếu có bất kỳ vấn đề trong quá trình đăng nhập, một thông báo xuất hiện trên màn hình đăng nhập của công cụ với một liên kết đến tệp nhật ký này. Thông báo cho biết rằng một lỗi đã xảy ra trong khi thực hiện yêu cầu đăng nhập và người dùng có thể xem nhật ký lỗi. Bạn có thể bấm vào liên kết trong thông báo để xem tệp nhật ký này. Tệp nhật ký được tạo ra lần đầu tiên gặp bất kỳ sự cố đăng nhập nào vào công cụ. Sau đó, tệp nhật ký được sử dụng để ghi các thông tin về sự cố đăng nhập bất cứ khi nào nó xảy ra.
• PackageDeployer.log: Cung cấp thông tin chi tiết về từng tác vụ được thực hiện trong công cụ trong quá trình triển khai gói. Bạn có thể xem các tệp nhật ký từ công cụ bằng cách bấm vào liên kết Xem tệp nhật ký ở dưới cùng của màn hình.
• `c:\DeployPackage`0: Cung cấp thông tin chi tiết về dữ liệu được nhập trong lần triển khai gần đây nhất bằng công cụ. Mỗi khi bạn triển khai một gói bằng cách sử dụng công cụ này, các chi tiết sẵn có từ các tệp nhật ký được chuyển đến một tệp gọi là ComplexImportDetail._old.log trong cùng một thư mục, và tệp ComplexImportDetail.log hiển thị các thông tin về việc nhập gần đây nhất được thực hiện bằng cách sử dụng công cụ.

Các thực tiễn tốt nhất cho việc triển khai gói

Trong khi triển khai gói, quản trị viên Dynamics 365 phải:

• Nhấn mạnh vào một tổ hợp gói đã ký để họ có thể theo dõi một tổ hợp về nguồn của nó.

Kiểm tra các gói trên một phiên bản tiền sản xuất (tốt hơn là một hình ảnh phản chiếu của phiên bản Sản xuất) trước khi sử dụng nó trên một máy chủ sản xuất.