Sử dụng tham chiếu kết nối trong giải pháp với Microsoft Dataverse

Bộ kết nối là một proxy hoặc một trình bao bọc xung quanh API cho phép dịch vụ cơ bản giao tiếp với Microsoft Power Automate, Microsoft Power Apps và Azure Logic Apps. Nó cung cấp cho người dùng cách kết nối tài khoản của họ và sử dụng một bộ hành động và kích hoạt được xây dựng sẵn để xây dựng ứng dụng và quy trình làm việc của họ.

Kết nối là thông tin xác thực được lưu trữ cho một trình kết nối, ví dụ thông tin xác thực cho trình kết nối. OAuth SharePoint

Tham chiếu kết nối là một thành phần giải pháp chứa tham chiếu đến kết nối về một đầu nối cụ thể. Cả ứng dụng canvas nhận biết giải pháp và các hoạt động trong luồng nhận biết giải pháp đều liên kết với tham chiếu kết nối thay vì liên kết trực tiếp với kết nối. Trong quá trình nhập giải pháp vào môi trường đích, một kết nối sẽ được cung cấp cho tất cả các tham chiếu kết nối để bất kỳ luồng tham chiếu nào cũng có thể được bật tự động sau khi quá trình nhập hoàn tất. Để thay đổi một kết nối cụ thể được liên kết với một ứng dụng canvas hoặc dòng, bạn chỉnh sửa thành phần tham chiếu kết nối trong giải pháp.

Thêm tham chiếu kết nối vào giải pháp

Có thể thêm tham chiếu kết nối vào giải pháp theo nhiều cách khác nhau:

  • Khi bạn sử dụng trình khám phá giải pháp để tạo tham chiếu kết nối mới trong giải pháp.

  • Khi bạn nhập một giải pháp. Để tìm hiểu thêm, hãy truy cập Nhập giải pháp.

  • Ngầm định khi bạn xây dựng ứng dụng canvasluồng được xác định trong Microsoft Dataverse giải pháp.

Lưu ý

  • Các ứng dụng canvas và dòng xử lý các kết nối khác nhau. Luồng sử dụng tham chiếu kết nối cho tất cả các trình kết nối, trong khi ứng dụng canvas chỉ sử dụng chúng cho các kết nối được chia sẻ ngầm định (không phải OAuth), chẳng hạn như Xác thực SQL Server. Thông tin thêm: Bảo mật và các loại xác thực
  • Tham chiếu kết nối sẽ tự động được tạo khi bạn tạo kết nối mới từ trình thiết kế luồng hoặc Power Apps Studio.
  • Các luồng và ứng dụng canvas đã thêm bên ngoài giải pháp sẽ không tự động được nâng cấp để dùng tham chiếu kết nối.
  • Các tham chiếu kết nối chỉ được liên kết với ứng dụng canvas tại thời điểm nguồn dữ liệu được thêm vào ứng dụng. Để nâng cấp ứng dụng, bạn phải xóa kết nối khỏi ứng dụng, sau đó thêm kết nối có chứa tham chiếu kết nối đã liên kết.

Thêm thủ công tham chiếu kết nối bằng trình khám phá giải pháp

  1. đăng nhập vào Power Apps hoặc Power Automate.

  2. Trên ngăn bên trái, hãy chọn Giải pháp. Nếu mục không có trong ngăn bảng điều khiển bên, hãy chọn …Thêm rồi chọn mục bạn muốn.

  3. Tạo một giải pháp mới hoặc mở một giải pháp hiện có.

  4. Trên thanh lệnh, chọn Mới>Thêm>Tham chiếu kết nối.

  5. Trên ngăn Tham chiếu kết nối mới , hãy nhập thông tin sau. Các cột bắt buộc được gắn dấu hoa thị (*).

    • Tên hiển thị: Nhập tên duy nhất và hữu ích để giúp phân biệt tham chiếu kết nối này với các tham chiếu khác.
    • Thêm mô tả: Nhập văn bản mô tả kết nối.
    • Đầu nối: Chọn một đầu nối hiện có từ danh sách như trong ảnh chụp màn hình ở đây. Bạn cũng có thể chọn Mới để tạo kết nối mới cho tham chiếu kết nối này. Sau khi hoàn tất việc tạo kết nối mới, hãy chọn Làm mới để chọn kết nối của bạn từ danh sách.
    • Kết nối: Dựa trên Bộ kết nối bạn đã chọn, hãy chọn một kết nối hiện có hoặc chọn Kết nối mới để tạo một kết nối.
  6. Chọn Tạo.

    Ảnh chụp màn hình bảng Tham chiếu kết nối mới.

Đang đặt tên tham chiếu kết nối

