Dropbox для Salesforce: расширенные настройки для администраторов

Обновление Dec 18, 2023

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

Использование настраиваемых или стандартных объектов, не включенных в конфигурацию по умолчанию

Чтобы использовать настраиваемые объекты или объекты, которые не были включены в конфигурацию по умолчанию (Организация (Account), Контакт (Contact), Обращение (Case), Возможность (Opportunity), Интерес (Lead)), выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Инструменты платформы (Platform Tools) нажмите Настраиваемый код (Custom Code).
Нажмите Страницы Visualforce (Visualforce Pages).
В списке страниц нажмите Создать новый (New).
Добавьте Метку (Label) и Имя (Name) для страницы Visualforce.
Замените разметку Visualforce на один из двух вариантов кода, представленных ниже. Значение параметра standardController нужно будет заменить на API-имя (API name) объекта. API-имя стандартного объекта совпадает с именем стандартного объекта. Например, API-именем объекта «Контракты» является «Контракт».

Dropbox для [Объект]:

<apex:page standardController="INSERT—API—NAME—HERE" docType="html-5.0" showHeader="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false">
<Dropbox_for_SF:Dropbox />
</apex:page>

Все из Dropbox для [Объект]:

<apex:page standardController="INSERT—API—NAME—HERE" docType="html-5.0" showHeader="false" sidebar="false" applyHtmlTag="false" applyBodyTag="false">
  <Dropbox_for_SF:Dropbox AllDropbox="true" />
</apex:page>

Нажмите Сохранить (Save).

Если вы не используете Salesforce Lightning, выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
В разделе Создать (Build) нажмите Правка (Develop).
Нажмите Страницы Visualforce (Visualforce Pages).
В списке страниц нажмите Создать новый (New).
Добавьте Метку (Label) и Имя (Name) для страницы Visualforce.
Замените разметку Visualforce на указанный выше код. Значение параметра standardController нужно будет заменить на API-имя (API name) объекта. API-имя стандартного объекта совпадает с именем стандартного объекта. Например, API-именем объекта «Контракты» является «Контракт».
Нажмите Сохранить (Save).

Чтобы обновить макет объекта с использованием созданной страницы Visualforce, как описано выше, выполните следующие инструкции:

Нажмите Менеджер объектов (Object Manager).
Выберите объект, который нужно изменить.
Выберите Макеты страницы (Page Layouts).
Выберите макет, который нужно изменить.
Перетащите на страницу раздел (Section) с панели настроек сверху.
Заполните «Название раздела» (Section Name) и выберите макет с одним столбцом.
Нажмите ОК.
Перейдите к элементу «Страницы Visualforce» (Visualforce Pages) и перетащите соответствующую страницу в раздел Dropbox.
Нажмите Сохранить.
После добавления страниц Visualforce нажмите на значок в виде гаечного ключа.
На странице настроек установите в параметрах страницы Visualforce ширину 100 % и высоту 400 пикселей и поставьте галочку напротив опции Показывать линейки прокрутки (Show scrollbars).

Если вы не используете Salesforce Lightning, то вместо этого выполните следующие инструкции:

Нажмите Настройка (Setup).
Используя строку поиска вверху слева, найдите Object Manager.
Выберите объект, который вы хотите изменить, и нажмите Макеты страниц (Page Layouts) слева.
Нажмите на стрелку меню и выберите Редактировать (Edit) рядом с макетом, который вы хотите изменить.
Перетащите на страницу раздел (Section) с панели настроек вверху.
Заполните Название раздела (Section Name) и выберите макет с одним столбцом.
Нажмите ОК.
Перейдите к элементу Страницы Visualforce (Visualforce Pages) и перетащите соответствующую страницу в раздел Dropbox.
Нажмите Сохранить (Save).
После добавления Страниц Visualforce нажмите на значок гаечного ключа.
На странице настроек установите в параметрах страницы Visualforce ширину 100 % и высоту 400 пикселей и поставьте галочку напротив опции Показывать линейки прокрутки (Show scrollbars).

Далее потребуется установить новый триггер для вашего настраиваемого или стандартного объекта, который не является объектом по умолчанию. Для этого:

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Объекты и поля (Objects and Fields) выберите Менеджер объектов (Object Manager).
Выберите настраиваемый объект.
Нажмите Триггеры (Triggers).
Нажмите Создать новый (New).
Скопируйте указанный ниже блок кода и вставьте его в поле для ввода, заменив соответствующие имена.

