Các lệnh UrlCommand của Phoebus

1. Giới thiệu:


Các lệnh UrlCommand được sử dụng rất nhiều khi thiết kế giao diện Phoebus, khi thiết lập các script chạy ngầm. hoặc gõ thẳng lên ô lệnh của Phoebus.

UrlCommand cũng được dùng rất nhiều ở Phoebus Desktop.

Khi dùng với mobile Apps. Ta gán các câu lệnh UrlCommand vào nút lệnh, double tap, tap, hold actions thông qua converter Text2Command

Khi sử dụng ConverterParameter có thể chứa tham số trong các dấu ngoặc vuông [AddCode]. Các tham số này sẽ được thay thế bằng các giá trị từ ngữ cảnh (BindingContext) của câu lệnh.

2. Các lệnh liên quan tới User Interface (UI Commands)


2.1 Các lệnh liên quan đến OS của thiết bị:

  1. Mở browser : bắt đầu bằng http://
<Button Command={Binding Converter={StaticResource UrlCommand},
ConverterParameter='http://spc-technology.com'} />
  1. Gửi mail từ chương trình mail default của thiết bị : bắt đầu bằng mailto://
<Button Command={Binding Converter={StaticResource UrlCommand}, 
ConverterParameter='mailto://help@spc-technology.com?cc=info@spc-technology.com&bcc=secret@spc-technology.com&body=Enter Email Content'} />
  1. Gửi SMS từ chương trình tin nhắn default của thiết bị : bắt đầu bằng sms://
<Button Command={Binding Converter={StaticResource UrlCommand}, 
ConverterParameter='sms://090xxxxxxx|091xxxxxx@body=Enter SMS Content'} />
  1. Mở chương trình đã cài trong device: bắt đầu bằng tên_đăng_ký_của _chương_trình://
<Button Command={Binding Converter={StaticResource UrlCommand}, 
ConverterParameter='uber://'} />

2.2 Các lệnh Phoebus:

Tính năng Phoebus có thể là các mẩu tin Editable, Runable, hoặc Queryable Có $Action để trống hoặc là các action dùng để xem (View), sửa (Amend), tạo mới (Create), copy dữ liệu (Copy).

<Button Command={Binding Converter={StaticResource UrlCommand}, 
ConverterParameter='SPC.BO.LA.NA'} />

3. Các lệnh chạy ngầm (NonUI Commands)


Các lệnh chạy ngầm sẽ có $ActionInsert, InsertUpdate, Update, UpdateAll, Delete.

Thường các câu lệnh này được dùng để chạy trigger, script, PFA - Workflow Action.

4. Tham số là các hàm


Khi tham số dùng trong câu lệnh phải qua xử lý trước khi cung cấp cho câu lệnh. Ta có thể dùng hàm cung cấp bởi Phoebus để xử lý.

Ví dụ, ta mở Dashboard có mã được tính bởi công thức như sau:

TapCommandUrl="SPC.Dashboard?Code=DB_WF_ITEM_[$f_substring([WfCode],0,2)]&amp;P1=[TaskId]"

Để biết danh sách các hàm được hỗ trợ trong mobile app. Ta dùng lệnh =?

6f6c9787-0d5f-41f2-8e92-cce4016ba93b.UrlCommands

0af81440-578a-491d-9e01-ff61fd8c6671.UrlCommands

5. Các ký tự đặc biệt


Do câu lệnh là 1 phần của XML document nên nếu trong câu lệnh có một số ký tự mà XML sử dụng sẽ làm XML document bị lỗi. Ta sẽ cần thay thế chúng bằng các mã tương đương như sau:

Symbol (name) Escape Sequence
< (less-than) &#60; or &lt;
> (greater-than) &#62; or &gt;
& (ampersand) &#38; or &amp;
' (apostrophe or single quote) &#39; or \'
" (double-quote) &#34; or \"

Ngoài ra ta có thể dùng ký tự \ trước các ký tự khác nếu chúng ảnh hưởng tới công thức

Google for : XML escape character

Xem thêm


Updated on : 2020-06-18 07:30:18. by : . at T470-01.

Topic : UrlCommands