Erreurs et résolutions courantes dans Omnistudio

1. Connectez-vous en tant qu'administrateur système.
2. Dans Configuration, recherchez et sélectionnez Omnistudio.
3. Activez l'autorisation Omnistudio pour votre organisation.

Si l'option n'est pas affichée, vérifiez que votre organisation détient des licences Omnistudio. Contactez votre chargé de compte Salesforce si des licences sont requises.

Conseil Après avoir activé les autorisations Omnistudio, la propagation des modifications dans votre organisation peut prendre quelques minutes. Si cette erreur persiste, essayez de vous déconnecter et de vous reconnecter.

• Tenter de supprimer un Omniscript actif
• Tenter de mettre à jour des champs structurels dans un Omniscript actif
• Tentative de changement de Type, Sous-type ou Langue dans un Omniscript actif

1. Dans le Lanceur d'application, recherchez et sélectionnez Omniscripts.
2. Localisez l'Omniscript que vous souhaitez modifier ou supprimer.
3. Notez la version actuelle et avertissez les utilisateurs de la prochaine désactivation.
4. Désactivez la case Active pour désactiver l'Omniscript et enregistrer vos modifications.
5. Vous pouvez maintenant apporter les modifications voulues ou supprimer l'Omniscript.
6. Si vous avez apporté des modifications, vous pouvez les réactiver en cochant de nouveau la case Active.

Avertissement La désactivation d'un Omniscript affecte immédiatement tous les utilisateurs et processus qui l'utilisent actuellement. Vous pouvez créer une nouvelle version au lieu de modifier la version active si vous devez maintenir la continuité du service.

• Un autre Omniscript avec Type, SubType et Language identiques est déjà actif
• Création d'une version sans désactiver la version précédente
• Plusieurs versions créées et tentant d'activer plusieurs

Assurez-vous que vous disposez des autorisations requises pour modifier les enregistrements Omniscript et effectuer les tâches ci-dessous.

1. Dans le Lanceur d'application, recherchez et sélectionnez Omniscripts.
2. Utilisez des filtres ou recherchez des Omniscripts avec Type et SubType correspondants.
3. Identifiez l'Omniscript actuellement actif avec le même Type/Sous-Type/Langue.
4. Examinez les deux versions pour déterminer lesquelles doivent rester actives.
5. Ouvrez l'Omniscript que vous souhaitez désactiver.
6. Désactivez la case Active, puis enregistrez vos modifications.
7. Revenez à la nouvelle version et activez-la.

Avertissement Avant d'activer une nouvelle version, testez-la en profondeur dans un environnement d'aperçu ou sandbox. Lorsque vous êtes prêt à déployer, désactivez l'ancienne version, puis activez immédiatement la nouvelle version pour limiter les temps d'arrêt.

• Le champ Type est vide ou nul
• Le champ de sous-type est vide ou nul
• Le champ Langue n'est pas sélectionné
• Tenter d'enregistrer un nouvel Omniscript sans remplir tous les champs obligatoires

Assurez-vous que vous disposez des autorisations requises pour modifier les enregistrements Omniscript et effectuer les tâches ci-dessous.

1. Dans le Lanceur d'application, recherchez et sélectionnez Omniscripts.
2. Dans le panneau des propriétés Omniscript, accédez au champ Type.
3. Saisissez un nom de Type descriptif, par exemple CustomerOnboarding ou ClaimSubmission.
4. Localisez le champ Sous-type et saisissez un nom de Sous-type spécifique, par exemple Résidentiel ou Commercial.
5. Sélectionnez une Langue dans la liste déroulante.
6. Assurez-vous que les trois champs sont remplis et enregistrez vos modifications.
7. Revenez à la nouvelle version et activez-la.

Conseil Choisissez des noms de Type et de Sous-type explicites qui indiquent clairement l'objet de votre Omniscript. Ces valeurs font partie intégrante de votre référencement de l'Omniscript dans vos applications et ne peuvent pas être modifiées aisément après leur création.

