Loading
Salesforce uitbreiden met klikken, en niet code
Aanroepen en callbacks: Limieten en gebruik

Aanroepen en callbacks: Limieten en gebruik

Limieten en beste benaderingen voor callbacks en aanroepen van en naar Externe services.

Vereiste editions

Beschikbaar in: Lightning Experience
Beschikbaar in: Enterprise, Performance, Unlimited en Developer Edition
  • Aanroepen van externe services zijn niet toegestaan wanneer er transacties in behandeling zijn, die dus nog niet zijn vastgelegd.
    • Sluit uw transactie in Flow en hervat Flow met behulp van het stroomelement Onderbreken.
    • Voer in Apex de aanroep uit vóór een DML-instructie zoals het invoegen, bijwerken of verwijderen van objecten. Zie Callout Limits and Limitations in de Apex Developer Guide.
  • Time-out voor aanroepen naar Externe services na 120 seconden.

Externe services Asynchrone callbacks

Opmerking
Opmerking De asynchrone callbackbewerkingen van Externe services worden wel ondersteund in Apex, maar niet in Flow.

De time-outduur van een call-backbewerking wordt geconfigureerd in de Apex client en kan worden ingesteld op maximaal vierentwintig uur.

Geaccepteerde callback-HTTP-methoden zijn PUT en POST. Alle andere methoden worden genegeerd.

Eén callbackparameter mag slechts één callbackbewerking bevatten, aangezien een één-op-veel relatie niet wordt ondersteund. Als één-op-veel wordt gedetecteerd, wordt alleen de eerste callbackbewerking onder de callbackparameter verwerkt.

In Voorbeeld-API-specificatie met call-backbewerking is de eerste call-backparameter applicationOutcomeApproved. Het bevat één #ref/…/ApplicationApproved callbackbewerking. De derde callback-parameter is applicationError. Het bevat één "{$request.query.callbackUrlForErrorCases}": {"post": {.....}}} 3.3 callbackbewerking. We negeren de callbackbewerkingsresponsdeclaratie en sturen altijd 200, 404, 408 (time-out) of 500 HTTP-respons naar de callback-afzender.

Een callback-URL kan worden gedefinieerd als een queryparameter of worden toegevoegd aan de hoofdtekstparameter van het verzoek. Een callback-URL kan zijn:

  • een tekenreekstype
  • een eigenschap van een objecttype
  • een element van een array

Enkele geldige notaties voor callback-URL-expressies zijn:

  • '{$request.query.callbackUrl}'
  • '{$request.body#/callbackUrl}'
  • '{$request.body#/callbackUrl/1}'

Andere complexe expressies worden momenteel niet ondersteund. Bijvoorbeeld expressies met statische tekst in combinatie met variabele verwijzingen, of expressies die meerdere variabele verwijzingen hebben. In deze niet-ondersteunde gevallen wordt de callback als ongeldig beschouwd en wordt de bewerking geprobeerd als een synchrone aanroep met een time-out van 120 seconden.

Een callback-bewerking kan een operationId definiëren. Zie bijvoorbeeld in Voorbeeld-API-specificatie met callbackbewerking:

"operationId": "approvedCallback”

Deze operationId kan niet worden gedupliceerd met andere operationId - met een reguliere bewerking op het hoogste niveau

"operationId": "SubmitApplication”

of andere callback operationId.

Als een call-backbewerking geen operationId declareert, gebruikt Salesforce de verwijzingsnaam van de call-backcomponent als de operationId - in dit geval - ApplicationRejected.

Als de callback-bewerking inline wordt gedeclareerd, wordt de operationId ervan opgebouwd als

parentAsyncOperationId_CB_callbackParameterName

Bijvoorbeeld SubmitApplication_CB_applicationError.

 
Wordt geladen
Salesforce Help | Article