Παρακολούθηση Εργασιών Αποστολής με Συνδρομές

Οι ροές send και σχετικές επιστρέφουν ένα αναγνωριστικό εργασίας και συνεχίζουν ασύγχρονα.

Για πραγματικό χρόνο UX παραγωγής, προτιμήστε τις συνδρομές αντί για polling του task.

Για το γενικό σχήμα γεγονότος, δείτε το Μορφότυπο Γεγονότος Συνδρομής.

Ροή και Κατηγορία

Τα γεγονότα εργασίας παραδίδονται στο:

• subscribeGroupFeed

Χρησιμοποιούν:

• category: "task"

Ονόματα Γεγονότων Εργασίας

Τα τρέχοντα γεγονότα ροής εργασίας περιλαμβάνουν:

• taskDocumentCreated
• taskCompleted
• taskStoppedByRecipientStopList
• taskTrialCreditBlocked
• taskCreditBlocked

Φορτίο Γεγονότος Εργασίας

Τα φορτία εργασίας χρησιμοποιούν αυτή τη βασική μορφή:

{
  "version": "1.0",
  "eventId": "evt...",
  "timestamp": "2026-04-24T10:38:36.822Z",
  "level": "INFO",
  "event": "taskCompleted",
  "category": "task",
  "groupId": "grp...",
  "userId": "usr...",
  "requestId": null,
  "batchId": "bch...",
  "error": null,
  "data": {
    "id": "tsk...",
    "code": "TSKPROCESSOK",
    "documents": []
  }
}

Ενέργεια Συνδρομής

subscription SubscribeGroupFeed($groupId: String!) {
  subscribeGroupFeed(groupId: $groupId) {
    groupId
    data
  }
}

Παράδειγμα JavaScript

const parseEnvelope = (payload) => {
  const raw = payload?.data;
  if (!raw) return null;
  return typeof raw === 'string' ? JSON.parse(raw) : raw;
};

const handleGroupFeed = ({ data }) => {
  const wrapper = data?.subscribeGroupFeed;
  const event = parseEnvelope(wrapper);

  if (event?.category !== 'task') return;

  switch (event.event) {
    case 'taskCompleted':
      console.log('send task completed', event.data.id);
      break;
    case 'taskDocumentCreated':
      console.log('document created inside task', event.data.documents);
      break;
    case 'taskCreditBlocked':
    case 'taskTrialCreditBlocked':
    case 'taskStoppedByRecipientStopList':
      console.warn('task blocked', event.event, event.data.code);
      break;
    default:
      console.log('task update', event.event, event.data);
  }
};

Polling έναντι Συνδρομών

Το polling του ερωτήματος task είναι κατάλληλο για:

• να ξεκινήσετε
• απλά σενάρια
• αποσφαλμάτωση

Οι συνδρομές είναι καλύτερες όταν θέλετε:

• άμεσες ενημερώσεις διεπαφής χρήστη
• πρόοδο αποστολής που αναπαρίσταται ζωντανά σε έναν πίνακα ελέγχου
• ειδοποιήσεις ροής εργασίας χωρίς επαναλαμβανόμενο polling