Allgemeine Fehler und Lösungen in OmniStudio

1. Melden Sie sich als Systemadministrator an.
2. Suchen Sie unter "Setup" nach OmniStudio und wählen Sie diese Option aus.
3. Aktivieren Sie die OmniStudio-Berechtigung für Ihre Organisation.

Wenn die Option nicht angezeigt wird, überprüfen Sie, ob Ihre Organisation über OmniStudio-Lizenzen verfügt. Wenden Sie sich an Ihren Salesforce-Kundenbeauftragten, wenn Lizenzen erforderlich sind.

Tipp Nach dem Aktivieren von OmniStudio-Berechtigungen kann es einige Minuten dauern, bis die Änderungen in Ihrer Organisation übernommen werden. Wenn dieser Fehler weiterhin angezeigt wird, versuchen Sie, sich abzumelden und wieder anzumelden.

• Löschversuch eines aktiven OmniScripts
• Aktualisieren von Strukturfeldern in einem aktiven OmniScript
• Versuch, Typ, Untertyp oder Sprache in einem aktiven OmniScript zu ändern

1. Suchen Sie im App Launcher nach OmniScripts und wählen Sie diese Option aus.
2. Suchen Sie das OmniScript, das Sie ändern oder löschen möchten.
3. Notieren Sie sich die aktuelle Version und warnen Sie Benutzer vor der anstehenden Deaktivierung.
4. Deaktivieren Sie das Kontrollkästchen Aktiv, um das OmniScript zu deaktivieren und Ihre Änderungen zu speichern.
5. Nun können Sie die gewünschten Änderungen vornehmen oder das OmniScript löschen.
6. Wenn Sie Änderungen vorgenommen haben, können Sie sie erneut aktivieren, indem Sie das Kontrollkästchen Aktiv erneut aktivieren.

ACHTUNG Die Deaktivierung eines OmniScripts wirkt sich sofort auf alle Benutzer und Prozesse aus, die es derzeit verwenden. Ziehen Sie in Erwägung, eine neue Version zu erstellen, statt die aktive zu ändern, wenn Sie die Servicekontinuität aufrechterhalten möchten.

• Ein anderes OmniScript mit identischem Typ, Untertyp und Sprache ist bereits aktiv
• Erstellen einer neuen Version ohne Deaktivieren der vorherigen Version
• Mehrere Versionen erstellt und versucht, mehrere zu aktivieren

Stellen Sie sicher, dass Sie über Berechtigungen zum Bearbeiten von OmniScript-Datensätzen und zum Ausführen dieser Aufgaben verfügen.

1. Suchen Sie im App Launcher nach OmniScripts und wählen Sie diese Option aus.
2. Verwenden Sie Filter oder suchen Sie nach OmniScripts mit übereinstimmendem Typ und Untertyp.
3. Identifizieren Sie das aktuell aktive OmniScript mit demselben Typ/SubType/Language.
4. Überprüfen Sie beide Versionen, um zu bestimmen, welche aktiv bleiben sollen.
5. Öffnen Sie das OmniScript, das Sie deaktivieren möchten.
6. Deaktivieren Sie das Kontrollkästchen Aktiv und speichern Sie Ihre Änderungen.
7. Kehren Sie zur neuen Version zurück und aktivieren Sie sie.

ACHTUNG Testen Sie eine neue Version vor dem Aktivieren sorgfältig in einer Vorschau- oder Sandbox-Umgebung. Wenn Sie bereit für die Bereitstellung sind, deaktivieren Sie die alte Version und aktivieren Sie sofort die neue, um Ausfallzeiten zu minimieren.

• Typfeld ist leer oder null
• Untertypfeld ist leer oder null
• Sprachfeld ist nicht ausgewählt
• Versuch, ein neues OmniScript zu speichern, ohne alle Pflichtfelder auszufüllen

Stellen Sie sicher, dass Sie über Berechtigungen zum Bearbeiten von OmniScript-Datensätzen und zum Ausführen dieser Aufgaben verfügen.