• Les champs Type ou Sous-type contiennent des espaces
• Les champs Type ou Sous-type contiennent des traits de soulignement
• Les champs Type ou Sous-type contiennent des caractères spéciaux non pris en charge : !@#$%^&*, etc.
• Les champs Type ou SubType contiennent des tirets ou une autre ponctuation

1. Vérifiez vos valeurs Type et SubType.
2. Retirez tous les espaces, utilisez à la place UpperCamelCase (ou PascalCase). Par exemple, CustomerOnboarding.
3. Retirez tous les traits de soulignement et remplacez-les par UpperCamelCase (ou PascalCase).
4. Retirez tous les caractères spéciaux.
5. Assurez-vous que seules les lettres (A à Z, a à z) et les chiffres (0 à 9) sont utilisés.
6. Enregistrez vos modifications.

Conseil Utilisez PascalCase (également appelé UpperCamelCase) pour les valeurs Type et SubType. Cela améliore la lisibilité sans espace ni trait de soulignement.

• La valeur du type est trop longue.
• La valeur SubType est trop longue.
• Type combiné + Sous-type + Langue dépasse la limite en caractères.

1. Consultez le message d'erreur pour afficher la longueur maximale autorisée.
2. Raccourcissez votre valeur Type ou SubType.
3. Enregistrez vos modifications.

Conseil Utilisez des abréviations si nécessaire. Retirez les mots redondants. Utilisez une convention de nommage plus courte.

Le champ Type ou SubType utilise un mot-clé réservé. Les mots-clés restreints courants comprennent : in, out, exc, cb, kt, vt, v, x785f, x5f

Comme suggéré dans le message d'erreur, remplacez le mot-clé restreint par une autre valeur. Pour plus d'informations, consultez Mots réservés dans la page Conventions de nommage d'Omnistudio.

• Tenter d'ajouter un nouvel élément à un Omniscript actif.
• Tenter de modifier un élément existant dans un Omniscript actif.
• Tenter de supprimer un élément d'un Omniscript actif.
• L'Omniscript est actif et utilisé.

Assurez-vous que vous disposez des autorisations requises pour modifier les enregistrements Omniscript et effectuer les tâches ci-dessous.

1. Vérifiez si l'Omniscript est actuellement actif.
2. Vous pouvez créer une nouvelle version au lieu de modifier la version active.
3. Pour créer une version : Cliquez sur Clone dans l'Omniscript.
4. Pour modifier un existant : Désactivez en désactivant la case Active, puis enregistrez vos modifications.
5. Vous pouvez désormais ajouter, mettre à jour ou supprimer des éléments.
6. Testez vos modifications.
7. Activez l'Omniscript lorsqu'il est prêt à être utilisé.

Avertissement Il est recommandé de créer une nouvelle version pour les modifications importantes plutôt que de désactiver et de modifier la version active. Cela permet de tester en profondeur avant le déploiement et offre une option de restauration facile en cas de problème.

• Un autre élément du même Omniscript porte le même nom.
• Nommez la collision entre les éléments dans différentes étapes.
• L'élément a été copié et le nom n'a pas changé.

1. Vérifiez tous les éléments de votre Omniscript.
2. Identifiez les éléments dont les noms sont en conflit.
3. Choisissez l'élément qui doit garder le nom.
4. Renommez l'autre élément avec un nom unique.
5. Vous pouvez utiliser des préfixes pour indiquer l'étape ou la section, par exemple step1_firstName, step2_firstName.
6. Mettez à jour toutes les formules ou mappages de données qui référencent l'élément renommé, puis enregistrez vos modifications.

• L'Omniscript provient d'un package géré et vous n'êtes pas autorisé à le modifier ou à le supprimer.
• Tenter de mettre à jour un Omniscript empaqueté hors de l'espace de noms du package.

