MuleSoft pour flux : Limites et considérations relatives à l'intégration

Limitations d'ordre général

• MuleSoft pour flux : L'intégration prend en charge uniquement la présentation automatique, pas la forme libre.
• Vous ne pouvez pas utiliser la Vue de la transformation pour la sortie d'un flux déclenché par une modification du système externe directement. Sélectionnez un champ dans la sortie $Event de la vue en ligne, puis basculez vers la vue Transformer pour utiliser ces données en tant que données sources.
• La vue Transformer prend en charge les constantes globales True ou False des valeurs littérales booléennes. Sélectionnez la constante dans les options disponibles. Ne le saisissez pas manuellement.

Atteinte des limites en flux par transaction

Si votre flux inclut plusieurs actions et échoue parce qu'il atteint les limites par transaction, insérez un élément Attente avant l'action dans votre flux. En définissant le temps d'attente sur 1 minute, le système peut traiter les modifications avant de continuer, ce qui facilite la gestion de l'utilisation des ressources et garantit le bon déroulement du workflow.

Test des flux déclenchés par une modification du système externe et des flux en utilisant des connecteurs tiers

Le nombre maximal d'enregistrements renvoyés par un test est de 5 lors du test d'un flux déclenché par une modification du système externe ou d'un flux qui utilise un connecteur tiers.

Déclencheurs manqués dans les automatisations de flux basées sur des sondages

Lors de l'interrogation d'un flux, les automatisations de flux peuvent parfois manquer des déclencheurs.

Traitement des échecs d'interrogation déclenchés par une modification du système externe

Important

Les flux déclenchés par une modification du système externe utilisent un scrutateur pour récupérer les enregistrements dans la planification sélectionnée.

Comportement et désactivation des sondages

• Récupérations: Lorsque l'interrogation échoue, le flux réessaie jusqu'à 3 fois consécutives.
• Désactivation automatique : Se produit après le troisième échec consécutif du sondage. Ce comportement s'applique aux échecs au niveau du scrutateur (par exemple, authentification ou connectivité), mais pas aux échecs individuels au niveau de l'enregistrement.
• Réactivation : Si l'échec du scrutateur désactive le flux, corrigez le problème sous-jacent et réactivez le flux manuellement.

Limites et exceptions des électeurs

• Échecs avant exécution : Si le scrutateur échoue avant le début de l'exécution, aucun chemin de défaut n'est disponible dans l'élément Démarrer.
• Limites de charge de travail : Une réponse à un sondage qui dépasse 128 000 caractères (données et métadonnées comprises) dépasse la limite en charge utile.

Fonctionnalités Agentforce : Limitations des actions dynamiques

Fonctionnalités Agentforce dans MuleSoft pour Flux : L'intégration ne prend pas en charge les actions dynamiques dans les connecteurs tiers. Un flux ne peut pas utiliser Agentforce s’il s’appuie sur les métadonnées dynamiques des connecteurs suivants : NetSuite, Salesforce et Zendesk.

Considérations et limitations relatives à la carte de valeur

Examinez le comportement à l'exécution, les exigences d'empaquetage et les scénarios non pris en charge avant de déployer des flux d'intégration.

Comportement d'exécution

• Les références de carte de valeur sont transmises uniquement, de la valeur source à la valeur cible.
• Les valeurs sources nécessitent des valeurs uniques dans chaque carte de valeurs.
• Les valeurs cibles peuvent être répétées à travers les lignes.
• Les valeurs sources non mappées déclenchent le paramètre de comportement par défaut de la carte des valeurs.

Comportement par défaut des valeurs non mappées

• Échec du flux : Le flux renvoie une erreur et s'arrête.
• Transmettre en tant que valeur non mappée : Le système renvoie la valeur source non mappée en sortie.
• Définissez une valeur par défaut : Le système renvoie une valeur cible par défaut définie par l'utilisateur.

Gestion globale des ressources

• Gérez les cartes de valeurs à partir de Ressources de flux globales.
• Supprimez les cartes de valeurs individuellement, car les vues de liste ne prennent pas en charge la suppression en masse.
• Retirez toutes les références de flux à une carte de valeurs avant de la supprimer.

Limites du mode d'entrée et de la prise en charge des flux

• N'utilisez pas le mode d'entrée Mappage de valeur dans l'élément Démarrer pour des déclencheurs externes. L'élément Démarrer ne le prend pas en charge.
• Référencez des variables ou des champs pour des sources, car les cartes de valeurs ne prennent pas en charge les ressources constantes.

Packages gérés

• Utilisez des packages gérés de deuxième génération (2GP) comme méthode d'empaquetage principale pour les cartes de valeurs.
• Ajoutez manuellement des cartes de valeurs référencées dans des packages gérés de première génération (1GP), car le package ne les inclut pas automatiquement.