1. Suchen Sie im App Launcher nach OmniScripts und wählen Sie diese Option aus.
2. Suchen Sie im Eigenschaftenbereich "OmniScript" nach dem Feld "Typ".
3. Geben Sie einen aussagekräftigen Typnamen ein, beispielsweise CustomerOnboarding oder ClaimSubmission.
4. Suchen Sie das Feld SubType und geben Sie einen bestimmten SubType-Namen ein, beispielsweise Residial oder Commercial.
5. Wählen Sie im Dropdown-Menü eine Sprache aus.
6. Stellen Sie sicher, dass alle drei Felder ausgefüllt sind, und speichern Sie Ihre Änderungen.
7. Kehren Sie zur neuen Version zurück und aktivieren Sie sie.

Tipp Wählen Sie aussagekräftige Typ- und Untertypnamen aus, die den Zweck Ihres OmniScripts eindeutig angeben. Diese Werte werden Teil der Art und Weise, wie Sie in Ihren Anwendungen auf das OmniScript verweisen, und können nach ihrer Erstellung nicht einfach geändert werden.

• Felder vom Typ oder Untertyp enthalten Leerzeichen
• Felder vom Typ oder Untertyp enthalten Unterstriche
• Felder vom Typ "Typ" oder "Untertyp" enthalten nicht unterstützte Sonderzeichen: !@#$%^&* usw.
• Typ- oder Untertypfelder enthalten Bindestriche oder andere Satzzeichen

1. Überprüfen Sie die Werte "Typ" und "Untertyp".
2. Entfernen Sie Leerzeichen. Verwenden Sie stattdessen UpperCamelCase (oder PascalCase). Zum Beispiel CustomerOnboarding.
3. Entfernen Sie alle Unterstriche und ersetzen Sie sie durch UpperCamelCase (oder PascalCase).
4. Entfernen Sie Sonderzeichen.
5. Stellen Sie sicher, dass nur Buchstaben (A-Z, a-z) und Zahlen (0-9) verwendet werden.
6. Speichern Sie Ihre Änderungen.

Tipp Verwenden Sie PascalCase (auch UpperCamelCase genannt) für Werte vom Typ "Typ" und "Untertyp". Dadurch wird die Lesbarkeit verbessert, ohne dass Leerzeichen oder Unterstriche erforderlich sind.

• Der Typwert ist zu lang.
• Der Untertypwert ist zu lang.
• Kombinierter Typ + Untertyp + Sprache überschreitet die Zeichenobergrenze.

1. Überprüfen Sie die Fehlermeldung, um die maximal zulässige Länge anzuzeigen.
2. Kürzen Sie den Wert für "Typ" oder "Untertyp".
3. Speichern Sie Ihre Änderungen.

Tipp Verwenden Sie bei Bedarf Abkürzungen. Entfernen Sie redundante Wörter. Verwenden Sie eine kürzere Benennungskonvention.

Das Feld "Typ" oder "Untertyp" verwendet ein reserviertes Stichwort. Allgemeine eingeschränkte Stichwörter sind: in, out, exc, cb, kt, vt, v, x785f, x5f

Ersetzen Sie, wie in der Fehlermeldung vorgeschlagen, das eingeschränkte Stichwort durch einen anderen Wert. Weitere Informationen finden Sie unter Reservierte Wörter auf der Seite "OmniStudio-Namenskonventionen".

• Versuch, einem aktiven OmniScript ein neues Element hinzuzufügen.
• Versuch, ein vorhandenes Element in einem aktiven OmniScript zu ändern.
• Versuch, ein Element aus einem aktiven OmniScript zu löschen.
• Das OmniScript ist aktiv und wird verwendet.

Stellen Sie sicher, dass Sie über Berechtigungen zum Bearbeiten von OmniScript-Datensätzen und zum Ausführen dieser Aufgaben verfügen.

1. Überprüfen Sie, ob das OmniScript derzeit aktiv ist.
2. Erstellen Sie ggf. eine neue Version, statt die aktive zu ändern.
3. Erstellen einer neuen Version: Klicken Sie im OmniScript auf Duplizieren.
4. Ändern vorhandener Elemente: Deaktivieren Sie diese Option, indem Sie das Kontrollkästchen Aktiv deaktivieren und Ihre Änderungen speichern.
5. Nun können Sie Elemente hinzufügen, aktualisieren oder löschen.
6. Testen Sie Ihre Änderungen.
7. Aktivieren Sie das OmniScript, wenn es einsatzbereit ist.