1. Vérifiez si l'Omniscript provient d'un package géré.
2. Si vous devez personnaliser l'Omniscript, clonez-le à la place.
3. Renommez la version clonée avec votre propre combinaison Type/Sous-type/Langue.
4. Apportez les modifications voulues à la version clonée, enregistrez et activez votre Omniscript.
5. Mettez à jour toutes les formules ou mappages de données qui référencent l'élément renommé, puis enregistrez vos modifications.

Conseil Contactez le fournisseur du package ou votre administrateur Salesforce si vous devez apporter des modifications aux composants du package. Ils peuvent fournir des options de configuration ou des points d'extension qui ne nécessitent pas de modifier directement l'Omniscript empaqueté.

• L'Omniscript est réutilisable.
• L'Omniscript contient des éléments Omniscript (Omniscripts incorporés).
• Tenter de rendre un Omniscript réutilisable après avoir ajouté des Omniscripts incorporés

1. Déterminez si cet Omniscript doit être réutilisable ou contenir des Omniscripts incorporés.
2. Option 1: Garder réutilisable - Retirer tous les éléments Omniscript incorporés
3. Option 2 : Autoriser l'incorporation : Désactivez la case Réutilisable.
4. Si vous retirez des Omniscripts incorporés, vous pouvez utiliser à la place des procédures d'intégration. Vous pouvez refactoriser la logique dans des procédures d'intégration qui peuvent être appelées depuis l'Omniscript.

Conseil Utilisez des procédures d'intégration pour une logique métier partagée au lieu d'imbriquer des Omniscripts réutilisables. Cela crée une architecture plus propre et évite la complexité dans les dépendances Omniscript.

• Une autre Flexcard portant le même nom est déjà active.
• Tenter d'activer une nouvelle version sans désactiver l'ancienne.

1. Recherchez des Flexcards avec le même champ Nom.
2. Examinez-les pour déterminer lesquels doivent rester actifs.
3. Ouvrez la Flexcard que vous souhaitez désactiver.
4. Désactivez la case Active pour désactiver la Flexcard et enregistrer vos modifications.

Avertissement La désactivation d'une Flexcard affecte immédiatement tous les utilisateurs et processus qui l'utilisent actuellement. Vous pouvez créer une nouvelle version au lieu de modifier la version active si vous devez maintenir la continuité du service.

1. Vérifiez si la Flexcard provient d'un package géré.
2. Si vous devez le retirer de l'utilisation, désactivez-le au lieu de le supprimer.
3. Pour cela, ouvrez la Flexcard, puis désactivez la case Active.
4. Si vous avez besoin d'une version personnalisée de la Flexcard, clonez-la à la place.

Conseil Contactez le fournisseur du package ou votre administrateur Salesforce si vous devez apporter des modifications aux composants du package. Ils peuvent fournir des options de configuration ou des points d'extension qui ne nécessitent pas de modifier directement la Flexcard empaquetée.

• Le nom du nom Flexcard enfant est mal orthographié.
• La Flexcard enfant existe, mais n'est pas active.
• La Flexcard enfant a été supprimée.
• La Flexcard enfant se trouve dans un autre espace de noms.

1. Dans le Lanceur d'application, recherchez et sélectionnez Noter le nom de la Flexcard enfant dans le message d'erreur.
2. Recherchez la Flexcard enfant par son nom.
3. Si trouvé, mais inactif, activez-le.
4. S'il est introuvable, vérifiez le nom correct.
5. Si le nom est incorrect, mettez à jour la configuration parente de la Flexcard.
6. Dans la Flexcard parente, recherchez la référence Flexcard enfant.
7. Corrigez le nom pour refléter une Flexcard existante et active, puis enregistrez la Flexcard parente.

Remarque Les Flexcards enfants doivent être activées avant que la Flexcard parente puisse les référencer. Créez et testez d'abord des Flexcards enfants, puis configurez des Flexcards parentes pour les utiliser.