Trigger <TRIGGER_NAME> on <OBJECT_API_NAME> (after update, after delete) {
    
        if(Trigger.isAfter && Trigger.isUpdate){
            Dropbox_for_SF.HandleRecordChange.OnRecordChange(Trigger.old, Trigger.new);
        }
    
        if(Trigger.isAfter && Trigger.isDelete){
            Dropbox_for_SF.HandleRecordChange.HandleMerge(Trigger.old);
        }
    
    }

Если вы не используете Salesforce Lightning, для установки настраиваемого объекта выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
В разделе Создать (Build) нажмите Новый (Create).
Выберите Объекты (Objects).
Выберите настраиваемый объект.
В разделе Триггеры (Triggers) нажмите Создать новый (New).
Скопируйте указанный выше блок кода и вставьте его в поле для ввода, заменив соответствующие имена.

Чтобы устранить проблему с покрытием кода, выполните следующие инструкции:

В пользовательский набор изменений добавьте указанный ниже код как настраиваемый класс Apex (Apex Class) с именем CustomTests:

@isTest
public class CustomTest
{
  static testMethod void update<OBJECT_API_NAME>() {
      <OBJECT_API_NAME>  a = new <OBJECT_API_NAME> (Name='test');
      insert a;
      Test.startTest();
      a.Name = 'new test';
      update a;
      Test.stopTest();
      system.assertEquals('new test', a.name);
  }
}

Верните все тесты в консоль разработчика (Developer Console).

Как включить Dropbox для Salesforce в Salesforce1 Mobile

Чтобы использовать Dropbox для Salesforce в Salesforce1 Mobile, нужно сначала добавить к макету страницы мобильную карту.

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Инструменты платформы (Platform Tools) нажмите Объекты и поля (Objects and Fields).
Нажмите Менеджер объектов (Object Manager).
Выберите объект, который нужно изменить.
Выберите Макеты страницы (Page Layouts).
Выберите макет, который нужно изменить.
Прокрутите экран вниз до раздела Мобильные карты (Mobile Cards) (только Salesforce1) .
На панели настроек в верхней части экрана нажмите Страницы Visualforce (Visualforce Pages).
Перетащите элемент Mobile Dropbox для [Объект] в раздел Мобильные карты (Mobile Cards) (только Salesforce1).
Нажмите Сохранить.

Дале вы можете сделать настраиваемые объекты доступными для Salesforce1 Mobile. Чтобы обеспечить совместимость настраиваемых объектов с Salesforce1 Mobile, нужно сначала включить эту функцию во время настройки страницы Visualforce. Для отображения настраиваемых объектов выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Инструменты платформы (Platform Tools) нажмите Настраиваемый код (Custom Code).
Нажмите Страницы Visualforce (Visualforce Pages).
Нажмите Создать новый (New).
Задайте для своей страницы Метку (Label) и Имя (Name).
Поставьте галочку рядом со строкой Доступно для мобильных приложений Salesforce и страниц Lightning (Available for Salesforce mobile apps and Lightning Pages).
Скопируйте и вставьте указанный перед этими инструкциями код, заменив текст Вставьте API-имя (Insert API name) на API-имя вашего объекта.
Нажмите Сохранить (Save).

Если вы не используете Salesforce Lightning, то вместо этого выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
В разделе Создать (Build) нажмите Правка (Customize).
В разделе Правка (Customize) выберите объект, который вы хотите изменить, и нажмите Макеты страниц (Page Layouts).
Нажмите Редактирование (Edit) рядом с тем макетом (layout), который вы хотите изменить.
Прокрутите экран вниз до раздела Мобильные карты (Mobile Cards) (только Salesforce1).
На панели настроек в верхней части экрана нажмите Страницы Visualforce (Visualforce Pages).
Перетащите элемент Mobile Dropbox для [Объект] в раздел Мобильные карты (Mobile Cards) (только Salesforce1).
Нажмите Сохранить.

