Neidio i’r prif gynnwys

Datrys Problemau Dilysu Anfon

Mae piblin anfon yn dilysu ei mewnbwn cyn i greu dogfen ddechrau. Os bydd y dilysu yn methu, mae’r mutasiwn yn dychwelyd y gwall yn syth yn ôl i’r cleient ac ni chaiff unrhyw ID tasg ei ddychwelyd.

Mae hyn yn berthnasol i:

Copïwch ar gyfer Eich AI​

Defnyddiwch hwn wrth argyfeirio offeryn AI i helpu gyda llifoedd gwaith anfon Legalesign GraphQL:

Use the Legalesign GraphQL send validation rules below as the source of truth.

- Treat send input as strictly validated JSON.
- If send input is invalid, the mutation returns an error immediately and no task ID is returned.
- Only poll task after send succeeds and returns a task ID.
- For send workflows, monitor task.report.status until it reaches COMPLETED or FAILED.
- Prefer subscriptions over polling for production real-time UX.
- groupId, templateId, title, and recipients are required.
- Base64 IDs must decode to the expected prefixes:
  groupId=grp, templateId=tpl, roleId=rol, scheduleId=sch, experience=exp, field id=ele, attachment id=att.
- recipients must contain fewer than 200 items.
- Each recipient must include email and order.
- The input must include an initial recipient: either order 0, or order 1 when roleId is provided.
- The recipient with the lowest order number must have a non-empty email.
- title must be 1028 characters or fewer.
- tag must be 250 characters or fewer.
- pdfPassword must be 150 characters or fewer.
- documentCCEmail must contain 10 email addresses or fewer.
- redirect must be a valid URI or null.

Os oes angen canllawiau mwy manwl ar yr AI, cyfeiriwch ef i’r dudalen hon.

Crynodeb AI​

  • Ymdrinnwch â mewnbwn send fel JSON llym gyda rheolau dilysu.
  • Os yw mewnbwn send yn annilys, mae’r mutasiwn yn dychwelyd gwall yn syth ac nid oes ID tasg yn cael ei ddychwelyd.
  • Dim ond chwilio task ar ôl i send lwyddo a dychwelyd ID tasg.
  • Ar gyfer llifoedd gwaith anfon, monitro task.report.status nes ei fod yn cyrraedd COMPLETED neu FAILED.
  • Ar gyfer UX amser real cynhyrchu, dewiswch danysgrifio yn hytrach na chwilio.

Sut i Ganfod Methiant Dilysu​

Rhedwch y mutasiwn fel arfer.

  • Os yw’r mewnbwn yn annilys, mae’r mutasiwn yn dychwelyd gwall dilysu yn syth.
  • Os yw’r mewnbwn yn ddilys, mae’r mutasiwn yn dychwelyd ID tasg ac mae creu’r ddogfen yn parhau’n asynchroneg.

Mae hynny’n golygu bod datrys problemau dilysu yn digwydd ar amser y mutasiwn, nid drwy’r ymholiad task.

Dim ond dechrau chwilio task ar ôl i send lwyddo a dychwelyd ID tasg.

Pa Math o Wallau Y gallwch Eu Disgwyl​

Mae’r dilysydd anfon yn gwirio siap a chynnwys JSON y mewnbwn cyn i’r broses barhau. Mae methiannau dilysu’n benodol i’r maes a fethodd, er enghraifft:

  • send input missing required field 'groupId'
  • send input.groupId must be a base64-encoded group id
  • send input.recipients must include a recipient with order 0, or order 1 when roleId is provided
  • recipients[0].email must be a valid email
  • recipients[1].attachments[0] must be a base64-encoded attachment id

Problemau Cyffredin Dilysu​

Maesau Hanfodol Arddull Uchaf Ar Goll​

Mae’r meysydd hyn yn ofynnol:

  • groupId
  • templateId
  • title
  • recipients

IDau Codwyd yn Annilys​

Mae’r dilysydd yn gwirio bod IDau’n codwyd mewn base64 ac yn cynnwys y rhagddodiad dadgodwyd a ddisgwylir:

  • groupId -> grp
  • templateId -> tpl
  • roleId -> rol
  • scheduleId -> sch
  • experience -> exp
  • maes id -> ele
  • atodiad id -> att

Problemau Trefnu Derbynnydd​

Rhaid i fewnbwn anfon gynnwys derbynnydd cychwynnol:

  • naill ai dderbynnydd gyda order: 0
  • neu dderbynnydd gyda order: 1 pan fo roleId wedi’i ddarparu

Hefyd, rhaid i’r derbynnydd gyda’r rhif archeb isaf gael email nad yw’n wag.

Terfynau Maes Derbynnydd​

Mae rheolau dilysu derbynnydd cyffredin yn cynnwys:

  • rhaid i email fod yn gyfreithlon ac yn 75 nod neu llai
  • rhaid i firstName a lastName fod yn 60 nod neu llai
  • rhaid i phoneNumber fod yn 120 nod neu llai
  • rhaid i message fod yn 10000 nod neu lai
  • rhaid i expiryDate fod yn ddyddiad ac amser ISO 8601 dilys neu null
  • rhaid i ccEmail fod yn e-bost dilys
  • rhaid i ccIncludeLink fod yn bolariwdd

Terfynau Maes Arddull Uchaf​

Mae rheolau dilysu lefel anfon cyffredin yn cynnwys:

  • rhaid i title fod yn 1028 nod neu lai
  • rhaid i tag fod yn 250 nod neu lai
  • rhaid i pdfPassword fod yn 150 nod neu lai
  • rhaid i documentCCEmail gynnwys dim ond 10 cyfeiriad e-bost neu lai
  • rhaid i redirect fod yn URI dilys neu null
  • rhaid i recipients gynnwys llai na 200 eitem
  • rhaid i senderFields a participantFields gynnwys llai na 1000 eitem yn unigol

Payloads Atod neu Maes Amogaeth Annilys​

Os byddwch yn mewnlino amserlenni neu werthoedd maes derbynnydd:

  • rhaid i bob eitem amserlen gynnwys daysAfter, frequency, when, timeOfDay, subject, message, a skipWeekend
  • mae when amserlen yn rhaid bod yn un o’r 1, 2, neu 3
  • mae subject ac message amserlen yn rhaid bod yn 500 nod neu lai
  • rhaid i bob mewnbwn maes gynnwys ID elfen dilys
  1. Dilyswch eich payload yn lleol gyda’r Send Input JSON Schema.
  2. Rhedwch y mutasiwn.
  3. Os yw’r mutasiwn yn dychwelyd gwall dilysu, cywiro’r payload a cheisio eto.
  4. Os yw’r mutasiwn yn dychwelyd ID tasg, dechreuwch chwilio task i fonitro’r creu dogfen.

Pryd i Ddefnyddio Tanysgrifiadau Yn Lle​

Mae chwilio task yn addas i ddechrau, profi, a chreu patrwm.

Ar gyfer llifoedd gwaith cynhyrchu, defnyddiwch danysgrifiadau ar gyfer diweddariadau amser real a thrin statws tasg a chwiliwyd fel newyddion wrth gefn neu offer cynllunio prototeipio.

Am ganllaw tanysgrifiad penodol i dasgau, gweler Track Send Tasks with Subscriptions.

Export This Article

Save a copy of this page as PDF or plain text.