Olrhain Tasgau Anfon gyda Tanysgrifiadau

Mae send a llifau cysylltiedig yn dychwelyd ID tasg ac yn parhau'n asyncronig.

Ar gyfer profiad defnydd amser-real cynhyrchu, dewiswch danysgrifiadau dros y pwyntio ar task.

Ar gyfer y schema digwyddiad cyffredinol, gweler Fformat Digwyddiad Tanysgrifiad.

Ffryd a Categori

Caiff digwyddiadau tasg eu cyflwyno ar:

• subscribeGroupFeed

Maent yn defnyddio:

• category: "task"

Enwau Digwyddiadau Tasg

Yn cynnwys digwyddiadau llif gwaith tasg cyfredol:

• taskDocumentCreated
• taskCompleted
• taskStoppedByRecipientStopList
• taskTrialCreditBlocked
• taskCreditBlocked

Payload Digwyddiad Tasg

Mae payloads tasg yn defnyddio'r siâp sylfaenol hwn:

{
  "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": []
  }
}

Gweithrediad Tanysgrifiad

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

Enghraifft 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);
  }
};

Pwyntio vs Tanysgrifiadau

Mae pwyntio'r ymholiad task yn iawn ar gyfer:

• cychwyn
• sgriptiau syml
• dadansoddi gwallau

Mae tanysgrifiadau yn well pan ydych eisiau:

• diweddariadau UI ar unwaith
• cynnydd anfon yn cael ei adlewyrchu'n fyw mewn bwrdd gwaith
• hysbysiadau llif gwaith heb bwyntio wedi'i ailadrodd