Chia sẻ qua

Kiểu dữ liệu của biến

  • Bài viết

Khi bạn tạo các biến trong luồng của mình, Power Automate hãy chuyển đổi chúng thành một loại cụ thể dựa trên nội dung của chúng.

Một số loại dữ liệu này được sử dụng rộng rãi trong toàn bộ ứng dụng, chẳng hạn như số, trong khi các loại dữ liệu khác, chẳng hạn như phiên bản trình duyệt, yêu cầu các hành động hoặc nhóm hành động rõ ràng.

Các kiểu dữ liệu đơn giản

Các kiểu dữ liệu đơn giản biểu thị các giá trị đơn lẻ, chẳng hạn như văn bản và số. Bạn có thể sử dụng các kiểu dữ liệu này một cách độc lập hoặc sử dụng chúng để tạo các cấu trúc dữ liệu phức tạp hơn, chẳng hạn như danh sách và bảng dữ liệu.

Giá trị văn bản

Đây là bất kỳ loại văn bản nào, từ địa chỉ email đến nội dung văn bản của tệp .txt.

Thuộc tính kiểu dữ liệu văn bản

Để tạo biến giá trị văn bản , hãy sử dụng hành động Đặt biến và điền vào tham số đầu vào văn bản mong muốn mà không cần bất kỳ ký hiệu nào.

Ảnh chụp màn hình của hành động Đặt biến tạo biến giá trị Văn bản.

Giá trị số

Số là loại được áp dụng cho số. Chỉ loại dữ liệu này mới có thể được sử dụng trong các phép toán.

Để tạo một biến Giá trị số , hãy sử dụng hành động Đặt biến và điền vào tham số đầu vào một số mà không có bất kỳ số nào ký hiệu.

Ngoại trừ các giá trị số được mã hóa cứng, bạn có thể sử dụng các biểu thức toán học với các biến nằm trong dấu phần trăm. Để biết thêm thông tin về biểu thức toán học, hãy chuyển đến Sử dụng biến và ký hiệu %.

Ảnh chụp màn hình của hành động Đặt biến tạo biến giá trị Số.

Giá trị Boolean

Giá trị có thể là Đúng hoặc Sai.

Để tạo một biến giá trị Boolean , hãy sử dụng hành động Đặt biến và điền tham số đầu vào bằng các biểu thức %True% hoặc %False%.

Ngoài ra, bạn có thể tạo các biểu thức phức tạp bằng cách sử dụng toán tử logic, biến và ký hiệu phần trăm. Để biết thêm thông tin về biểu thức logic, hãy truy cập Sử dụng biến và ký hiệu %.

Ảnh chụp màn hình của hành động Đặt biến tạo biến giá trị Boolean.

Các kiểu dữ liệu nâng cao

Các kiểu dữ liệu nâng cao thể hiện các cấu trúc dữ liệu phức tạp. Chúng hoạt động như tập hợp các loại dữ liệu khác mà bạn có thể truy cập dưới dạng một thực thể.

Danh sách

Danh sách là tập hợp các mục. Tùy thuộc vào loại mục danh sách riêng lẻ, có thể có danh sách giá trị văn bản, danh sách giá trị số, v.v. Kiểu dữ liệu danh sách tương đương với mảng một chiều trong thuật ngữ lập trình.

Bạn có thể tạo danh sách thông qua hành động Tạo danh sách mới và thêm một mục vào danh sách đó thông qua hành động Thêm mục vào danh sách hành động.

Ảnh chụp màn hình của quy trình tạo danh sách.

Bạn cũng có thể tạo danh sách thông qua các hành động tạo danh sách dưới dạng đầu ra. Ví dụ: hành động Đọc văn bản từ tệp có thể trả về danh sách các giá trị văn bản và hành động Nhận tệp trong thư mục hành động trả về một danh sách các tập tin.

Để truy xuất một mục cụ thể trong danh sách, hãy sử dụng ký hiệu sau: %VariableName[ItemNumber]%

Trong ví dụ bên dưới, luồng lưu số đầu tiên của danh sách được hiển thị trước đó vào một biến mới. Hãy nhớ rằng chỉ mục phải là 0 cho mục đầu tiên của danh sách.

