Обновление жестко запрограммированных ссылок

Общие вопросы и ответы

1. Что такое жестко запрограммированные ссылки (или специальные ссылки экземпляра)?

а) Жестко запрограммированная ссылка — это URL-адрес, содержащий имя экземпляра (например, na1.salesforce.com). Замените данные жестко запрограммированные ссылки на общие специальные или относительные URL-адреса (например, login.salesforce.com или <мойДомен>.my.salesforce.com).

Пример жестко запрограммированной ссылки: https://na1.salesforce.com/{Case.Id}.
Удалите компонент "na1.salesforce.com" для получения относительной ссылки: /{Case.Id}.

ПРИМЕЧАНИЕ. Внутри системы Salesforce относительные ссылки автоматически открывают пользователю нужную запись. Внешние запросы должны быть отправлены на общую конечную точку (например, https://login.salesforce.com вместо https://na1.salesforce.com).
 

2. Как искать жестко запрограммированные ссылки?

a) Воспользуйтесь инструментом Salesforce по имени "Проверка готовности к использованию Lightning Experience" для обнаружения жестко запрограммированных ссылок. Данный инструмент позволяет также определить степень готовности к использованию Lightning Experience.
В интерфейсе Lightning последовательно выберите пункты "Настройка" | "Lightning Experience" | "Проверить готовность".
В интерфейсе Classic выберите меню "Настройка", нажмите кнопку "Начало работы" в разделе "Помощник по миграции Lightning Experience" и щелкните "Проверить готовность".

Обратите внимание, что инструмент "Проверка готовности к использованию Lightning Experience" обнаруживает не все жестко запрограммированные ссылки. Дополнительную информацию о данном инструменте см. здесь.

б) Воспользуйтесь Salesforce Extensions for Visual Studio Code для поиска жестко запрограммированных ссылок.
Salesforce Extensions for Visual Studio Code — это инструмент разработчика, который может использоваться для поиска жестко запрограммированных ссылок. Чтобы обновить жестко запрограммированные ссылки* в организации и метаданных организации (настройка или код клиента), выполните соответствующие действия (см. здесь).

3. Как обновить жестко запрограммированные ссылки в интеграциях?

При наличии интеграций с продуктами Salesforce или Force.com воспользуйтесь запросом login() интерфейса Force.com API для начала работы. Запрос login() должен быть отправлен на общую конечную точку (например, https://login.salesforce.com/services/Soap/u/26.0).
Вызов login() устанавливает сеанс Force.com и отправляет ответ, содержащий URL-адрес сервера входа. Задайте данный URL-адрес сервера в качестве целевого сервера для последующих запросов API и укажите возвращенный код сеанса в заголовке SOAP с целью выполнения авторизации сервера для последующих запросов API.

Вопросы и ответы, связанные с обновлением экземпляра и миграцией организации
Вопросы, связанные с жестко запрограммированными ссылками, могут быть полезными при подготовке к переходу на новый экземпляр.

4. Какие жестко запрограммированные ссылки могут перенаправляться серверами Salesforce после перехода на новый экземпляр?

Поскольку не все жестко запрограммированные ссылки подлежат перенаправлению после обновления экземпляра или миграции организации, компания Salesforce настоятельно рекомендует внедрить функцию "Мой домен" и заранее удалить все жестко запрограммированные ссылки. Ниже перечислены элементы, которые могут перенаправляться серверами Salesforce. Тем не менее, при использовании данных объектов после перехода на новый экземпляр может снижаться производительность. 

i) Ссылки обозревателя
ii) URL-адреса закладок
iii) Настраиваемые кнопки
iv) URL-адреса содержимого
v) Сообщения Chatter
vi) URL-адреса входа на портал самообслуживания (sserv/login.jsp?orgid)
vii) Интеграции

5. Какие жестко запрограммированные ссылки должны быть обновлены перед переходом на новый экземпляр?

