Errori e risoluzioni comuni in OmniStudio

1. Accedere come Amministratore di sistema.
2. Da Imposta, trovare e selezionare OmniStudio.
3. Abilitare l'autorizzazione OmniStudio per l'organizzazione.

Se l'opzione non è visualizzata, verificare che l'organizzazione disponga di licenze OmniStudio. Contattare il proprio responsabile account Salesforce se sono necessarie licenze.

Suggerimento Dopo aver abilitato le autorizzazioni OmniStudio, potrebbero essere necessari alcuni minuti prima che le modifiche si propaghino in tutta l'organizzazione. Se si continua a visualizzare questo errore, provare a disconnettersi e ad eseguire nuovamente l'accesso.

• Tentativo di eliminazione di un OmniScript attivo
• Tentativo di aggiornamento dei campi strutturali in un OmniScript attivo
• Tentativo di modificare Tipo, Sottotipo o Lingua in un OmniScript attivo

1. Dal Programma di avvio app, trovare e selezionare OmniScript.
2. Individuare l'OmniScript che si desidera modificare o eliminare.
3. Prendere nota della versione corrente e avvisare gli utenti della disattivazione imminente.
4. Deselezionare la casella di controllo Attivo per disattivare l'OmniScript e salvare le modifiche.
5. Ora è possibile apportare le modifiche desiderate o eliminare l'OmniScript.
6. Se sono state apportate modifiche, è possibile riattivarle selezionando di nuovo la casella di controllo Attivo.

Avvertenza La disattivazione immediata di un OmniScript ha effetto su tutti gli utenti e i processi che lo utilizzano attualmente. Valutare la possibilità di creare una nuova versione anziché modificare quella attiva se è necessario mantenere la continuità del servizio.

• Un altro OmniScript con Tipo, Sottotipo e Lingua identici è già attivo
• Creazione di una nuova versione senza disattivare la versione precedente
• Più versioni create e tentativi di attivazione di più di una

Assicurarsi di disporre delle autorizzazioni per modificare i record OmniScript e completare queste operazioni.

1. Dal Programma di avvio app, trovare e selezionare OmniScript.
2. Utilizzare i filtri o cercare OmniScript con Tipo e Sottotipo corrispondenti.
3. Identificare l'OmniScript attualmente attivo con lo stesso Tipo/SottoTipo/Lingua.
4. Esaminare entrambe le versioni per determinare quale deve rimanere attiva.
5. Aprire l'OmniScript che si desidera disattivare.
6. Deselezionare la casella di controllo Attivo e salvare le modifiche.
7. Tornare alla nuova versione e attivarla.

Avvertenza Prima di attivare una nuova versione, testarla accuratamente in un ambiente di anteprima o Sandbox. Quando si è pronti per la distribuzione, disattivare la vecchia versione e attivare immediatamente quella nuova per ridurre al minimo i tempi di inattività.

• Il campo Tipo è vuoto o nullo
• Il campo Sottotipo è vuoto o nullo
• Il campo Lingua non è selezionato
• Tentativo di salvare un nuovo OmniScript senza compilare tutti i campi obbligatori

Assicurarsi di disporre delle autorizzazioni per modificare i record OmniScript e completare queste operazioni.

1. Dal Programma di avvio app, trovare e selezionare OmniScript.
2. Nel riquadro delle proprietà Omniscript, individuare il campo Tipo.
3. Immettere un nome Tipo descrittivo, ad esempio CustomerOnboarding o ClaimSubmission.
4. Individuare il campo Sottotipo e immettere un nome Sottotipo specifico, ad esempio Residenziale o Commerciale.
5. Selezionare una Lingua dall'elenco a discesa.
6. Assicurarsi che tutti e tre i campi siano compilati e salvare le modifiche.
7. Tornare alla nuova versione e attivarla.

Suggerimento Scegliere nomi di tipo e sottotipo significativi che indicano chiaramente lo scopo dell'OmniScript. Questi valori diventano parte del modo in cui si fa riferimento all'OmniScript nelle applicazioni e non possono essere modificati facilmente dopo la creazione.