Pour les étapes de configuration, consultez Création et gestion de cartes de valeur. Pour appliquer le mappage de valeurs dans Transformer, consultez Utilisation d'une carte de valeurs dans Transformer.

Limitations et considérations relatives aux connecteurs tiers

Connexion à un système externe avec des identifiants nommés

Pour personnaliser votre sécurité de connexion et gérer les performances de l'API, vous pouvez utiliser votre propre application OAuth - via un identifiant nommé avec des identifiants externes - avec tous les connecteurs pris en charge.

Voici quelques limitations générales dans les connecteurs tiers.

• Le nombre maximal d'enregistrements renvoyés est de 10 000 pour les actions Obtenir <Enregistrements>.
• Le nom d'un service externe ne peut pas correspondre exactement au nom d'un connecteur tiers. Utilisez un nom unique pour un service externe afin d'éviter les conflits et les problèmes de nommage dans vos flux.

Voici quelques limites et considérations spécifiques dans les connecteurs tiers.

• Connecteur HubSpot
  • Si vous tentez d'associer une opportunité Salesforce à une affaire HubSpot, l'association échoue.
• Connecteur NetSuite
  • Les actions Déclencheurs et Obtenir des enregistrements prennent en charge uniquement les champs personnalisés compatibles texte. Cependant, utilisez l'action Obtenir l'enregistrement pour renvoyer tous les champs personnalisés d'un enregistrement, quel que soit son type de données.
  • Lorsque des flux avec des connexions NetSuite utilisent MuleSoft pour Flux : Le Générateur de requête d'intégration et le déclencheur automatique, le système ne renvoie pas d'éléments de ligne ni de listes. Pour renvoyer des éléments de ligne ou des listes, utilisez l'action Obtenir l'enregistrement avec le type d'enregistrement approprié.
  • Les champs suivants ne sont pas pris en charge dans l'objet Client NetSuite : taxItem, taxSchedule, projectTemplate et projectTemplateId.

    L'API REST NetSuite sous-jacente n'expose pas ces champs pour la création ou la mise à jour d'enregistrements Client. Actuellement, il n'existe pas de contournement direct dans le connecteur. Utilisez à la place l'une des méthodes alternatives suivantes :

    • Utilisez des champs personnalisés et l'automatisation NetSuite pour gérer les données.
    • Mettez manuellement à jour les champs dans l'interface utilisateur de NetSuite.
    • Contactez le support client de NetSuite pour demander que ces champs soient prioritaires pour leur API REST.
• Connecteur Microsoft Dynamics 365 Business Central
  • Lors de la création d'une facture ou d'une commande, saisissez un numéro de client valide. Cependant, l'API Customer n'exige pas que tous les champs obligatoires contiennent des valeurs (telles que Bus général. Groupe de publication, Groupe de publication client et Code de la zone fiscale). Par conséquent, la création d'un enregistrement Client via l'API ou un flux sans ces valeurs est possible. Si vous utilisez cet enregistrement Client pour créer une facture ou une commande, l'opération échoue avec le message d'erreur Error: Customer Posting Group must have a value in Customer.. Pour garantir la réussite de la création de Factures commerciales et de Commandes, vérifiez que le champ Groupe de publication client est rempli pour chaque enregistrement client.
• Connecteur Salesforce
  • Si vous authentifiez une connexion Salesforce à Salesforce pendant l'authentification, l'erreur de OAUTH_APPROVAL_ERROR_GENERIC est parfois affichée, car la stratégie de sécurité des applications connectées nécessite une approbation explicite pour les applications connectées créées avant le déploiement de la stratégie. Pour résoudre ce problème, l'administrateur de l'organisation de destination doit approuver explicitement les applications connectées en suivant les étapes suivantes :
    • Pour la configuration initiale, l'administrateur Salesforce doit disposer de l'autorisation Approuver les applications connectées désinstallées.
    • Pour les organisations établies, l'administrateur Salesforce approuve l'application connectée Salesforce Connector.

    Lorsqu'un administrateur Salesforce approuve l'application, les utilisateurs suivants peuvent s'authentifier sans disposer de l'autorisation Approuver les applications connectées désinstallées.

  • Lorsqu'un utilisateur d'API authentifie une connexion avec succès, puis exécute un test de connexion, le test échoue parfois avec le Connection test failed: The resource doesn't exist d'erreur. Cet échec se produit car, pendant le test, le connecteur tente d'exécuter une requête sur le point de terminaison Describe du sObject Account. Cette requête de point de terminaison échoue si l'utilisateur de l'API n'a pas suffisamment d'autorisations. Pour établir et tester la connexion, l'utilisateur qui la crée doit disposer des autorisations suivantes, qui sont disponibles via un profil ou un ensemble d'autorisations :
    • API activée
    • Accès en lecture au sObject Compte