При отсутствии функции "Мой домен" жестко запрограммированные ссылки должны быть обновлены в шаблонах эл. почты и статьях Knowledge.
Независимо от наличия функции "Мой домен", все изображения внутри статей Knowledge и шаблонов эл. почты должны быть проверены на предмет их загрузки из компьютера (не по веб-адресу) для продолжения их отображения после обслуживания.

i) При наличии изображений, вставленных посредством веб-адреса, рекомендуем сначала загрузить изображение на компьютер, а затем выполнить его повторную загрузку посредством параметра "Загрузить изображение" при вставке изображения в статью Knowledge или шаблон эл. почты. См. рисунки ниже.

ПРИМЕЧАНИЕ. При повреждении изображений после обслуживания ввиду их неправильной загрузки рекомендуем заменить имя предыдущего экземпляра в URL-адресе изображения именем нового экземпляра. Затем рекомендуем загрузить изображение на компьютер и выполнить его повторную загрузку из компьютера во избежание повреждения изображения после будущих обслуживаний.

6. Как проверить все изображения внутри статей Knowledge и шаблонов эл. почты на предмет их загрузки из компьютера (не по веб-адресу)?

При загрузке изображения из локального компьютера URL-адрес изображения должен выглядеть следующим образом: "https://[ХОСТ-ИЛИ-МОЙ-ДОМЕН]/servlet/rtaImage…".

При добавлении ссылки на изображение из веб-адреса (или вкладки "Документы") URL-адрес изображения должен выглядеть следующим образом: "https://[ХОСТ-ИЛИ-МОЙ-ДОМЕН]/servlet/servlet.ImageServer..." или "https://[ХОСТ-ИЛИ-МОЙ-ДОМЕН]/servlet/servlet.FileDownload…".

7. Требуется ли обновление жестко запрограммированных ссылок в моих интеграциях CTI при переходе на новый экземпляр?

При использовании Open CTI и жестком программировании URL-адреса адаптера CTI в определении центра обработки вызовов посредством экземпляра Salesforce (например, https://c.na6-visual.force.com/apex/Softphone) данное изменение влияет на интеграцию CTI.
Чтобы гарантировать работоспособность интеграции CTI после перехода на новый экземпляр, замените данную жестко запрограммированную ссылку на относительный URL-адрес (например, /apex/Softphone). Чтобы выполнить обновление, последовательно выберите пункты: "Настройка" > "Центры обработки вызовов".

При использовании Salesforce Desktop CTI Integration Toolkit данное обслуживание не влияет на интеграцию CTI ввиду отсутствия поддержки жестко запрограммированных ссылок.

8. Требуется ли обновление моих кодов потоков эл. почты при переходе на новый экземпляр?

При создании настраиваемых кодов потоков эл. почты переход на новый экземпляр может повлиять на работу организации. В противном случае, обновление текущих кодов потоков эл. почты, созданных системой Salesforce, не потребуется после перехода на новый экземпляр (даже при дальнейшем упоминании имени предыдущего экземпляра).

Чтобы исправить настраиваемый код потока эл. почты, просмотрите действия ниже.
i) Обновите настраиваемую формулу в соответствии с форматом ниже. ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii) Где переменные yyyyy и bbbbb заменяются 10-значным кодом без начальных нулей.
iii) Наш системный код поддерживает синтаксический анализ следующих форматов кода потока эл. почты (переменные yyyyy и bbbbb заменяются кодом записи без начальных нулей):

Обратите внимание, что формат ref:00DXyyyyy.500Abbbbb:ref является устаревшим, поэтому больше не используется.

Со временем компания Salesforce может изменять форматы, поэтому клиентам следует избегать создания собственных кодов потоков. При наличии настраиваемых кодов потоков использование функции On-Demand Email-to-Case может быть проблематичным, поскольку создаваемые обращения не прикрепляются к исходному обращению с ответами. Не рекомендуем создавать собственные настраиваемые форматы кода потока. Настраиваемые формулы для кодов потоков обращений не поддерживаются официально, поэтому клиентам рекомендуется использовать стандартную формулу кода потока, которая создается системой Salesforce. Дополнительную информацию см. здесь.