• Le Type/Sous-Type/Langue de l'Omniscript est incorrect.
• L'Omniscript existe, mais n'est pas actif.
• L'Omniscript a été supprimé.
• Le Type/Sous-Type/Langue de l'Omniscript a été modifié.

1. Notez Type, SubType et Language dans le message d'erreur.
2. Recherchez l'Omniscript avec Type et SubType correspondants.
3. Vérifiez les correspondances Langue.
4. Si trouvé, mais inactif, activez l'Omniscript.
5. Si elle n'est pas trouvée, vérifiez les valeurs Type/SubType/Language correctes.
6. Revenez dans votre Flexcard et mettez à jour la référence Omniscript avec les valeurs correctes.
7. Enregistrez vos modifications.

Conseil Assurez-vous que l'Omniscript référencé est actif avant d'activer la Flexcard. Si vous déployez les deux ensemble, activez d'abord l'Omniscript.

• Le nom du Mappeur de données est mal orthographié.
• Le Mappeur de données existe, mais n'est pas actif.
• Le Mappeur de données a été supprimé.
• Le nom du Mappeur de données a été modifié.

1. Notez le nom du Mappeur de données dans le message d'erreur.
2. Recherchez le Mappeur de données par son nom.
3. Si trouvé, mais inactif, activez-le.
4. S'il est introuvable, vérifiez le nom correct.
5. Revenez dans votre Flexcard, mettez à jour la référence Data Mapper avec le nom correct, puis enregistrez vos modifications.

Conseil Activez les mappeurs de données avant d'activer les Flexcards qui les référencent. Testez le Mappeur de données indépendamment pour vous assurer qu'il renvoie la structure de données attendue.

• Le nom de la procédure d'intégration est incorrect.
• Le Mappeur de données existe, mais n'est pas actif.
• Le Mappeur de données a été supprimé.
• Vous n'utilisez pas le format de nommage correct (vous devez utiliser le format Type_SubType).

1. Notez le nom de la procédure d'intégration dans le message d'erreur.
2. Recherchez Procédure d'intégration.
3. Vérifiez son existence, puis notez son Type et son Sous-type.
4. Si trouvé, mais inactif, activez-le.
5. Revenez dans votre Flexcard.
6. Mettez à jour la référence Procédure d'intégration en utilisant le format : Type_SubType, puis enregistrez vos modifications.

Avertissement Les procédures d'intégration sont référencées en utilisant leur OmniProcessKey, qui suit le format Type_SubType. Assurez-vous d'utiliser le format approprié lors de la configuration de la Flexcard.

• Tenter de renommer une Flexcard existante.
• Tenter de changer l'auteur d'une Flexcard existante.
• Le UniqueName est utilisé par d'autres composants et ne peut pas être modifié.

1. Si vous avez besoin d'un autre nom ou d'un autre auteur, clonez à la place la Flexcard.
2. Localisez votre Flexcard et clonez-la.
3. Saisissez le nouveau Nom ou Auteur.
4. Apportez les autres modifications nécessaires à la version clonée et activez votre nouvelle Flexcard.
5. Mettez à jour tous les composants référençant l'ancienne Flexcard pour utiliser la nouvelle.
6. Désactivez l'ancienne Flexcard une fois toutes les références mises à jour.

• Le Nom de la procédure d'intégration commence par FileBased.
• Le Type de procédure d'intégration commence par filebased (basé sur un fichier).
• Le sous-type Procédure d'intégration commence par FileBased.

1. Ouvrez votre procédure d'intégration.
2. Vérifiez les champs Nom, Type et Sous-type.
3. Si certains commencent par FileBased, choisissez un autre préfixe.
4. Vous pouvez utiliser des préfixes tels que Fichier, Document, Données ou le nom de votre organisation.
5. Mettez à jour les champs sujets aux erreurs et enregistrez vos modifications.

• Le schéma d'entrée JSON contient des objets imbriqués à plus de 10 niveaux.
• Le schéma de sortie JSON contient des objets imbriqués à plus de 10 niveaux.