ACHTUNG Es wird empfohlen, eine neue Version für wichtige Änderungen zu erstellen, statt die aktive Version zu deaktivieren und zu ändern. Dadurch können Sie vor der Bereitstellung gründlich testen und erhalten eine einfache Rollback-Option, falls Probleme auftreten.

• Ein anderes Element im selben OmniScript hat denselben Namen.
• Namenskonflikt zwischen Elementen in verschiedenen Schritten.
• Das Element wurde kopiert und der Name nicht geändert.

1. Überprüfen Sie alle Elemente in Ihrem OmniScript.
2. Identifizieren Sie die Elemente mit den in Konflikt stehenden Namen.
3. Legen Sie fest, welches Element den Namen beibehalten soll.
4. Benennen Sie das andere Element mit einem eindeutigen Namen um.
5. Verwenden Sie ggf. Präfixe, um den Schritt oder Abschnitt anzugeben, beispielsweise step1_firstName, step2_firstName.
6. Aktualisieren Sie alle Formeln oder Datenzuordnungen, die auf das umbenannte Element verweisen, und speichern Sie Ihre Änderungen.

• Das OmniScript stammt aus einem verwalteten Paket und Sie haben keine Berechtigungen, es zu ändern oder zu löschen.
• Versuch, ein OmniScript in einem Paket außerhalb des Paket-Namespace zu aktualisieren.

1. Überprüfen Sie, ob das OmniScript aus einem verwalteten Paket stammt.
2. Wenn Sie das OmniScript anpassen müssen, duplizieren Sie es stattdessen.
3. Benennen Sie die duplizierte Version mit Ihrer eigenen Kombination "Typ/SubType/Language" um.
4. Nehmen Sie die gewünschten Änderungen an der duplizierten Version vor, speichern und aktivieren Sie Ihr OmniScript.
5. Aktualisieren Sie alle Formeln oder Datenzuordnungen, die auf das umbenannte Element verweisen, und speichern Sie Ihre Änderungen.

Tipp Wenden Sie sich an den Paketanbieter oder Ihren Salesforce-Administrator, wenn Sie Änderungen an Paketkomponenten vornehmen müssen. Sie können Konfigurationsoptionen oder Erweiterungspunkte bereitstellen, für die das OmniScript im Paket nicht direkt geändert werden muss.

• Das OmniScript kann wiederverwendet werden.
• Das OmniScript enthält OmniScript-Elemente (eingebettete OmniScripts).
• Versuch, ein OmniScript nach dem Hinzufügen eingebetteter OmniScripts wiederverwendbar zu machen

1. Legen Sie fest, ob dieses OmniScript wiederverwendet werden soll oder eingebettete OmniScripts enthält.
2. Option 1: Wiederverwendbar bleiben – Entfernen aller eingebetteten OmniScript-Elemente
3. Option 2: Einbetten zulassen: Deaktivieren Sie das Kontrollkästchen Wiederverwendbar.
4. Wenn Sie eingebettete OmniScripts entfernen, sollten Sie stattdessen Integrationsverfahren verwenden. Sie können die Logik in Integrationsverfahren umformulieren, die über das OmniScript aufgerufen werden können.

Tipp Verwenden Sie Integrationsverfahren für freigegebene Geschäftslogik, statt wiederverwendbare OmniScripts zu verschachteln. Dadurch wird eine übersichtlichere Architektur geschaffen und Komplexität in OmniScript-Abhängigkeiten vermieden.

• Eine weitere FlexCard mit demselben Namen ist bereits aktiv.
• Versuch, eine neue Version zu aktivieren, ohne die alte zu deaktivieren.

1. Suchen Sie nach FlexCards mit demselben Namensfeld.
2. Überprüfen Sie sie, um zu bestimmen, welche aktiv bleiben sollen.
3. Öffnen Sie die FlexCard, die Sie deaktivieren möchten.
4. Deaktivieren Sie das Kontrollkästchen Aktiv, um die FlexCard zu deaktivieren und Ihre Änderungen zu speichern.

