Распространенные ошибки и решения в Omnistudio

1. Войдите от имени системного администратора.
2. В меню «Настройка» найдите и откройте Omnistudio.
3. Включите полномочие Omnistudio для вашей организации.

Если параметр не отображается, проверьте наличие лицензий Omnistudio в вашей организации. Обратитесь к менеджеру по работе с клиентами Salesforce, если нужны лицензии.

Совет После включения полномочий Omnistudio изменения могут распространиться в организации через несколько минут. Если вы продолжаете видеть эту ошибку, попробуйте выйти и войти обратно.

• Попытка удаления активного Omniscript
• Попытка обновления структурных полей в активном Omniscript
• Попытка изменения типа, подтипа или языка в активном Omniscript

1. В средстве запуска приложений найдите и откройте «Omniscripts».
2. Найдите нужный Omniscript для изменения или удаления.
3. Обратите внимание на текущую версию и предупредите пользователей о предстоящей деактивации.
4. Снимите флажок «Активно», чтобы деактивировать Omniscript и сохранить изменения.
5. Теперь можно внести нужные изменения или удалить Omniscript.
6. Чтобы активировать внесенные изменения, установите флажок «Активно».

Предупреждение! Деактивация Omniscript немедленно влияет на всех пользователей и процессы, использующие его в данный момент. Рекомендуем создать новую версию вместо изменения активной, если вам нужно сохранить непрерывность обслуживания.

• Другой Omniscript с идентичным типом, подтипом и языком уже активен
• Создание новой версии без деактивации предыдущей версии
• Несколько версий, созданных и пытающихся активировать несколько

Убедитесь в наличии полномочий на редактирование записей мультискрипта и выполнение данных задач.

1. В средстве запуска приложений найдите и откройте «Omniscripts».
2. Используйте фильтры или найдите Omniscripts с совпадающими Type и SubType.
3. Определите текущий активный Omniscript с одинаковым Type/SubType/Language.
4. Просмотрите обе версии, чтобы определить, какие из них должны оставаться активными.
5. Откройте Omniscript, который нужно деактивировать.
6. Снимите флажок «Активно» и сохраните изменения.
7. Вернитесь к новой версии и активируйте ее.

Предупреждение! Прежде чем активировать новую версию, тщательно протестируйте ее в среде предварительного просмотра или безопасной среде. Когда будете готовы к развертыванию, деактивируйте старую версию и немедленно активируйте новую, чтобы минимизировать простой.

• Поле типа пустое или нулевое
• Поле подтипа пустое или нулевое
• Поле языка не выбрано
• Попытка сохранения нового Omniscript без заполнения всех обязательных полей

Убедитесь в наличии полномочий на редактирование записей мультискрипта и выполнение данных задач.

1. В средстве запуска приложений найдите и откройте «Omniscripts».
2. На панели свойств Omniscript найдите поле «Тип».
3. Введите описательное имя типа, например, CustomerOnboarding или ClaimSubmission.
4. Найдите поле «Подтип» и введите определенное имя подтипа (например, «Жилой» или «Коммерческий»).
5. Выберите нужный язык в раскрывающемся списке.
6. Убедитесь в заполнении всех трех полей и сохраните изменения.
7. Вернитесь к новой версии и активируйте ее.

Совет Выберите значимые имена Type и SubType, четко обозначающие цель Omniscript. Эти значения становятся частью способа ссылки на Omniscript в приложениях и не могут быть легко изменены после их создания.

• Поля типа или подтипа содержат пробелы
• Поля типа или подтипа содержат подчеркивание
• Поля типа или подтипа содержат неподдерживаемые специальные символы: !@#$%^&* и так далее
• Поля типа или подтипа содержат дефисы или другие знаки препинания

1. Просмотрите значения типов и подтипов.
2. Удалите пробелы - используйте UpperCamelCase (или PascalCase). Например, CustomerOnboarding.
3. Удалите все подчеркивания и замените их на UpperCamelCase (или PascalCase).
4. Удалите все специальные символы.
5. Убедитесь, что используются только буквы (A-Z, a-z) и цифры (0-9).
6. Сохраните внесенные изменения.

Совет Используйте PascalCase (также называемый UpperCamelCase) для значений Type и SubType. Это улучшает читаемость, не требуя пробелов или подчеркиваний.

• Значение типа слишком длинное.
• Значение подтипа слишком длинное.
• Комбинированный тип + подтип + язык превышает ограничение символов.