Ảnh chụp màn hình biểu thức truy cập mục đầu tiên của danh sách.

Một phương pháp phổ biến là sử dụng a Đối với mỗi hành động để lặp qua các mục trong danh sách.

Nếu bạn chỉ cần truy cập vào một phần cụ thể của danh sách, hãy sử dụng ký hiệu %VariableName[StartIndex:StopIndex]% . Ví dụ: biểu thức %List[2:4]% truy xuất mục thứ ba và thứ tư của danh sách. Mục ở vị trí StopIndex là ranh giới của phần cắt và không được truy xuất.

Để cắt một danh sách từ đầu thành một mục cụ thể, đừng đặt giá trị StartIndex , ví dụ: %List[:4] %. Để cắt một danh sách từ một chỉ mục cụ thể đến cuối, đừng đặt giá trị StopIndex , ví dụ: %List[2:] %.

Liệt kê thuộc tính kiểu dữ liệu

Bảng dữ liệu

Các bảng dữ liệu chứa dữ liệu ở dạng bảng và tương đương với mảng hai chiều trong thuật ngữ lập trình.

Một bảng dữ liệu chứa các hàng và cột mô tả vị trí của từng mục một cách duy nhất. Các bảng dữ liệu có thể được coi là các danh sách chứa các hàng dữ liệu dưới dạng các mục.

Ảnh chụp màn hình nội dung của một biến có thể dữ liệu.

Power Automate cung cấp hành động Tạo bảng dữ liệu mới để tạo các bảng dữ liệu mới. Sau khi triển khai hành động, bạn có thể sử dụng trình tạo trực quan để điền các giá trị và đổi tên các tiêu đề cột.

Ảnh chụp màn hình trình tạo trực quan của tác vụ Tạo bảng dữ liệu mới.

Ngoài hành động Tạo bảng dữ liệu mới , còn có ba hành động khác tạo bảng dữ liệu để lưu trữ dữ liệu được trích xuất: Đọc từ bảng tính Excel, Thực thi câu lệnh SQL và Trích xuất dữ liệu từ các hành động trên trang web .

Ngoài ra, bạn có thể tạo một bảng dữ liệu bằng cách sử dụng hành động Đặt biến và ký hiệu mảng lập trình. Ký hiệu này bao gồm nhiều mảng một chiều được phân tách bằng dấu phẩy và được đặt trong dấu ngoặc nhọn. Biểu thức cuối cùng phải có dạng sau: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Ảnh chụp màn hình Đặt hành động biến để tạo dữ liệu.

Nếu bạn muốn thêm tiêu đề cột trong khi tạo một dữ liệu mới bằng cách sử dụng ký hiệu mảng, hãy sử dụng biểu thức ^['ColumnName1', 'ColumnName2'] cho hàng đầu tiên.

Ảnh chụp màn hình của hành động Đặt biến nhằm tạo một bảng dữ liệu mới với các tiêu đề cột.

Để thêm hàng mới vào bảng hiện có, hãy sử dụng hành động Chèn hàng vào bảng dữ liệu . Ngoài ra, hãy tạo một biểu thức chứa tên biến của dữ liệu, ký tự dấu cộng (+) và các giá trị bạn muốn thêm vào trong ngoặc.

Ảnh chụp màn hình của hành động Đặt biến để thêm hàng mới vào bảng dữ liệu.

Bên cạnh việc chèn các hàng vào bảng dữ liệu, các luồng trên máy tính còn cung cấp nhiều hành động khác nhau để thao tác với bảng dữ liệu. Bạn có thể tìm thấy danh sách đầy đủ các hành động này trong tài liệu tham khảo về hành động biến đổi.

Để truy xuất một mục cụ thể của một dữ liệu, hãy sử dụng ký hiệu sau: %VariableName[RowNumber][ColumnNumber]%. Hãy nhớ rằng RowNumber và ColumnNumber phải là 0 cho mục đầu tiên (hàng hoặc cột).