1. Vérifiez la structure de votre schéma JSON.
2. Identifiez les sections profondément imbriquées.
3. Aplatissez la structure en réduisant les niveaux d'imbrication.
4. Vous pouvez déplacer des données profondément imbriquées vers des procédures d'intégration distinctes.
5. Utilisez des tableaux avec des objets plus plats au lieu de hiérarchies profondément imbriquées.
6. Restructurez pour garder l'imbrication sous 10 niveaux.
7. Enregistrez le schéma mis à jour.

Les schémas JSON Procédure d'intégration ont une limite maximale de 500 clés dans l'ensemble de la structure. Cela inclut toutes les clés à tous les niveaux d'imbrication combinés. En particulier :

• Le schéma d'entrée JSON contient plus de 500 clés au total.
• Le schéma de sortie JSON contient plus de 500 clés au total.
• Le schéma inclut un grand nombre de champs à travers plusieurs objets imbriqués.

1. Vérifiez votre schéma JSON.
2. Comptez le nombre total de clés à travers tous les niveaux.
3. Identifiez les sections avec des clés excessives.
4. Vous pouvez diviser la procédure d'intégration en plusieurs procédures plus petites.
5. Retirez les clés inutilisées ou redondantes.
6. Utilisez des tableaux pour représenter des structures répétées au lieu de clés numérotées.
7. Consolidez les champs associés en sous-objets.
8. Enregistrez le schéma optimisé.

Conseil Si vous avez légitimement besoin de plus de 500 clés, vous pouvez diviser le processus en plusieurs procédures d'intégration qui peuvent être enchaînées.

• Le sObject sélectionné n'est pas pris en charge pour les opérations de Data Mapper.
• Le sObject sélectionné est un objet système qui ne prend pas en charge les requêtes.
• Le sObject sélectionné n'a pas la prise en charge d'API requise pour fonctionner avec les Data Mappers.

1. Vérifiez le type d'entrée sObject que vous avez sélectionné, puis consultez l'aide de Salesforce pour les objets pris en charge.
2. Vous pouvez utiliser un autre objet associé pris en charge.
3. Si vous avez besoin de données de l'objet non pris en charge, utilisez à la place une Procédure d'intégration avec Apex personnalisé.
4. Mettez à jour votre configuration Data Mapper avec un objet pris en charge, puis enregistrez vos modifications.

Remarque La plupart des objets standard et personnalisés sont pris en charge. Si vous rencontrez un objet non pris en charge, déterminez si vous pouvez restructurer votre flux de données pour utiliser une alternative prise en charge.

• OmniAnalytics pour Omnistudio n'est pas activé.
• Votre organisation n'a pas été configurée pour OmniAnalytics.

1. Connectez-vous en tant qu'administrateur système et, dans Configuration, recherchez Paramètres Omnistudio ou Configurations d'interaction Omni.
2. Accédez au paramètre OmniAnalytics for Core, puis activez-le.
3. Enregistrez vos modifications et attendez quelques minutes avant de les appliquer.
4. Testez si votre suivi Analytics fonctionne.

Remarque Vérifiez que Decision Explainer est correctement configuré.

• L'ID n'est pas au format Salesforce ID valide, avec 15 ou 18 caractères.
• L'ID n'appartient pas à l'objet OmniTrackingComponentDef.
• La définition du composant de suivi a été supprimée.
• L'ID est nul ou malformé.

1. Vérifiez l'ID de définition du composant que vous utilisez.
2. Accédez à Configuration > Omnistudio > Suivi Analytics et recherchez la définition correcte du composant de suivi.
3. Copiez l'ID correct de l'enregistrement.
4. Mettez à jour votre code ou configuration avec l'ID correct.
5. Si la définition a été supprimée, créez une nouvelle définition de composant de suivi. Consultez Création d'un groupe de suivi et ajout de composants au suivi.
6. Testez de nouveau le suivi.

Remarque Vérifiez que Decision Explainer est correctement configuré.