Tên hiển thị của tham chiếu kết nối phải là duy nhất để các tham chiếu kết nối khác nhau có thể được phân biệt chỉ bằng tên. Theo mặc định, tên tham chiếu kết nối bao gồm trình kết nối mục tiêu, tên giải pháp hiện tại cho ngữ cảnh và hậu tố ngẫu nhiên để đảm bảo tính duy nhất. Cân nhắc điều chỉnh tên tham chiếu kết nối thành một tên duy nhất và tên đó giải thích mục đích sử dụng.

Tái sử dụng các kết nối trong luồng giải pháp

Các luồng được tạo bên ngoài giải pháp sử dụng kết nối trực tiếp. Các luồng được tạo trong một giải pháp sử dụng tham chiếu kết nối và các điểm tham chiếu kết nối tại kết nối. Để sử dụng lại kết nối trong dòng giải pháp, trước tiên bạn cần tạo một tham chiếu kết nối trỏ đến kết nối đó.

Cập nhật luồng để sử dụng tham chiếu kết nối thay vì kết nối

Khi luồng không nằm trong giải pháp, nó sẽ sử dụng các kết nối. Nếu luồng đó sau đó được thêm vào giải pháp, ban đầu nó sẽ tiếp tục sử dụng các kết nối. Các luồng có thể được cập nhật để sử dụng các tham chiếu kết nối thay vì kết nối theo một trong hai cách:

  1. Nếu luồng được xuất trong một giải pháp không được quản lý và được nhập, các kết nối sẽ bị xóa và thay thế bằng các tham chiếu kết nối.

  2. Khi mở luồng giải pháp, trình kiểm tra luồng trên trang chi tiết luồng sẽ hiển thị cảnh báo Sử dụng tham chiếu kết nối. Thông báo cảnh báo có chứa hành động Xóa kết nối để có thể thêm tham chiếu kết nối. Việc chọn hành động đó sẽ xóa các kết nối khỏi trình kích hoạt và các hành động trong luồng và cho phép các tham chiếu kết nối được chọn và tạo.

Tự động sử dụng tham chiếu kết nối trong dòng giải pháp

Khi một hành động được thêm vào luồng giải pháp, Power Automate sẽ cố gắng sử dụng lại các tham chiếu kết nối hiện có từ giải pháp hiện tại hoặc các giải pháp khác trước khi tạo tham chiếu kết nối mới. Để đảm bảo rằng tham chiếu kết nối nằm trong cùng một giải pháp với dòng, hãy tạo hoặc thêm tham chiếu kết nối trong cùng một giải pháp và tham chiếu tham chiếu kết nối đó từ dòng.

Chia sẻ kết nối với người dùng khác để có thể kích hoạt luồng

Khi một luồng được bật (kích hoạt), người dùng bật luồng đó cần sở hữu hoặc có quyền sử dụng tất cả các kết nối trong luồng. Điều này thường được thực hiện bằng cách yêu cầu chủ sở hữu luồng tạo các kết nối bên trong tất cả các tham chiếu kết nối mà luồng sử dụng. Nếu người dùng không phải là chủ sở hữu luồng cung cấp kết nối trên luồng, thì luồng cần phải được chủ sở hữu của các kết nối đó bật hoặc các kết nối cần được chia sẻ với người dùng đang bật luồng.

Lưu ý

OAuth kết nối chỉ có thể được chia sẻ rõ ràng với người dùng đại diện cho chủ thể dịch vụ.

Chia sẻ thủ công các kết nối để kích hoạt luồng

Việc chia sẻ kết nối có thể được thực hiện theo các bước sau.

  1. Đi tới Power Apps và chọn môi trường chứa kết nối.

  2. Chọn Kết nối trên ngăn điều hướng bên trái, sau đó chọn kết nối bạn muốn chia sẻ. Nếu mục không có trong ngăn bảng điều khiển bên, hãy chọn …Thêm rồi chọn mục bạn muốn.

  3. Từ menu, chọn Chia sẻ.

  4. Từ màn hình chia sẻ, nhập tên người dùng (chủ dịch vụ) sẽ kích hoạt luồng.

  5. Đối với quyền, hãy chọn Có thể sử dụng.

  6. Để hoàn tất việc chia sẻ, hãy chọn Lưu.

Chia sẻ kết nối tự động để kích hoạt luồng

Để tự động chia sẻ kết nối, hãy sử dụng hành động Chỉnh sửa chỉ định vai trò kết nối trên trình kết nối Power Apps cho Makers.

Ảnh chụp màn hình ví dụ chia sẻ kết nối.