Далее вы можете сделать настраиваемые объекты доступными для Salesforce1 Mobile. Чтобы обеспечить совместимость настраиваемых объектов с Salesforce1 Mobile, нужно сначала включить эту функцию во время настройки страницы Visualforce. Для отображения настраиваемых объектов выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
В разделе Создать (Build) нажмите Правка (Develop).
Нажмите Страницы Visualforce (Visualforce Pages).
В списке страниц нажмите Создать новый (New).
Добавьте Метку (Label) и Имя (Name) для страницы Visualforce.
Задайте для своей страницы Метку (Label) и Имя (Name).
Поставьте галочку рядом со строкой Доступно для мобильных приложений Salesforce и страниц Lightning (Available for Salesforce mobile apps and Lightning Pages).
Скопируйте и вставьте код, указанный ниже, заменив текст Вставьте API-имя (Insert API name) на API-имя вашего объекта.
Нажмите Сохранить (Save).

<apex:page standardController=“INSERT—API—NAME—HERE” docType =“html-5.0” showHeader=“false” sidebar=“false” applyHtmlTag=“false” applyBodyTag="false">
<Dropbox_for_SF:DropboxMobile / >
</apex:page>

Как найти API-имя объекта Salesforce

У каждого объекта Salesforce есть API-имя. Если вы работаете с настраиваемыми объектами, их API-имя можно найти следующим образом:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
В разделе для создания элементов (Build) на левой боковой панели нажмите Новый (Create).
В раскрывающемся меню с вариантами выберите Объекты (Objects).
Нажмите на имя объекта.
Если нажать на метку объекта, отобразится API-имя.

Создание шаблонов записи объектов

Dropbox для Salesforce может создать структуру папок, используя шаблоны папок. Эти папки связывают ваши записи Salesforce с папками в вашем Dropbox.

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

Войдите в систему на сайте Salesforce.
Проверьте, какой адрес электронной почты связан с Dropbox для Salesforce.
- Для этого нажмите на вкладку Параметры Dropbox (Dropbox Options) в своем аккаунте Salesforce.
Откройте папку Документы Salesforce (Salesforce Documents) на сайте dropbox.com.
Нажмите на название папки объекта, с которым вы хотите работать.
Создайте новую папку и назовите ее «template» (шаблон).
Добавляйте в template папки и файлы, которые нужны вам для создания структуры.
В Salesforce нажмите на вкладку Параметры Dropbox (Dropbox Options).
Прокрутите экран до раздела Стандартные настройки для объектов (Standard Object Settings) и нажмите Редактировать (Edit).
Поставьте галочку в поле Включить шаблоны (Enable Templates) напротив объекта, с которым вы хотите работать.
Нажмите Сохранить (Save).

Обратите внимание:

Шаблоны папок не имеют обратного действия: они будут применяться только к новым папкам. Структуры папок, созданные до настройки шаблонов, не будут затронуты.
Чтобы запустить генерирование шаблона в какой-либо записи, добавьте файл в папку Dropbox этой записи в папке Документы Salesforce (Salesforce Documents) в вашем Dropbox.
Шаблоны папок применяются только к объектам, которые находятся в общедоступной папке «Документы Salesforce» (Salesforce Documents). На данный момент они несовместимы с объектами из папки «Личные документы Salesforce» (Private Salesforce Documents).
Шаблоны папок не применяются к настраиваемым объектам или объектам, на которые распространяется действие соглашения об именах.

Дублирование имен записей Salesforce

По умолчанию при изменении имени записи в Salesforce название папки в Dropbox не меняется. Однако вы можете включить функцию автоматического переименования. Тогда при каждом изменении названия папки в Dropbox для Salesforce будет аналогичным образом изменено название папки в Dropbox.

Войдите в систему на сайте Salesforce.
Нажмите на вкладку Параметры Dropbox (Dropbox Options).
Прокрутите экран до раздела Стандартные настройки для объектов (Standard Object Settings) и нажмите Редактировать (Edit).
Установите галочку в поле Перенимать имена записей Salesforce (Follow Salesforce Record Names) рядом с объектами, для которых нужно включить автоматическое переименование.
Нажмите Сохранить (Save).

Обратите внимание:

Если вы включите автоматическое переименование в общей папке, то Dropbox для Salesforce будет обновлять названия для всех ее участников.
Для стандартных объектов можно настроить конфигурацию автоматического переименования по умолчанию. В случае с настраиваемыми объектами для соответствующего объекта необходимо установить триггер, как описано в разделе Использование настраиваемых объектов выше.