Ví dụ: giả sử một luồng truy xuất nội dung của một trang tính Excel và lưu trữ nội dung đó trong biến ExcelData . Để truy cập vào ô đầu tiên ở hàng thứ hai của bảng được truy xuất, hãy sử dụng biểu thức được hiển thị bên dưới.

Ảnh chụp màn hình biểu thức truy cập vào ô thứ hai của hàng đầu tiên của tệp Excel đã đọc.

Lưu ý

Biến ExcelData chứa một bảng các giá trị được trích xuất từ ​​một bảng tính Excel bằng cách sử dụng tác vụ Đọc từ bảng tính Excel . Nó chứa một số giá trị của một bảng tính cụ thể chứ không phải toàn bộ tệp Excel.

Nếu bạn muốn truy cập vào một cột cụ thể trong một bảng dữ liệu có chứa tiêu đề cột, hãy sử dụng ký hiệu %ExcelData[rowNumber]['ColumnName']% .

Nếu bạn lặp qua một bảng dữ liệu có hành động Đối với mỗi , thì biến chứa dữ liệu của lần lặp hiện tại được coi là một hàng dữ liệu.

Tương tự như danh sách, bạn sử dụng ký hiệu %VariableName[StartRow:StopRow]% để truy cập vào một phần cụ thể của bảng dữ liệu. Biểu thức chỉ truy xuất các hàng được xác định bởi hai chỉ mục, trong khi vị trí StopRow là ranh giới của phần cắt và không được truy xuất.