Giới hạn

  • Tham chiếu kết nối hiện được lưu theo cách không đồng bộ. Không giống như trong giai đoạn xem trước, không còn giới hạn về số lượng luồng có thể tham chiếu đến cùng một tham chiếu kết nối. Khi tham chiếu kết nối được cập nhật, biểu ngữ thông tin liên kết đến bảng điều khiển chứa thông tin chi tiết về cập nhật không đồng bộ sẽ xuất hiện.
  • Ngoài ra, không có giới hạn về số lượng hành động trong mỗi luồng có thể được liên kết với tham chiếu kết nối.
  • Ứng dụng Canvas không nhận dạng được các tham chiếu kết nối trên các trình kết nối tùy chỉnh. Để khắc phục hạn chế này, sau khi giải pháp được nhập vào môi trường, ứng dụng phải được chỉnh sửa để xóa rồi thêm lại kết nối trình kết nối tùy chỉnh. Lưu ý, nếu ứng dụng này nằm trong giải pháp được quản lý, việc tiến hành chỉnh sửa ứng dụng sẽ tạo ra một lớp không được quản lý. Thông tin thêm: Các lớp giải pháp

Các sự cố đã biết

Phần này mô tả các sự cố đã biết liên quan đến tham chiếu kết nối.

Sao chép môi trường ngắt kết nối tham chiếu cho các kết nối tùy chỉnh

Các đầu nối tùy chỉnh sử dụng mã định danh dành riêng cho môi trường để tham chiếu đến một đầu nối tùy chỉnh. Sau khi thực hiện thao tác sao chép môi trường, một tham chiếu kết nối mới phải được tạo tới trình kết nối tùy chỉnh mới. Sau đó, bất kỳ ứng dụng hoặc luồng nào sử dụng tham chiếu kết nối cũ sẽ cần phải được sửa.

Các đầu nối tùy chỉnh cần được nhập vào một giải pháp riêng biệt từ các tham chiếu kết nối của chúng

Các đầu nối tùy chỉnh cần được nhập vào một giải pháp riêng, trước các tham chiếu hoặc luồng kết nối. Trước tiên hãy xuất một giải pháp chỉ chứa trình kết nối tùy chỉnh.

Câu hỏi thường gặp

Làm thế nào để khắc phục lỗi "Kết nối không hợp lệ"?

Nếu tham chiếu kết nối hiển thị là "không hợp lệ" và có dấu chấm than màu đỏ xuất hiện trên trang chi tiết luồng thì điều này có nghĩa là kết nối cơ bản đang ở trạng thái không tốt. Khi điều này xảy ra, hãy kiểm tra và sửa kết nối cơ bản bằng cách cập nhật kết nối hoặc thay thế kết nối.

Lỗi ConnectionAuthorizationFailed là gì? Tại sao tôi không thể bật (kích hoạt) một luồng?

Lỗi "ConnectionAuthorizationFailed" cho biết người dùng đang cố kích hoạt luồng không có quyền đối với ít nhất một trong các kết nối mà luồng đang sử dụng. Để giải quyết tình huống này, hãy chọn một trong các giải pháp sau:

  • Người dùng sở hữu các kết nối cần chia sẻ tất cả các kết nối với người dùng bật (kích hoạt) luồng.
  • Nếu một người dùng sở hữu tất cả các kết nối trong luồng, thì người dùng đó có thể bật (kích hoạt) luồng.

Sau khi luồng được chủ sở hữu kết nối bật, thì luồng sẽ có quyền sử dụng các kết nối đó. Từ thời điểm đó, bất kỳ người đồng sở hữu luồng nào cũng có thể bật luồng.

Một luồng có thể được chủ sở hữu kết nối kích hoạt rồi chuyển quyền sở hữu cho người dùng khác không?

Có. Khi một luồng được chủ sở hữu của các kết nối được luồng đó sử dụng bật (kích hoạt), thì luồng đó sẽ nhận được quyền rõ ràng để sử dụng các kết nối đó. Những người đồng sở hữu luồng có thể tắt và bật luồng tùy theo nhu cầu.

Quyền được cấp cho các ứng dụng và luồng sử dụng kết nối có thể được xem trong trang chi tiết cho kết nối đó trong các tab Ứng dụng sử dụng kết nối nàyLuồng sử dụng kết nối này .

Nếu luồng được chỉnh sửa để thêm các hành động mới sử dụng các tham chiếu kết nối bổ sung với các kết nối mới, thì chủ sở hữu của các kết nối mới đó cần phải tự bật luồng ban đầu hoặc chia sẻ các kết nối với chủ sở hữu bật luồng. Thông tin thêm: Chia sẻ tài nguyên ứng dụng

Quyền sở hữu tham chiếu kết nối có thể được chuyển giao cho người dùng khác không?

Quyền sở hữu tham chiếu kết nối không thể được chuyển giao cho người dùng khác từ khu vực Giải pháp trong Power Apps (make.powerapps.com).

Tuy nhiên, trình khám phá giải pháp cổ điển có thể được sử dụng để thay đổi quyền của tham chiếu kết nối bao gồm cả chia sẻ.

Xem thêm

Đầu nối