ACHTUNG Die Deaktivierung einer FlexCard wirkt sich sofort auf alle Benutzer und Prozesse aus, die sie derzeit verwenden. Ziehen Sie in Erwägung, eine neue Version zu erstellen, statt die aktive zu ändern, wenn Sie die Servicekontinuität aufrechterhalten möchten.

1. Überprüfen Sie, ob die FlexCard aus einem verwalteten Paket stammt.
2. Wenn Sie sie aus der Verwendung entfernen müssen, deaktivieren Sie sie, statt sie zu löschen.
3. Öffnen Sie dazu die FlexCard und deaktivieren Sie das Kontrollkästchen Aktiv.
4. Wenn Sie eine angepasste Version der FlexCard benötigen, duplizieren Sie sie stattdessen.

Tipp Wenden Sie sich an den Paketanbieter oder Ihren Salesforce-Administrator, wenn Sie Änderungen an Paketkomponenten vornehmen müssen. Sie können Konfigurationsoptionen oder Erweiterungspunkte bereitstellen, die nicht direkt geändert werden müssen.

• Der Name des untergeordneten FlexCard-Namens ist falsch geschrieben.
• Die untergeordnete FlexCard ist vorhanden, aber nicht aktiv.
• Die untergeordnete FlexCard wurde gelöscht.
• Die untergeordnete FlexCard befindet sich in einem anderen Namespace.

1. Suchen Sie im App Launcher den untergeordneten FlexCard-Namen und wählen Sie ihn in der Fehlermeldung beachten aus.
2. Suchen Sie anhand des Namens nach der untergeordneten FlexCard.
3. Wenn gefunden, aber inaktiv, aktivieren Sie sie.
4. Falls nicht gefunden, überprüfen Sie den richtigen Namen.
5. Wenn der Name falsch ist, aktualisieren Sie die übergeordnete FlexCard-Konfiguration.
6. Suchen Sie in der übergeordneten FlexCard nach dem untergeordneten FlexCard-Verweis.
7. Korrigieren Sie den Namen so, dass er mit einer vorhandenen aktiven FlexCard übereinstimmt, und speichern Sie die übergeordnete FlexCard.

Hinweis Untergeordnete FlexCards müssen aktiviert werden, bevor die übergeordnete FlexCard darauf verweisen kann. Erstellen und testen Sie zunächst untergeordnete FlexCards und konfigurieren Sie dann übergeordnete FlexCards für ihre Verwendung.

• Der Typ/Untertyp/Sprache des OmniScripts ist falsch.
• Das OmniScript ist vorhanden, aber nicht aktiv.
• Das OmniScript wurde gelöscht.
• Der Typ/Untertyp/Sprache des OmniScripts wurde geändert.

1. Notieren Sie sich Typ, Untertyp und Sprache in der Fehlermeldung.
2. Suchen Sie nach dem OmniScript mit übereinstimmendem Typ und Untertyp.
3. Überprüfen Sie die Sprachübereinstimmungen.
4. Wenn gefunden, aber inaktiv, aktivieren Sie das OmniScript.
5. Falls nicht gefunden, überprüfen Sie die richtigen Werte für Type/SubType/Language.
6. Kehren Sie zu Ihrer FlexCard zurück und aktualisieren Sie den OmniScript-Verweis mit den richtigen Werten.
7. Speichern Sie Ihre Änderungen.

Tipp Stellen Sie sicher, dass das referenzierte OmniScript aktiv ist, bevor Sie die FlexCard aktivieren. Wenn Sie beides zusammen bereitstellen, aktivieren Sie zunächst das OmniScript.

• Der Name der Datenzuordnung ist falsch geschrieben.
• Die Datenzuordnung ist vorhanden, aber nicht aktiv.
• Die Datenzuordnung wurde gelöscht.
• Der Name der Datenzuordnung wurde geändert.

1. Notieren Sie sich den Namen der Datenzuordnung in der Fehlermeldung.
2. Suchen Sie anhand des Namens nach der Datenzuordnung.
3. Wenn gefunden, aber inaktiv, aktivieren Sie sie.
4. Falls nicht gefunden, überprüfen Sie den richtigen Namen.
5. Kehren Sie zu Ihrer FlexCard zurück, aktualisieren Sie den Datenzuordnungsverweis mit dem richtigen Namen und speichern Sie Ihre Änderungen.

