Холбоос шошго (Connection Tags)

Холбоос шошго (Connection Tags)-ууд нь холбогдсон блокуудын өгөгдлийг харагдахуйц байдлаар төлөөлж, workflow доторх өмнөх блокуудын гаргалтыг дараагийн блокуудад хялбархан ашиглах боломж олгодог.

Холбоос шошго (Connection Tag) гэж юу вэ?

Холбоос шошго (Connection Tag) нь блокууд хоорондоо холбогдсон үед автоматаар гарч ирдэг интерактив элементүүд юм. Эдгээр нь нэг блокоос нөгөөд дамжих боломжтой өгөгдлийг илэрхийлж, дараах боломжуудыг олгодог:

Эх сурвалж блокоос ямар өгөгдөл боломжтойг харах
Очих блок дотор тодорхой өгөгдлийн талбарыг зааж ашиглах
Блокуудын хооронд динамик өгөгдлийн урсгал үүсгэх

Connection tag нь өмнөх блокуудын ямар өгөгдөл боломжтойг шууд харах, мөн төвөгтэй өгөгдлийн бүтцийг цээжлэхгүйгээр тухайн өгөгдлийг ашиглахад тусалдаг.

Connection Tag ашиглах

Workflow-д connection tag ашиглах хоёр үндсэн арга байдаг:

Чирж байрлуулах (Drag and Drop)

Connection tag дээр дарж, очих блокийн оролтын талбар руу чирнэ. Ингэхэд боломжит утгуудыг харуулсан dropdown цэс гарч ирнэ.

Connection tag дээр хулганаа аваачиж боломжит өгөгдлийг харна
Tag-ийг дарж, оролтын талбар руу чирнэ
Dropdown-оос ашиглах өгөгдлийн талбарыг сонгоно
Сонгосон reference автоматаар оруулагдана

Өнцөгт хаалттай синтакс (Angle Bracket Syntax)

Оролтын талбар дотор <> гэж бичихэд өмнөх блокуудын боломжит connection утгуудыг харуулсан dropdown гарч ирнэ.

Холбогдсон өгөгдөл ашиглахыг хүссэн оролтын талбарт дарна
<> гэж бичиж connection dropdown-ийг идэвхжүүлнэ
Хэрэглэх өгөгдлөө хайж, сонгоно
Үргэлжлүүлэн бичих эсвэл dropdown-оос сонгон reference-ийг гүйцээнэ

Tag-ийн синтакс

Connection tag нь өгөгдөл заах энгийн синтакс ашигладаг:

<blockName.path.to.data>

Энд:

blockName — эх сурвалж блокийн нэр
path.to.data — тухайн өгөгдлийн талбар хүртэлх зам

Жишээ нь:

<agent1.content> — "agent1" ID-тай блокийн content талбарыг заана
<api2.data.users[0].name> — "api2" ID-тай блокийн data доторх users массивын эхний хэрэглэгчийн нэрийг заана

Динамик Tag Reference

Connection tag нь runtime үед үнэлэгддэг тул:

Үргэлж хамгийн сүүлийн, бодит өгөгдлийг заана
Илэрхийлэлд ашиглах, статик тексттэй хослуулах боломжтой
Бусад өгөгдлийн бүтцийн дотор nested хэлбэрээр ашиглаж болно

Жишээ

// Текст дотор reference ашиглах
"The user's name is <userBlock.name>"

// JSON дотор reference ашиглах
{
  "userName": "<userBlock.name>",
  "orderTotal": <apiBlock.data.total>
}

// Код дотор reference ашиглах
const greeting = "Hello, <userBlock.name>!";
const total = <apiBlock.data.total> * 1.1; // 10% татвар нэмэх

Тоон (numeric) нөхцөлд connection tag ашиглах үед тухайн reference нь үнэхээр тоон утга эсэхийг шалгаарай. Үгүй бол type хөрвүүлэлтийн алдаа үүсч болзошгүй.