• I campi Tipo o Sottotipo contengono spazi
• I campi Tipo o Sottotipo contengono caratteri di sottolineatura
• I campi Tipo o Sottotipo contengono caratteri speciali non supportati: !@#$%^&* e così via
• I campi Tipo o Sottotipo contengono trattini o altri segni di punteggiatura

1. Esaminare i valori Tipo e Sottotipo.
2. Rimuovere tutti gli spazi - utilizzare UpperCamelCase (o PascalCase). Ad esempio, CustomerOnboarding.
3. Rimuovere eventuali caratteri di sottolineatura e sostituirli con UpperCamelCase (o PascalCase).
4. Rimuovere tutti i caratteri speciali.
5. Assicurarsi che vengano utilizzate solo lettere (A-Z, a-z) e numeri (0-9).
6. Salva le modifiche.

Suggerimento Utilizzare PascalCase (chiamato anche UpperCamelCase) per i valori Tipo e Sottotipo. Ciò migliora la leggibilità senza richiedere spazi o sottolineature.

• Il valore del tipo è troppo lungo.
• Il valore Sottotipo è troppo lungo.
• Tipo combinato + Sottotipo + Lingua supera il limite di caratteri.

1. Rivedere il messaggio di errore per vedere la lunghezza massima consentita.
2. Abbreviare il valore Tipo o Sottotipo.
3. Salva le modifiche.

Suggerimento Utilizzare le abbreviazioni dove necessario. Rimuovere le parole ridondanti. Utilizzare una convenzione di denominazione più breve.

Il campo Tipo o Sottotipo utilizza una parola chiave riservata. Le parole chiave limitate più comuni includono: in, out, exc, cb, kt, vt, v, x785f, x5f

Come suggerito nel messaggio di errore, sostituire la parola chiave restricted con un valore diverso. Per ulteriori informazioni, vedere Parole riservate nella pagina delle convenzioni di denominazione OmniStudio.

• Tentativo di aggiungere un nuovo elemento a un OmniScript attivo.
• Tentativo di modificare un elemento esistente in un OmniScript attivo.
• Tentativo di eliminare un elemento da un OmniScript attivo.
• OmniScript è attivo e in uso.

Assicurarsi di disporre delle autorizzazioni per modificare i record OmniScript e completare queste operazioni.

1. Verificare se l'OmniScript è attualmente attivo.
2. Valutare la possibilità di creare una nuova versione anziché modificare quella attiva.
3. Per creare una nuova versione: Fare clic su Clona nell'OmniScript.
4. Per modificare l'esistente: Disattivare deselezionando la casella di controllo Attivo e salvare le modifiche.
5. Ora è possibile aggiungere, aggiornare o eliminare elementi.
6. Testare le modifiche.
7. Attivare OmniScript quando si è pronti per l'uso.

Avvertenza Si consiglia di creare una nuova versione per apportare modifiche significative anziché disattivare e modificare la versione attiva. Ciò consente di eseguire test approfonditi prima della distribuzione e offre un'opzione di ritiro semplice in caso di problemi.

• Un altro elemento nello stesso OmniScript ha lo stesso nome.
• Denominare la collisione tra gli elementi in fasi diverse.
• L'elemento è stato copiato e il nome non è stato modificato.

1. Esaminare tutti gli elementi dell'OmniScript.
2. Identificare gli elementi con nomi in conflitto.
3. Decidere quale elemento deve mantenere il nome.
4. Rinominare l'altro elemento con un nome univoco.
5. Valutare la possibilità di utilizzare prefissi per indicare la fase o la sezione, ad esempio step1_firstName, step2_firstName.
6. Aggiornare le formule o le mappature dei dati che fanno riferimento all'elemento rinominato e salvare le modifiche.

• OmniScript proviene da un pacchetto gestito e non si dispone delle autorizzazioni per modificarlo o eliminarlo.
• Tentativo di aggiornare un OmniScript inserito in un pacchetto dall'esterno dello spazio dei nomi del pacchetto.