Изменение настроек доступа

Администраторы Salesforce могут настраивать Dropbox для Salesforce в соответствии с существующей моделью защиты. По умолчанию Dropbox для Salesforce повторяет модель защиты, используемую в Salesforce.

Изменить настройки общего доступа к интеграции можно следующим образом:

Войдите в систему на сайте Salesforce.
Нажмите на вкладку Параметры Dropbox (Dropbox Options).
Прокрутите экран до раздела Стандартные настройки для объектов (Standard Object Settings) и нажмите Редактировать (Edit).
Установите галочку в поле Перенять права доступа Salesforce (Follow Salesforce Sharing) рядом с объектами, для которых вы хотите включить эту настройку.
Нажмите Сохранить (Save).

Обратите внимание:

Если настройка Перенять права доступа Salesforce (Follow Salesforce Sharing) у вас включена для объектов со значением «Личный» (Private) в параметрах общего доступа по умолчанию для всей организации, то при добавлении файлов или папок через компонент Dropbox для новых записей будет создана папка Личные документы Salesforce (Private Salesforce Documents). Эта папка будет добавлена только в аккаунт Dropbox владельца соответствующей записи.
Новые настройки безопасности не имеют обратной силы: на папки, которые вы создали до изменения настроек безопасности, эти настройки распространяться не будут.
Настройки общего доступа в Salesforce можно найти здесь: Настройки (Setup) > Безопасность (Security) > Настройки доступа (Sharing Settings).
Доступ к папке «Документы Salesforce» (Salesforce Documents) нужно будет предоставить всем участникам рабочей группы, которые используют Dropbox для Salesforce.
Содержимое Dropbox будет отображаться через интеграцию Dropbox для Salesforce только у пользователей Salesforce с доступом к объекту «Личный Salesforce» (Private Salesforce).

Ограничение доступа только для участников рабочей группы

Администраторы Salesforce могут управлять подключением Dropbox к Salesforce.

Войдите в систему на сайте Salesforce.
Нажмите на вкладку Параметры Dropbox (Dropbox Options).
Прокрутите экран вниз до раздела Dropbox Business и нажмите Разрешить вход только пользователям аккаунтов Dropbox Business (Restrict login to Business accounts).
Нажмите Изменить (Edit).
В разделе Доступ Dropbox Business (Dropbox Business Access) отметьте галочкой поле Только участники рабочей группы (Team Members Only).
Нажмите Сохранить (Save).

Предоставление доступа пользователям Saleforce

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Администрирование (Administration) нажмите Пользователи (Users).
Нажмите Профили (Profiles).
Нажмите на имя профиля, который вы хотите изменить.
Прокрутите экран вниз до строки Включенный доступ к странице Visualforce (Enabled Visualforce Page Access) и нажмите Редактировать (Edit).
Выберите все страницы, которые начинаются с «Dropbox_for_SF».
Нажмите на стрелку Добавить (Add).
Нажмите Сохранить (Save).
Прокрутите вниз страницу профиля, с которым вы работали, до раздела Включенный доступ Apex Class (Enabled Apex Class Access) и нажмите Изменить (Edit).
Выберите все классы, которые начинаются с Dropbox_for_SF.
Нажмите на стрелку Добавить (Add).
Нажмите Сохранить (Save).

Если вы не используете Salesforce Lightning, то вместо этого выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
Перейдите в раздел Администрирование (Administer) и нажмите Управление пользователями (Manage Users).
Нажмите Профили (Profiles).
Нажмите на имя профиля, который вы хотите изменить.
Прокрутите экран вниз до строки Включенный доступ к странице Visualforce (Enabled Visualforce Page Access) и нажмите Редактировать (Edit).
Выберите все страницы, которые начинаются с «Dropbox_for_SF».
Нажмите на стрелку Добавить (Add).
Нажмите Сохранить (Save).
Прокрутите вниз страницу профиля, с которым вы работали, до раздела Включенный доступ Apex Class (Enabled Apex Class Access) и нажмите Редактировать (Edit).
Выберите все классы, которые начинаются с wbdbox.
Нажмите на стрелку Добавить (Add).
Нажмите Сохранить (Save).

Создание собственной структуры названий папок

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