1. Просмотрите сообщение об ошибке, чтобы увидеть максимально допустимую длину.
2. Сократите значение типа или подтипа.
3. Сохраните внесенные изменения.

Совет При необходимости используйте сокращения. Удалите лишние слова. Используйте более короткое правило наименования.

Поле «Тип» или «Подтип» использует зарезервированное ключевое слово. Распространенные ограниченные ключевые слова включают: in, out, exc, cb, kt, vt, v, x785f, x5f

Как указано в сообщении об ошибке, замените ограниченное ключевое слово другим значением. Дополнительную информацию см. в разделе «Зарезервированные слова» на странице «Условия наименования мультиканала».

• Попытка добавления нового элемента в активный Omniscript.
• Попытка изменения существующего элемента в активном Omniscript.
• Попытка удаления элемента из активного Omniscript.
• Omniscript активен и используется.

Убедитесь в наличии полномочий на редактирование записей мультискрипта и выполнение данных задач.

1. Проверьте активность Omniscript в данный момент.
2. Рекомендуем создать новую версию вместо изменения активной.
3. Для создания новой версии: Нажмите «Клонировать» в Omniscript.
4. Для изменения существующих: Чтобы деактивировать, снимите флажок «Активно» и сохраните внесенные изменения.
5. Теперь можно добавлять, обновлять или удалять элементы.
6. Тестирование изменений.
7. Активируйте Omniscript, когда будете готовы к использованию.

Предупреждение! Рекомендуется создать новую версию для внесения существенных изменений, а не деактивировать и изменять активную версию. Это позволяет тщательно протестировать перед развертыванием и предоставляет удобный вариант отката при возникновении проблем.

• Другому элементу в том же Omniscript задано такое же имя.
• Назовите столкновение элементов на разных этапах.
• Элемент был скопирован, а имя не изменено.

1. Просмотрите все элементы в Omniscript.
2. Определите элементы с конфликтующими именами.
3. Решите, какой элемент должен сохранить имя.
4. Переименуйте другой элемент с уникальным именем.
5. Рекомендуем использовать префиксы для обозначения этапа или раздела (например, step1_firstName, step2_firstName).
6. Обновите формулы или соотнесения данных, ссылающиеся на переименованный элемент, и сохраните изменения.

• Omniscript из управляемого пакета, и у вас нет полномочий на его изменение или удаление.
• Попытка обновления пакетного Omniscript извне пространства имен пакета.

1. Проверьте наличие Omniscript из управляемого пакета.
2. Если вам нужно настроить Omniscript, клонируйте его.
3. Переименуйте клонированную версию посредством собственной комбинации Type/SubType/Language.
4. Внесите нужные изменения в клонированную версию, сохраните и активируйте Omniscript.
5. Обновите формулы или соотнесения данных, ссылающиеся на переименованный элемент, и сохраните изменения.

Совет Обратитесь к поставщику пакета или администратору Salesforce, если вам нужно внести изменения в пакетные компоненты. Они могут предоставлять параметры конфигурации или точки расширения, не требующие изменения пакетного Omniscript напрямую.

• Omniscript можно использовать повторно.
• Omniscript содержит элементы Omniscript (встроенные Omniscript).
• Попытка сделать Omniscript многоразовым после добавления встроенных Omniscript

1. Решите, должен ли этот Omniscript быть многоразовым или содержать встроенные Omniscript.
2. Вариант 1: Сохранить его многоразовым - Удалить все встроенные элементы мультискрипта
3. Вариант 2: Разрешить встраивание: Снимите флажок «Многоразовый».
4. Если вы удаляете встроенные Omniscript, рекомендуем использовать процедуры интеграции. Вы можете изменить логику в процедурах интеграции, которые можно вызвать из Omniscript.

Совет Используйте процедуры интеграции для общедоступной бизнес-логики вместо вложения многоразовых Omniscripts. Это создает более чистую архитектуру и позволяет избежать сложностей в зависимостях Omniscript.

• Другой Flexcard с таким же именем уже активен.
• Попытка активации новой версии без деактивации старой.

1. Найдите Flexcards с одинаковым полем Name.
2. Просмотрите их, чтобы определить, какие из них должны оставаться активными.
3. Откройте Flexcard, который нужно деактивировать.
4. Снимите флажок «Активно», чтобы деактивировать Flexcard и сохранить изменения.