1. Verificare se l'OmniScript proviene da un pacchetto gestito.
2. Se è necessario personalizzare l'OmniScript, clonarlo.
3. Rinominare la versione clonata con la propria combinazione Tipo/Sottotipo/Lingua.
4. Apportare le modifiche desiderate alla versione clonata, salvare e attivare l'OmniScript.
5. Aggiornare le formule o le mappature dei dati che fanno riferimento all'elemento rinominato e salvare le modifiche.

Suggerimento Contattare il fornitore del pacchetto o l'amministratore Salesforce se è necessario apportare modifiche ai componenti del pacchetto. Possono fornire opzioni di configurazione o punti di estensione che non richiedono la modifica diretta dell'OmniScript inserito nel pacchetto.

• OmniScript è riutilizzabile.
• OmniScript contiene elementi OmniScript (OmniScript incorporati).
• Tentativo di rendere riutilizzabile un OmniScript dopo l'aggiunta di OmniScript incorporati

1. Decidere se questo OmniScript deve essere riutilizzabile o contenere OmniScript incorporati.
2. Opzione 1: Mantienilo riutilizzabile - Rimuovi tutti gli elementi OmniScript incorporati
3. Opzione 2: Consenti incorporamento: Deselezionare la casella di controllo Riutilizzabile.
4. Se si stanno rimuovendo gli OmniScript incorporati, valutare la possibilità di utilizzare le Procedure di integrazione. È possibile rifattorizzare la logica in procedure di integrazione che possono essere chiamate dall'OmniScript.

Suggerimento Utilizzare le procedure di integrazione per la logica aziendale condivisa anziché nidificare OmniScript riutilizzabili. Questo crea un'architettura più pulita ed evita la complessità delle dipendenze OmniScript.

• Un'altra FlexCard con lo stesso Nome è già attiva.
• Tentativo di attivare una nuova versione senza disattivare quella precedente.

1. Cercare FlexCard con lo stesso campo Nome.
2. Esaminarle per determinare quali devono rimanere attive.
3. Aprire la FlexCard che si desidera disattivare.
4. Deselezionare la casella di controllo Attivo per disattivare la FlexCard e salvare le modifiche.

Avvertenza La disattivazione immediata di una FlexCard influisce immediatamente su tutti gli utenti e i processi che la utilizzano attualmente. Valutare la possibilità di creare una nuova versione anziché modificare quella attiva se è necessario mantenere la continuità del servizio.

1. Verificare se la FlexCard proviene da un pacchetto gestito.
2. Se è necessario rimuoverlo dall'uso, disattivarlo anziché eliminarlo.
3. A questo scopo, aprire la FlexCard e deselezionare la casella di controllo Attivo.
4. Se è necessaria una versione personalizzata della FlexCard, clonarla.

Suggerimento Contattare il fornitore del pacchetto o l'amministratore Salesforce se è necessario apportare modifiche ai componenti del pacchetto. Possono fornire opzioni di configurazione o punti di estensione che non richiedono la modifica diretta della FlexCard inserita nel pacchetto.

• Il nome della FlexCard controllata è scritto in modo errato.
• La FlexCard controllata esiste ma non è attiva.
• La FlexCard controllata è stata eliminata.
• La FlexCard controllata si trova in uno spazio dei nomi diverso.

1. Dal Programma di avvio app, trovare e selezionare Prendere nota del nome FlexCard secondario dal messaggio di errore.
2. Cercare la FlexCard controllata per nome.
3. Se viene trovato ma non è attivo, attivarlo.
4. Se non viene trovato, verificare il nome corretto.
5. Se il nome non è corretto, aggiornare la configurazione FlexCard controllante.
6. Nella FlexCard controllante, individuare il riferimento FlexCard controllato.
7. Correggere il nome in modo che corrisponda a una FlexCard attiva esistente e salvare la FlexCard controllante.