К объектам «Контакт» (Contact) применяется стандартное соглашение об именах: Имя, Фамилия (First Name, Last Name). Но вы можете поменять его на схему: Фамилия, Имя (Last Name, First Name). После такого изменения в настройках присвоения имен к вновь создаваемым объектам будут применяться заданные вами параметры.

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Инструменты платформы (Platform Tools) нажмите Объекты и поля (Objects and Fields).
Нажмите Менеджер объектов (Object Manager).
Выберите объект, который нужно изменить.
Нажмите Поля и взаимосвязи (Fields & Relationships).
Нажмите Создать новый (New).
В разделе Тип данных (Data Type) выберите Формула (Formula).
Нажмите Далее.
Введите текст «Custom Dropbox Path» в поле Метка поля (Field Label).
Введите текст «Custom_Dropbox_Path» в поле Название поля (Field Name).
Выберите Текст (Text) в разделе Типы данных, возвращаемых формулой (Formula Return Type), затем нажмите Далее (Next).
Введите формулу (например: "Contact/" & LastName & ", " & FirstName) и нажмите Далее (Next).
Выберите поле Visible (Видимый) рядом с профилями, которым вы хотите предоставить доступ с правом вносить изменения.
Нажмите Далее.
Нажмите Сохранить (Save).

Если вы не используете Salesforce Lightning, то вместо этого выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
В разделе Создать (Build) на левой боковой панели нажмите Правка (Customize).
Выберите Контакты (Contacts).
Нажмите Поля (Fields).
Прокрутите экран вниз до списка Настраиваемые поля и взаимосвязи контакта (Contact Custom Fields & Relationships) и нажмите Создать новый (New).
В разделе Тип данных (Data Type) выберите Формула (Formula).
Нажмите Далее.
Введите текст «custom Dropbox Path» в поле Метка поля (Field Label).
Введите текст «Custom_Dropbox_Path» в поле Название поля (Field Name).
Выберите Текст (Text) в разделе Типы данных, возвращаемых формулой (Formula Return Type), затем нажмите Далее (Next).
Введите формулу и нажмите Далее (Next).
Выберите поле Visible (Видимый) рядом с профилями, которым вы хотите предоставить доступ с правом вносить изменения.
Нажмите Далее.
Нажмите Сохранить (Save).

Обратите внимание:

Папки записей для объектов с настроенным соглашением об именах начнут появляться непосредственно в папке «Документы Salesforce» (Salesforce Documents). Если нужно, чтобы папки записей появлялись в папке объекта (например, «Контакты»), как если бы к ним не применялось настроенное соглашение об именах, необходимо указать это в добавленной формуле. Например, "Контакт/" & Фамилия & ", " & Имя.
Эти изменения не имеют обратного действия: они будут применяться только к новым папкам.
Этот процесс пригоден для всех стандартных и настраиваемых объектов. Можно настраивать адреса папок, добавляя другие поля, текст, числа или даты.

Добавление Dropbox в макеты публикатора

Вы можете сделать так, чтобы интерфейс Dropbox стал доступен в Chatter. Для этого просто добавьте Dropbox в качестве Быстрого действия (Quick Action) в Глобальный публикатор (Global Publisher).

Войдите в систему на сайте Salesforce.
Нажмите значок шестеренки и выберите Настройка (Setup).
В разделе Инструменты платформы (Platform Tools) нажмите Пользовательский интерфейс (User Interface).
Нажмите Глобальные действия (Global Actions).
Нажмите Макеты публикатора (Publisher Layouts).
Выберите объект, который нужно изменить.
Нажмите Поля и взаимосвязи (Fields & Relationships).
В колонке Действия нажмите Редактировать рядом с пунктом Глобальный макет.
Перетащите Dropbox из раздела Быстрые действия (Quick Actions) в раздел Глобальный публикатор (Global Publisher).

Если вы не используете Salesforce Lightning, то вместо этого выполните следующие инструкции:

Войдите в систему на сайте Salesforce.
Нажмите Настройка (Setup).
Нажмите Создать.
Нажмите Глобальные действия (Global Actions).
Нажмите Макеты публикатора (Publisher Layouts).
В колонке Действия нажмите Редактировать рядом с пунктом Глобальный макет.
Перетащите Dropbox из раздела Быстрые действия (Quick Actions) в раздел Глобальный публикатор (Global Publisher).