Предупреждение! Деактивация Flexcard немедленно влияет на всех пользователей и процессы, использующие его в данный момент. Рекомендуем создать новую версию вместо изменения активной, если вам нужно сохранить непрерывность обслуживания.

1. Проверьте наличие Flexcard из управляемого пакета.
2. Если вам нужно удалить его из использования, деактивируйте его вместо удаления.
3. Для этого откройте Flexcard и снимите флажок «Активно».
4. Если вам нужна настроенная версия Flexcard, клонируйте ее.

Совет Обратитесь к поставщику пакета или администратору Salesforce, если вам нужно внести изменения в пакетные компоненты. Они могут предоставлять параметры конфигурации или точки расширения, не требующие изменения пакета Flexcard напрямую.

• Имя дочернего имени Flexcard написано неправильно.
• Дочерний Flexcard существует, но неактивен.
• Дочерний Flexcard был удален.
• Дочерний Flexcard находится в другом пространстве имен.

1. В средстве запуска приложений найдите и выберите «Записать имя дочерней Flexcard» в сообщении об ошибке.
2. Найдите дочерний Flexcard по имени.
3. При обнаружении, но неактивности активируйте его.
4. Если не найдено, проверьте правильность имени.
5. Если имя некорректное, обновите родительскую конфигурацию Flexcard.
6. В родительской Flexcard найдите дочернюю ссылку на Flexcard.
7. Исправьте имя в соответствии с существующим активным Flexcard и сохраните родительский Flexcard.

Примечание Дочерние Flexcard должны быть активированы, прежде чем родительский Flexcard сможет ссылаться на них. Сначала создайте и протестируйте дочерние Flexcard, а потом настройте родительские Flexcard для их использования.

• Тип Omniscript/SubType/Language некорректный.
• Omniscript существует, но неактивен.
• Omniscript был удален.
• Тип Omniscript/SubType/Language изменен.

1. Обратите внимание на тип, подтип и язык в сообщении об ошибке.
2. Найдите Omniscript с совпадающими типом и подтипом.
3. Проверьте соответствие языка.
4. При обнаружении, но неактивности активируйте Omniscript.
5. Если не найдено, проверьте корректные значения Type/SubType/Language.
6. Вернитесь в Flexcard и обновите ссылку на Omniscript корректными значениями.
7. Сохраните внесенные изменения.

Совет Убедитесь в активности ссылочного Omniscript перед активацией Flexcard. Если вы развертываете оба компонента вместе, сперва активируйте Omniscript.

• Имя картографа данных написано неправильно.
• Соотнесение данных существует, но неактивно.
• Соотнесение данных было удалено.
• Имя Data Mapper было изменено.

1. Запишите имя составителя данных в сообщении об ошибке.
2. Найдите «Соотнесение данных» по имени.
3. При обнаружении, но неактивности активируйте его.
4. Если не найдено, проверьте правильность имени.
5. Вернитесь в Flexcard, обновите ссылку на Data Mapper с соответствующим именем и сохраните изменения.

Совет Активируйте соотнесения данных, прежде чем активировать ссылающиеся на них Flexcard. Протестируйте приложение Data Mapper независимо, чтобы убедиться, что оно возвращает ожидаемую структуру данных.

• Имя процедуры интеграции некорректное.
• Соотнесение данных существует, но неактивно.
• Соотнесение данных было удалено.
• Вы используете неправильный формат наименования (должен использовать формат Type_SubType).

1. Запишите имя процедуры интеграции в сообщении об ошибке.
2. Найдите процедуру интеграции.
3. Проверьте его наличие и запишите тип и подтип.
4. При обнаружении, но неактивности активируйте его.
5. Вернитесь к Flexcard.
6. Обновите ссылку на процедуру интеграции посредством формата: Type_SubType и сохраните изменения.

Предупреждение! Процедуры интеграции используются посредством OmniProcessKey, который соответствует формату Type_SubType. Убедитесь в правильности формата при настройке Flexcard.

• Попытка переименования существующего Flexcard.
• Попытка изменения автора существующей Flexcard.
• UniqueName используется другими компонентами и не может быть изменено.

1. Если вам нужно другое имя или автор, клонируйте Flexcard.
2. Найдите и клонируйте Flexcard.
3. Введите новое имя или «Автор».
4. Внесите необходимые изменения в клонированную версию и активируйте новую Flexcard.
5. Обновите все компоненты, ссылающиеся на старый Flexcard, чтобы использовать новый.
6. Деактивируйте старый Flexcard после обновления всех ссылок.