Nota Le FlexCard secondarie devono essere attivate prima che la FlexCard controllante possa farvi riferimento. Creare e testare prima le FlexCard secondarie, quindi configurare le FlexCard principali per il loro utilizzo.

• Il tipo/sottotipo/lingua dell'Omniscript non è corretto.
• OmniScript esiste ma non è attivo.
• L'OmniScript è stato eliminato.
• Il tipo/sottotipo/lingua dell'Omniscript è stato modificato.

1. Prendere nota di Tipo, Sottotipo e Lingua nel messaggio di errore.
2. Cercare OmniScript con Tipo e Sottotipo corrispondenti.
3. Verificare le corrispondenze Lingua.
4. Se viene trovato ma non è attivo, attivare l'OmniScript.
5. Se non viene trovata, verificare i valori Tipo/Sottotipo/Lingua corretti.
6. Tornare alla FlexCard e aggiornare il riferimento OmniScript con i valori corretti.
7. Salva le modifiche.

Suggerimento Assicurarsi che l'OmniScript con riferimenti sia attivo prima di attivare la FlexCard. Se si distribuiscono entrambi insieme, attivare prima OmniScript.

• Il nome del Data Mapper è scritto in modo errato.
• Data Mapper esiste ma non è attivo.
• Data Mapper è stato eliminato.
• Il nome di Data Mapper è stato modificato.

1. Prendere nota del nome di Data Mapper dal messaggio di errore.
2. Cercare Data Mapper per nome.
3. Se viene trovato ma non è attivo, attivarlo.
4. Se non viene trovato, verificare il nome corretto.
5. Tornare alla FlexCard, aggiornare il riferimento a Data Mapper con il nome corretto e salvare le modifiche.

Suggerimento Attivare i Data Mapper prima di attivare le FlexCard che fanno riferimento a essi. Testare Data Mapper in modo indipendente per assicurarsi che restituisca la struttura di dati prevista.

• Il nome della procedura di integrazione non è corretto.
• Data Mapper esiste ma non è attivo.
• Data Mapper è stato eliminato.
• Si sta utilizzando il formato di denominazione errato (dovrebbe essere il formato Type_SubType).

1. Prendere nota del nome della procedura di integrazione nel messaggio di errore.
2. Cercare la procedura di integrazione.
3. Verificare che esista e prendere nota del relativo tipo e sottotipo.
4. Se viene trovato ma non è attivo, attivarlo.
5. Tornare alla FlexCard.
6. Aggiornare il riferimento alla procedura di integrazione utilizzando il formato: Type_SubType e salvare le modifiche.

Avvertenza Alle procedure di integrazione viene fatto riferimento utilizzando il rispettivo OmniProcessKey, che segue il formato Type_SubType. Assicurarsi di utilizzare il formato corretto quando si configura la FlexCard.

• Tentativo di rinominare una FlexCard esistente.
• Tentativo di modificare l'autore di una FlexCard esistente.
• UniqueName viene utilizzato da altri componenti e non può essere modificato.

1. Se è necessario un nome o un autore diverso, clonare la FlexCard.
2. Individuare la FlexCard e clonarla.
3. Immettere il nuovo Nome o Autore.
4. Apportare tutte le altre modifiche necessarie alla versione clonata e attivare la nuova FlexCard.
5. Aggiornare tutti i componenti che fanno riferimento alla FlexCard precedente per utilizzare quella nuova.
6. Disattivare la FlexCard precedente una volta aggiornati tutti i riferimenti.

• Il Nome procedura di integrazione inizia con FileBased.
• Il tipo di procedura di integrazione inizia con filebased.
• Il sottotipo Procedura di integrazione inizia con FileBased.

1. Aprire la procedura di integrazione.
2. Controllare i campi Nome, Tipo e Sottotipo.
3. Se si inizia con FileBased, scegliere un prefisso diverso.
4. Valutare la possibilità di utilizzare prefissi come File, Documento, Dati o il nome dell'organizzazione.
5. Aggiornare i campi soggetti a errori e salvare le modifiche.

