مهمة
يمثل كائن المهمة مهمة واحدة أنجزها مستخدم أو يجري إنجازها. فعلى سبيل المثال، يمكن نمذجة الاتصال بعميل محتمل أو الانتقال إلى موقع ميداني على أنهما مهمتان.
تُعرَّف المهمة في جوهرها من خلال الحقول التالية
status
يمكن أن تكون لكل مهمة إحدى الحالات التالية
- OPEN
- COMPLETED
- CANCELLED عند العمل على مهمة، تكون حالتها
OPEN. ويمكن إنشاء مهمة بالحالةCOMPLETED، وهذا ما نشير إليه بتسجيل مهمة.
data
data هو حقل JSON يحتوي على البيانات الفعلية التي تحدد مثيل المهمة. والمفتاح إما shortId أو id لسمة المهمة. تنشر جميع واجهات API الداخلية بيانات المهام على شكل أزواج id:value، بينما تنشر واجهات API الخارجية البيانات على شكل أزواج shortId:value.
مثال:
{ "primary_disposition": "CALLBACK", "when_to_callback": 1634025183219, "first_name": "Cixin", "last_name": "Liu", "remarks": "lead wants a callback"}الحقول
الاسم | نوع البيانات | معلومات النوع | الوصف |
|---|---|---|---|
id | string | uuid | معرّف المهمة — يُنشأ تلقائيًا |
title | string |
| عنوان المهمة |
description | string |
| وصف المهمة |
order | number |
| ترتيب المهمة |
status | string |
| يمكن أن تكون OPEN أو COMPLETED أو CANCELLED |
team | string | uuid | معرّف الفريق الذي تنتمي إليه هذه المهمة |
stateTask | string | uuid | معرّف statetask الذي يحدد مخطط هذه المهمة |
taskType | string |
| نوع المهمة |
createdBy | string | uuid | معرّف المستخدم الذي أنشأ المهمة |
assignedTo | string | uuid | معرّف المستخدم المعيّن إليه هذه المهمة |
belongsTo | string | uuid | معرّف الـ pod الذي تنتمي إليه هذه المهمة |
startsAt | number | epoch ms | التاريخ والوقت اللذان بدأت فيهما المهمة |
endsAt | number | epoch ms | التاريخ والوقت اللذان تنتهي فيهما هذه المهمة |
dueBy | number | epoch ms | التاريخ والوقت اللذان يجب إكمال المهمة بحلولهما |
startedAt | number | epoch ms | التاريخ والوقت اللذان بدأت فيهما المهمة فعليًا |
completedAt | number | epoch ms | التاريخ والوقت اللذان اكتملت فيهما المهمة فعليًا |
cancelledAt | number | epoch ms | التاريخ والوقت اللذان أُلغيت فيهما المهمة |
procedure | string | uuid | معرّف الإجراء الذي تنتمي إليه هذه المهمة |
task | string | uuid | معرّف المهمة المرتبطة بهذه المهمة |
entity | string | uuid | معرّف الكيان الخاص بالسجل المرتبط بهذه المهمة |
record | string | uuid | معرّف السجل المرتبط بهذه المهمة |
form | string | uuid | معرّف النموذج المرتبط بهذه المهمة |
الأعضاء | json |
| قائمة بمعرّفات المستخدمين المشاركين أيضًا في المهمة |
البيانات | json |
| كائن json بصيغة id:value يخزن البيانات الفعلية |
derivedData | json |
| كائن json بصيغة id:value يخزن البيانات المشتقة |
createdAt | number | epoch ms | الطابع الزمني لوقت إنشاء المهمة |
updatedAt | number | epoch ms | الطابع الزمني لوقت تحديث المهمة |
isDeleted | قيمة منطقية |
| علامة تشير إلى ما إذا كانت هذه المهمة محذوفة أم لا |