• Имя процедуры интеграции начинается на FileBased.
• Тип процедуры интеграции начинается с файла.
• Подтип процедуры интеграции начинается с FileBased.

1. Откройте процедуру интеграции.
2. Проверьте поля «Имя», «Тип» и «Подтип».
3. Если вы хотите начать с FileBased, выберите другой префикс.
4. Рекомендуем использовать префиксы (например, «Файл», «Документ», «Данные» или название организации).
5. Обновите поля, подверженные ошибкам, и сохраните изменения.

• Схема ввода JSON содержит вложенные объекты на глубине более 10 уровней.
• Схема вывода JSON содержит вложенные объекты более 10 уровней.

1. Просмотрите структуру схемы JSON.
2. Определите глубоко вложенные разделы.
3. Выровняйте структуру, уменьшив уровни вложения.
4. Рекомендуем перенести глубоко вложенные данные в отдельные процедуры интеграции.
5. Используйте массивы с более плоскими объектами вместо глубоко вложенных иерархий.
6. Измените структуру, чтобы сохранить вложение до 10 уровней.
7. Сохраните обновленную схему.

Схемы JSON процедуры интеграции имеют максимальное ограничение 500 ключей во всей структуре. Это включает все ключи на всех уровнях вложения вместе. А именно:

• Схема ввода JSON содержит более 500 ключей.
• Схема вывода JSON содержит более 500 ключей.
• Схема содержит большое количество полей в нескольких вложенных объектах.

1. Просмотрите схему JSON.
2. Подсчитайте общее количество ключей на всех уровнях.
3. Определите разделы с избыточными ключами.
4. Рекомендуем разделить процедуру интеграции на несколько меньших процедур.
5. Удалите неиспользуемые или лишние ключи.
6. Используйте массивы для представления повторяющихся структур вместо нумерованных ключей.
7. Объедините связанные поля в подобъекты.
8. Сохраните оптимизированную схему.

Совет Если вам законно нужно более 500 ключей, рекомендуем разделить процесс на несколько процедур интеграции, которые можно сцепить.

• Выбранный sObject не поддерживается для операций Data Mapper.
• Выбранный sObject является системным объектом, не поддерживающим запросы.
• Выбранный sObject не имеет необходимой поддержки API для работы с Data Mappers.

1. Просмотрите sObject, выбранный в качестве типа ввода, и проверьте справку Salesforce на наличие поддерживаемых объектов.
2. Рекомендуем использовать другой поддерживаемый связанный объект.
3. Если вам нужны данные из неподдерживаемого объекта, используйте процедуру интеграции с настраиваемым Apex.
4. Обновите конфигурацию Data Mapper посредством поддерживаемого объекта и сохраните изменения.

Примечание Поддерживается большинство стандартных и настраиваемых объектов. Если вы обнаружите неподдерживаемый объект, подумайте, можно ли изменить структуру потока данных, чтобы использовать поддерживаемую альтернативу.

• OmniAnalytics for Omnistudio не включен.
• Ваша организация не настроена на OmniAnalytics.

1. Войдите от имени системного администратора и найдите в настройках Параметры мультиканала или Конфигурации взаимодействия мультиканала.
2. Найдите и включите параметр OmniAnalytics for Core.
3. Сохраните изменения и подождите несколько минут, пока изменение вступит в силу.
4. Проверьте, работает ли отслеживание аналитики.

Примечание Проверьте правильность настройки пояснения решения.

• Код не соответствует допустимому формату кода Salesforce, содержащему 15 или 18 символов.
• Код не принадлежит объекту OmniTrackingComponentDef.
• Определение компонента отслеживания было удалено.
• Код нулевой или неправильный.

1. Проверьте используемый код определения компонента.
2. Перейдите в меню «Настройка» > «Omnistudio > Analytics Tracking» и найдите правильное определение компонента отслеживания.
3. Скопируйте правильный код из записи.
4. Обновите код или конфигурацию с помощью правильного кода.
5. Если определение было удалено, создайте новое определение компонента отслеживания. См. «Создание группы отслеживания и добавление компонентов в отслеживание».
6. Протестируйте отслеживание еще раз.

Примечание Проверьте правильность настройки пояснения решения.