• Lo schema di input JSON ha oggetti nidificati con profondità superiore a 10 livelli.
• Lo schema di output JSON ha oggetti nidificati con profondità superiore a 10 livelli.

1. Rivedere la struttura dello schema JSON.
2. Identificare le sezioni profondamente nidificate.
3. Appiattire la struttura riducendo i livelli di nidificazione.
4. Valutare la possibilità di spostare dati profondamente nidificati in procedure di integrazione separate.
5. Utilizzare matrici con oggetti più piatti anziché gerarchie profondamente nidificate.
6. Ristrutturare per mantenere la nidificazione sotto i 10 livelli.
7. Salvare lo schema aggiornato.

Gli schemi JSON della procedura di integrazione hanno un limite massimo di 500 chiavi in tutta la struttura. Sono incluse tutte le chiavi di tutti i livelli di nidificazione combinati. Nello specifico:

• Lo schema di input JSON contiene più di 500 chiavi in totale.
• Lo schema di output JSON contiene più di 500 chiavi in totale.
• Lo schema include un numero elevato di campi in più oggetti nidificati.

1. Rivedere lo schema JSON.
2. Contare il numero totale di chiavi in tutti i livelli.
3. Identificare le sezioni con chiavi eccessive.
4. Valutare la possibilità di suddividere la procedura di integrazione in più procedure più piccole.
5. Rimuovere le chiavi inutilizzate o ridondanti.
6. Utilizzare le matrici per rappresentare strutture ripetute anziché chiavi numerate.
7. Consolidare i campi correlati in oggetti secondari.
8. Salvare lo schema ottimizzato.

Suggerimento Se sono necessarie più di 500 chiavi, valutare la possibilità di suddividere il processo in più procedure di integrazione che possono essere concatenate.

• L'sObject selezionato non è supportato per le operazioni di Data Mapper.
• L'sObject selezionato è un oggetto di sistema che non supporta le query.
• L'sObject selezionato non dispone del supporto API necessario per l'utilizzo con Data Mappers.

1. Esaminare l'sObject selezionato come tipo di input e controllare la Guida di Salesforce per gli oggetti supportati.
2. Valutare la possibilità di utilizzare un oggetto correlato diverso supportato.
3. Se sono necessari dati dall'oggetto non supportato, utilizzare invece una procedura di integrazione con Apex personalizzato.
4. Aggiornare la configurazione di Data Mapper con un oggetto supportato e salvare le modifiche.

Nota Sono supportati la maggior parte degli oggetti standard e personalizzati. Se si verifica un oggetto non supportato, valutare se è possibile ristrutturare il flusso di dati per utilizzare un'alternativa supportata.

• OmniAnalytics per OmniStudio non è abilitato.
• L'organizzazione non è stata configurata per OmniAnalytics.

1. Accedere come Amministratore di sistema e da Imposta cercare Impostazioni OmniStudio o Configurazioni Omni Interaction.
2. Individuare l'impostazione OmniAnalytics for Core e abilitarla.
3. Salvare le modifiche e attendere alcuni minuti prima che abbiano effetto.
4. Verificare se il tracciamento analitico funziona.

Nota Verificare che Decision Explainer sia configurato correttamente.

• L'ID non è in formato Salesforce ID valido, con 15 o 18 caratteri.
• L'ID non appartiene all'oggetto OmniTrackingComponentDef.
• La definizione del componente di tracciamento è stata eliminata.
• L'ID è nullo o in formato non corretto.

1. Verificare l'ID definizione componente in uso.
2. Passare a Imposta > Omnistudio > Analytics Tracking e trovare la definizione del componente di tracciamento corretta.
3. Copiare l'ID corretto dal record.
4. Aggiornare il codice o la configurazione con l'ID corretto.
5. Se la definizione è stata eliminata, creare una nuova definizione del componente di tracciamento. Vedere Creazione di un gruppo di tracciamento e Aggiunta di componenti da tracciare.
6. Testare nuovamente il tracciamento.

Nota Verificare che Decision Explainer sia configurato correttamente.