9. Будет ли партнерский портал доступен клиентам посредством устаревшего URL-адреса экземпляра после перехода на новый экземпляр?

Партнерский портал будет доступен клиентам посредством устаревшего URL-адреса экземпляра примерно в течение 30 дней после перехода на новый экземпляр. По истечении 30 дней устаревший URL-адрес входа будет аннулирован. Прежде чем выполнить переход на новый экземпляр, рекомендуем администраторам добавить настраиваемое примечание под сообщением "Обслуживание системы" на партнерском портале организации, указывающее клиентам на необходимость использования нового URL-адреса партнерского портала после перехода на новый экземпляр. Кроме того, администраторы могут рекомендовать клиентам обновить закладки на страницы входа посредством нового URL-адреса партнерского портала.

10. Влияет ли данное изменение на процессы Web-to-Lead/Web-to-Case после перехода на новый экземпляр?

Жестко запрограммированные ссылки, используемые в процессах Web-to-Lead/Web-to-Case, должны быть заменены относительными URL-адресами перед переходом на новый экземпляр. В противном случае, процессы Web-to-Lead/Web-to-Case могут вызывать непреднамеренный сбой системы после обслуживания. Процессы Web-to-Lead/Web-to-Case добавляются в очередь и обрабатываются после завершения обслуживания.

11. Требуется ли обновление имен удаленных узлов после перехода на новый экземпляр?

Да. При отсутствии функции "Мой домен" жестко запрограммированные ссылки в именах удаленных узлов должны быть заменены именем нового экземпляра сразу после обслуживания.
В противном случае, удаленные узлы могут вызывать непреднамеренный сбой системы.

12. Влияет ли переход на новый экземпляр на пакет Salesforce Mobile SDK?

Переход на новый экземпляр может влиять на данные приложений, созданных посредством пакета Salesforce Mobile SDK, при условии, что используемые версии не являются последними. Рекомендуем обновить все приложения, созданные посредством пакета Salesforce Mobile SDK, и отправить данные обновления всем пользователям организации перед обслуживанием.
При использовании последних версий всех приложений, созданных посредством пакета Salesforce Mobile SDK, переход на новый экземпляр не должен влиять на данные внутри приложений.

13. Что делать при наличии внедрения Live Agent или SOS?

Если веб-страница или сертификат использует жестко запрограммированную ссылку на URL-адрес конечной точки Live Agent, то обновление экземпляра, миграция организации или переключение местоположений может повлиять на функции Live Agent/SOS. Чтобы минимизировать возможные последствия, выполните наши рекомендации и удалите любые жестко запрограммированные ссылки на конечную точку, а также обновите URL-адрес конечной точки в коде, скопированном на странице "Развертывание" в меню "Настройка". Предоставленный код развертывания поддерживает перенаправление на недавно назначенный сервер, но конечная точка должна быть все равно обновлена сразу после завершения обновления. 

Дополнительную информацию о конечных точках Live Agent и сути жесткого программирования конечной точки см. здесь.

14. Что необходимо сделать при использовании документов WSDL, созданных веб-службами Apex?

При использовании документов WSDL для создания кода рекомендуем проверить все области, содержащие код, на наличие жестко запрограммированных ссылок. Все жестко запрограммированные ссылки должны быть заменены URL-адресом функции "Мой домен" или относительным URL-адресом (login.salesforce.com). Прежде чем выполнить переход на новый экземпляр, рекомендуем внедрить функцию "Мой домен". Данное действие гарантирует, что после исправления всех жестко запрограммированных ссылок с целью перенаправления на новый URL-адрес функции "Мой домен" повторное выполнение данной процедуры не потребуется.