Để cắt một dữ liệu từ hàng đầu tiên sang một hàng cụ thể, không sử dụng giá trị StartRow , ví dụ: %Datatable[:4 %. Tương tự, để cắt một dữ liệu từ một hàng cụ thể đến cuối, không sử dụng giá trị StopRow , ví dụ: %Datatable[2 :]%.

Thuộc tính kiểu dữ liệu có thể truy cập

Hàng dữ liệu

Một hàng dữ liệu chứa các giá trị của một hàng của một dữ liệu. Khi bạn lặp qua một dữ liệu có thể định vị bằng một Đối với mỗi hành động , biến chứa dữ liệu của lần lặp hiện tại là một hàng dữ liệu.

Để truy xuất một mục cụ thể của một hàng dữ liệu, hãy sử dụng ký hiệu sau: %VariableName[ItemNumber]%

Ngoài ra, bạn có thể sử dụng ký hiệu %VariableName['ColumnName']% . Tên của mỗi cột được xác định bởi dữ liệu mà bạn đã truy xuất hàng dữ liệu.

Thuộc tính kiểu dữ liệu Datarow

Ảnh chụp màn hình nội dung của biến datarow.

Đối tượng tùy chỉnh

Chứa các cặp thuộc tính và giá trị, có thể dễ dàng chuyển đổi sang định dạng JSON.

Để tạo một đối tượng trống Đối tượng tùy chỉnh mới, hãy sử dụng hành động Đặt biến và điền vào biểu thức sau %{{ }}%. Để tạo một Đối tượng tùy chỉnh mới và khởi tạo đối tượng đó bằng các thuộc tính và giá trị, hãy sử dụng biểu thức có cấu trúc sau: %{ 'Thuộc tính1': 'Giá trị1', 'Thuộc tính2': 'Giá trị2', 'Thuộc tính3': 'Giá trị2' }%.

Ảnh chụp màn hình Đặt hành động biến để tạo đối tượng tùy chỉnh mới.

Quan trọng

Không thể sử dụng từ khóa dành riêng làm thuộc tính đối tượng tùy chỉnh. Để biết danh sách đầy đủ các từ khóa dành riêng, hãy truy cập Từ khóa dành riêng trong luồng máy tính để bàn.

Để cập nhật giá trị của một thuộc tính hiện có hoặc thêm một thuộc tính mới, hãy triển khai hành động Đặt biến , điền tên thuộc tính vào Set và nhập giá trị của nó vào trường Tới .

Ảnh chụp màn hình của hành động Đặt biến để thêm thuộc tính mới vào đối tượng tùy chỉnh.

Ngoài các giá trị bằng chữ, bạn có thể sử dụng các biến để tự động đặt thuộc tính và giá trị của đối tượng tùy chỉnh. Ví dụ: quy trình sau đây sử dụng hai biến để thêm thuộc tính mới vào một đối tượng tùy chỉnh trống mới.

Ảnh chụp màn hình của một quy trình sử dụng các biến để thêm thuộc tính mới vào đối tượng tùy chỉnh.

Đối tượng của trình kết nối

Đối tượng trình kết nối lưu trữ thông tin từ trình kết nối đám mây và hoạt động tương tự như các đối tượng tùy chỉnh. Thuộc tính của chúng thường chứa danh sách các đối tượng kết nối khác. Việc truy cập các giá trị hoạt động giống như trong các đối tượng tùy chỉnh, mặc dù việc truy cập các giá trị lồng nhau có thể yêu cầu các biểu thức phức tạp hơn.

Ảnh chụp màn hình của biến đối tượng tùy chỉnh trong trình xem biến.

Danh sách thông tin bảng PDF

Biến thuộc loại dữ liệu này chỉ có thể được tạo thông qua hành động Trích xuất bảng từ PDF .

Mỗi mục trong danh sách mô tả một bảng được trích xuất và cung cấp tất cả thông tin cần thiết về nó. Để truy cập một mục thông tin có thể dữ liệu cụ thể, hãy sử dụng ký hiệu %VariableName[ItemNumber]% .

Ảnh chụp màn hình Danh sách thông tin bảng PDF.

Mỗi mục danh sách cung cấp bốn thuộc tính cho phép bạn nhận được một chi tiết cụ thể một cách độc lập. Các thuộc tính có sẵn như sau:

  • DataTable – Trả về bảng được trích xuất.
  • TableStartingPage – Trả về chỉ mục của trang tệp chứa phần đầu của bảng.
  • TableEndingPage – Trả về chỉ mục của trang tệp chứa phần cuối của bảng.
  • TableOrderInPage – Trả về thứ tự của bảng trên trang.

Bạn có thể tìm thêm thông tin về các thuộc tính của loại dữ liệu này trong Thuộc tính kiểu dữ liệu biến.

Ảnh chụp màn hình thuộc tính của danh sách thông tin bảng PDF.

Để truy cập giá trị của một thuộc tính cụ thể, hãy sử dụng ký hiệu %VariableName[ItemNumber].PropertyName% . Ví dụ: biểu thức sau trả về giá trị có thể dữ liệu của mục đầu tiên của biến ExtractedPDFTables .

Ảnh chụp màn hình của dữ liệu có trong danh sách các biến thông tin bảng PDF.

Các sự cố và giới hạn đã biết

  • Sự cố: Khi một ô có thể lập dữ liệu hoặc hàng dữ liệu chứa mục nhập nhiều dòng, trình xem biến chỉ hiển thị dòng đầu tiên của mục đó.
  • Cách giải quyết: Không.

Phiên bản

Kết nối

Khác

Phần này trình bày tất cả các kiểu dữ liệu có sẵn không thuộc bất kỳ danh mục nào trước đó.

Giá trị chung

  • Giá trị chung – Kiểu dữ liệu này được sử dụng trong thời gian thiết kế khi Power Automate không thể xác định kiểu dữ liệu của biến hoặc tham số đầu vào. Các giá trị chung được chuyển đổi sang các kiểu dữ liệu khác trong thời gian chạy dựa trên dữ liệu của chúng.

Active Directory

  • Mục nhập Active Directory - Chứa kết nối đến máy chủ Active Directory được thiết lập thông qua hành động Kết nối với máy chủ .
  • Thông tin nhóm – Chứa tên, tên hiển thị, mô tả và các thành viên của một nhóm Active Directory được chỉ định.
  • Thành viên nhóm – Đại diện cho một thành viên của một nhóm Active Directory được chỉ định.
  • Thông tin người dùng – Chứa thông tin về người dùng Active Directory được chỉ định, chẳng hạn như tên đầu tiên và họ, tên viết tắt và tên phân biệt, chi tiết công việc (công ty, bộ phận và chức danh), thông tin liên hệ (số điện thoại, số máy lẻ và email) và vị trí (quốc gia / khu vực, thành phố, tiểu bang, địa chỉ đường phố và mã bưu chính).

Thuộc tính kiểu dữ liệu Active Directory

Amazon Web Services (AWS)

  • Máy khách EC2 – Chứa phiên EC2 được tạo thông qua hành động Tạo phiên EC2.
  • Phiên bản EC2 – Đại diện cho phiên bản EC2 được truy xuất.
  • Thông tin phiên bản EC2 – Chứa thông tin về phiên bản EC2.
  • Thay đổi trạng thái phiên bản – Chứa thông tin về phiên bản EC2 đã được khởi động hoặc dừng.
  • Ảnh chụp nhanh EBS- Đại diện cho ảnh chụp nhanh EBS.
  • Khối lượng EBS- Đại diện cho một ổ đĩa EBS.

Thuộc tính kiểu dữ liệu AWS

Azure

  • Azure client – Chứa phiên Azure được tạo thông qua hành động Tạo phiên .
  • Azure resource group – Đại diện cho một nhóm tài nguyên Azure được truy xuất.
  • Azure managed disk – Đại diện cho một đĩa Azure đã truy xuất.
  • Azure snapshot – Đại diện cho ảnh chụp nhanh Azure.
  • Azure virtual machine – Đại diện cho một máy ảo Azure được truy xuất.
  • Thông tin máy ảo Azure- Chứa thông tin về máy ảo Azure.
  • Đăng ký Azure– Đại diện cho đăng ký Azure đã truy xuất.

Thuộc tính kiểu dữ liệu Azure

CMD

  • CMD session– Chứa một phiên CMD được tạo thông qua hành động Open CMD session .

Thuộc tính kiểu dữ liệu CMD

Ngày và giờ

  • Datetime - Chứa thông tin ngày và giờ. Để tạo biến datetime thông qua hành động Đặt biến , hãy điền tham số đầu vào với các biểu thức %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, trong đó:

    Ký hiệu Description
    yyyy Năm
    MM Tháng
    dd Ngày
    HH Giờ
    mm Phút
    ss Giây
    Ff Mili giây
    zzz Phần bù UTC

    Ví dụ: %d "2022-03-25"% gán ngày 25 tháng 3 năm 2022 cho biến đích.

Thuộc tính kiểu dữ liệu ngày và giờ

Email

  • Tin nhắn thư- Đại diện cho một email. Hành động Truy xuất email điền các biến này.

Thuộc tính kiểu dữ liệu email

Exchange

  • Thư trao đổi- Đại diện cho một email được truy xuất từ máy chủ Exchange. Hành động Truy xuất thư email Exchange điền các biến này.

Thuộc tính kiểu dữ liệu Exchange

Tệp và thư mục

  • Tập tin- Đại diện cho một tập tin .
  • Thư mục- Đại diện cho một thư mục .
  • FileSystemObject - Đại diện cho một thư mục hoặc một tập tin. Kiểu dữ liệu này được sử dụng trong các tham số đầu vào chấp nhận các thư mục và tệp.

Thuộc tính kiểu dữ liệu tệp và thư mục

FTP

  • Tệp FTP- Đại diện cho một tệp FTP.
  • Thư mục FTP – Đại diện cho một thư mục FTP

Thuộc tính kiểu dữ liệu FTP

OCR

  • OCR Engine - Chứa một công cụ OCR được tạo thông qua hành động Tạo công cụ OCR.

Outlook

  • Thư Outlook- Đại diện cho một email Outlook. Hành động Truy xuất thư email từ Outlook điền các biến này.

Thuộc tính kiểu dữ liệu Outlook

Terminal

  • Terminal session– Chứa một terminal session được tạo thông qua hành động Open terminal session.

Thuộc tính kiểu dữ liệu đầu cuối

XML

  • XML node – Chứa nội dung của một tài liệu XML. Hành động Đọc XML từ tệp điền các biến này.

Thuộc tính kiểu dữ liệu XML

Lỗi

  • Lỗi - Chứa thông tin về lỗi xảy ra lần cuối trong quy trình máy tính để bàn. Hành động Nhận lỗi cuối cùng tạo loại biến này.

Thuộc tính lỗi