Tipp Aktivieren Sie Datenzuordnungen, bevor Sie FlexCards aktivieren, die auf sie verweisen. Testen Sie die Datenzuordnung unabhängig voneinander, um sicherzustellen, dass sie die erwartete Datenstruktur zurückgibt.

• Der Name des Integrationsverfahrens ist falsch.
• Die Datenzuordnung ist vorhanden, aber nicht aktiv.
• Die Datenzuordnung wurde gelöscht.
• Sie verwenden das falsche Benennungsformat (sollten das Format Type_SubType verwenden).

1. Notieren Sie sich den Namen des Integrationsverfahrens in der Fehlermeldung.
2. Suchen Sie nach dem Integrationsverfahren.
3. Überprüfen Sie, ob sie vorhanden ist, und notieren Sie sich ihren Typ und Untertyp.
4. Wenn gefunden, aber inaktiv, aktivieren Sie sie.
5. Kehren Sie zu Ihrer FlexCard zurück.
6. Aktualisieren Sie den Verweis auf das Integrationsverfahren im folgenden Format: Type_SubType und speichern Sie Ihre Änderungen.

ACHTUNG Integrationsverfahren werden mit ihrem OmniProcessKey referenziert, der dem Format Type_SubType folgt. Stellen Sie sicher, dass Sie beim Konfigurieren der FlexCard das richtige Format verwenden.

• Versuch, eine vorhandene FlexCard umzubenennen.
• Versuch, den Autor einer vorhandenen FlexCard zu ändern.
• Der UniqueName wird von anderen Komponenten verwendet und kann nicht geändert werden.

1. Wenn Sie einen anderen Namen oder Autor benötigen, duplizieren Sie stattdessen die FlexCard.
2. Suchen Sie Ihre FlexCard und duplizieren Sie sie.
3. Geben Sie den neuen Namen oder Autor ein.
4. Nehmen Sie alle anderen erforderlichen Änderungen an der duplizierten Version vor und aktivieren Sie Ihre neue FlexCard.
5. Aktualisieren Sie alle Komponenten, die auf die alte FlexCard verweisen, so, dass sie die neue verwenden.
6. Deaktivieren Sie die alte FlexCard, sobald alle Verweise aktualisiert wurden.

• Der Name des Integrationsverfahrens beginnt mit FileBased.
• Der Integrationsverfahrenstyp beginnt mit filebased.
• Der Untertyp "Integrationsverfahren" beginnt mit "FileBased".

1. Öffnen Sie Ihr Integrationsverfahren.
2. Überprüfen Sie die Felder Name, Typ und Untertyp.
3. Wählen Sie ggf. ein anderes Präfix aus, wenn Sie mit FileBased beginnen.
4. Verwenden Sie ggf. Präfixe wie Datei, Dokument, Daten oder den Namen Ihrer Organisation.
5. Aktualisieren Sie die fehleranfälligen Felder und speichern Sie Ihre Änderungen.

• Das JSON-Eingabeschema verfügt über verschachtelte Objekte, die tiefer als 10 Ebenen sind.
• Das JSON-Ausgabeschema verfügt über verschachtelte Objekte, die tiefer als 10 Ebenen sind.

1. Überprüfen Sie Ihre JSON-Schemastruktur.
2. Identifizieren Sie tief verschachtelte Abschnitte.
3. Vereinfachen Sie die Struktur, indem Sie die Verschachtelungsebenen reduzieren.
4. Ziehen Sie in Erwägung, tief verschachtelte Daten in separate Integrationsverfahren zu verschieben.
5. Verwenden Sie Arrays mit flacheren Objekten anstelle tief verschachtelter Hierarchien.
6. Restrukturieren Sie die Struktur so, dass die Schachtelung unter 10 Ebenen bleibt.
7. Speichern Sie das aktualisierte Schema.

JSON-Schemas für Integrationsverfahren weisen eine Obergrenze von maximal 500 Schlüsseln in der gesamten Struktur auf. Dies beinhaltet alle Schlüssel auf allen Verschachtelungsebenen zusammen. Dies bedeutet insbesondere:

• Das JSON-Eingabeschema enthält insgesamt mehr als 500 Schlüssel.
• Das JSON-Ausgabeschema enthält insgesamt mehr als 500 Schlüssel.
• Das Schema enthält eine große Anzahl von Feldern über mehrere verschachtelte Objekte hinweg.

1. Überprüfen Sie Ihr JSON-Schema.
2. Zählen Sie die Gesamtanzahl der Schlüssel über alle Ebenen hinweg.
3. Identifizieren Sie Abschnitte mit übermäßigen Schlüsseln.
4. Sie sollten das Integrationsverfahren in mehrere kleinere Verfahren aufteilen.
5. Entfernen Sie nicht verwendete oder redundante Schlüssel.
6. Verwenden Sie Arrays, um wiederholte Strukturen anstelle von nummerierten Schlüsseln darzustellen.
7. Konsolidieren Sie verwandte Felder in Unterobjekten.
8. Speichern Sie das optimierte Schema.

Tipp Wenn Sie berechtigterweise mehr als 500 Schlüssel benötigen, sollten Sie den Prozess in mehrere Integrationsverfahren aufteilen, die miteinander verkettet werden können.

• Das ausgewählte sObject wird für Datenzuordnungsvorgänge nicht unterstützt.
• Das ausgewählte sObject ist ein Systemobjekt, das keine Abfragen unterstützt.
• Das ausgewählte sObject verfügt nicht über die erforderliche API-Unterstützung für die Verwendung von Datenzuordnungen.

1. Überprüfen Sie das sObject, das Sie als Eingabetyp ausgewählt haben, und überprüfen Sie die Salesforce-Hilfe auf unterstützte Objekte.
2. Verwenden Sie ggf. ein anderes verwandtes Objekt, das unterstützt wird.
3. Wenn Sie Daten aus dem nicht unterstützten Objekt benötigen, verwenden Sie stattdessen ein Integrationsverfahren mit benutzerdefiniertem Apex.
4. Aktualisieren Sie Ihre Datenzuordnungskonfiguration mit einem unterstützten Objekt und speichern Sie Ihre Änderungen.

Hinweis Die meisten standardmäßigen und benutzerdefinierten Objekte werden unterstützt. Wenn Sie auf ein nicht unterstütztes Objekt stoßen, sollten Sie überlegen, ob Sie Ihren Datenfluss umstrukturieren können, um eine unterstützte Alternative zu verwenden.

• OmniAnalytics für OmniStudio ist nicht aktiviert.
• Ihre Organisation wurde nicht für OmniAnalytics konfiguriert.

1. Melden Sie sich als Systemadministrator an und suchen Sie unter "Setup" nach OmniStudio-Einstellungen oder Omniinteraktionskonfigurationen.
2. Suchen Sie die Einstellung OmniAnalytics für Core und aktivieren Sie sie.
3. Speichern Sie Ihre Änderungen und warten Sie einige Minuten, bis die Änderung wirksam wird.
4. Testen Sie, ob Ihre Analyseverfolgung funktioniert.

Hinweis Überprüfen Sie, ob Decision Explainer ordnungsgemäß konfiguriert ist.

• Die ID weist kein gültiges Salesforce-ID-Format mit 15 oder 18 Zeichen auf.
• Die ID gehört nicht zum Objekt "OmniTrackingComponentDef".
• Die Definition der Verfolgungskomponente wurde gelöscht.
• Die ID ist null oder falsch.

1. Überprüfen Sie die verwendete Komponentendefinitions-ID.
2. Navigieren Sie zu "Setup" > "OmniStudio" > "Analytics-Verfolgung" und suchen Sie nach der richtigen Definition der Verfolgungskomponente.
3. Kopieren Sie die richtige ID aus dem Datensatz.
4. Aktualisieren Sie Ihren Code oder Ihre Konfiguration mit der richtigen ID.
5. Wenn die Definition gelöscht wurde, erstellen Sie eine neue Verfolgungskomponentendefinition. Entsprechende Informationen finden Sie unter Erstellen einer Verfolgungsgruppe und Hinzufügen von Komponenten zur Verfolgung.
6. Testen Sie die Verfolgung erneut.

Hinweis Überprüfen Sie, ob Decision Explainer ordnungsgemäß konfiguriert ist.