Dropbox for Salesforce: zaawansowane ustawienia administratora
Po skonfigurowaniu Dropbox dla Salesforce ze standardową konfiguracją warto dostosować integrację Dropbox dla Salesforce zgodnie z opisem w tym artykule.
Użyj niestandardowych lub standardowych obiektów poza domyślną konfiguracją
Aby użyć niestandardowych obiektów lub obiektów spoza tych zawartych w konfiguracji domyślnej (Account, Contact, Case, Opportunity, Lead – konto, kontakt, sprawa, szansa, potencjalny klient), postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Setup.
- W sekcji Platform Tool kliknij opcję Custom Code.
- Kliknij Visualforce Pages.
- Na liście stron kliknij New.
- Dodaj etykietę (Label) i nazwę (Name) dla swojej strony Visualforce.
- Zastąp znacznik Visualforce jedną z dwóch poniższych opcji kodu. Wartość standardController należy zastąpić nazwą obiektu API. W przypadku obiektu standardowego nazwa API jest taka sama jak nazwa obiektu standardowego. Na przykład nazwa API obiektu „Contracts” to „Contract”.
Dropbox for [Object]:
<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>
<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>
- Kliknij Zapisz.
Jeśli nie korzystasz z usługi Salesforce Lightning, postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- W sekcji Build kliknij opcję Develop.
- Kliknij Visualforce Pages.
- Na liście stron kliknij New.
- Dodaj etykietę (Label) i nazwę (Name) dla swojej strony Visualforce.
- Zastąp znacznik Visualforce kodem wyszczególnionym powyżej. Wartość standardController należy zastąpić nazwą obiektu API. W przypadku obiektu standardowego nazwa API jest taka sama jak nazwa obiektu standardowego. Na przykład nazwa API obiektu „Contracts” to „Contract”.
- Kliknij Zapisz.
Aby zaktualizować układ obiektu za pomocą utworzonej powyżej strony Visualforce, należy postępować zgodnie z poniższymi instrukcjami:
- Kliknij Object Manager.
- Wybierz obiekt, który chcesz edytować.
- Kliknij Page Layouts.
- Wybierz układ, który chcesz edytować.
- W górnym okienku ustawień przeciągnij i upuść pole Section na stronę.
- Wypełnij pole Section Name i wybierz układ jako jedną kolumnę.
- Kliknij OK.
- Przejdź do pozycji Visualforce Pages oraz przeciągnij i upuść odpowiednią stronę do sekcji Dropbox.
- Kliknij Zapisz.
- Gdy elementy Visualforce Pages zostaną dodane, kliknij ikonę klucza.
- Na stronie opcji ustaw we właściwościach strony Visualforce szerokość 100% i wysokość 400 pikseli oraz zaznacz pole Show scrollbars.
Jeśli nie korzystasz z usługi Salesforce Lightning, postępuj zgodnie z poniższymi instrukcjami:
- Kliknij Setup (Konfiguracja).
- W lewym górnym pasku wyszukiwania wyszukaj „ObjectManager”.
- Wybierz obiekt, który chcesz edytować i kliknij Page Layouts po lewej stronie.
- Obok układu, na którym chcesz pracować, kliknij strzałkę menu i wybierz Edit.
- W górnym okienku ustawień przeciągnij i upuść pole Section na stronę.
- Wypełnij pole Section Name i wybierz układ jako jedną kolumnę.
- Kliknij OK.
- Przejdź do Visualforce Pages oraz przeciągnij i upuść odpowiednią stronę do sekcji Dropbox.
- Kliknij Zapisz.
- Gdy elementy Visualforce Pages zostaną dodane, kliknij ikonę klucza.
- Na stronie opcji ustaw we właściwościach strony Visualforce szerokość 100% i wysokość 400 pikseli oraz zaznacz pole Show scrollbars.
Następnie skonfiguruj nowy element wyzwalający dla obiektu niestandardowego lub niebędącego domyślnym, wykonując następujące czynności:
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Setup.
- Wybierz Object Manager w sekcji Objects and Fields.
- Wybierz obiekt niestandardowy.
- Kliknij Triggers.
- Kliknij New.
- Skopiuj następujący blok kodu do pola wpisu, podając odpowiednie nazwy.
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);
}
}
Jeśli nie korzystasz z Salesforce Lightning, postępuj zgodnie z tymi instrukcjami, aby skonfigurować wyzwalacz obiektu personalizowanego:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- W sekcji Build kliknij Create.
- Wybierz Objects.
- Wybierz obiekt niestandardowy.
- W sekcji Triggers kliknij New.
- Skopiuj powyższy blok kodu do pola wpisu, podając odpowiednie nazwy.
Aby rozwiązać problem z pokryciem kodu, wykonaj poniższe kroki:
- Dodaj następujący kod jako niestandardową klasę Apex o nazwie CustomTests w niestandardowym zbiorze zmian:
@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);
}
}
- Ponownie uruchom wszystkie testy w opcji Developer Console.
Włącz Dropbox dla Salesforce w usłudze Salesforce1 Mobile
Aby korzystać z Dropbox for Salesforce w usłudze Salesforce1 Mobile, należy dodać kartę mobilną do widoku strony.
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Settings.
- W sekcji Platform Tools kliknij Objects and Fields.
- Kliknij Object Manager.
- Wybierz obiekt, który chcesz edytować.
- Kliknij Page Layouts.
- Wybierz układ, który chcesz edytować.
- Przewiń w dół do sekcji Mobile Cards (tylko w Salesforce1).
- W polu ustawień u góry ekranu kliknij Visualforce Pages.
- Przeciągnij i upuść Mobile Dropbox for [Object] do sekcji Mobile Cards (tylko w Salesforce1).
- Kliknij Zapisz.
Następnie możliwe będzie udostępnianie niestandardowych obiektów w Salesforce1 Mobile. Aby niestandardowe obiekty były zgodne z Salesforce1 mobile, należy najpierw włączyć tę funkcję podczas konfigurowania strony Visualforce. Wykonaj poniższe czynności, aby umożliwić wyświetlanie obiektów niestandardowych:
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Settings.
- W sekcji Platform Tool kliknij opcję Custom Code.
- Kliknij Visualforce Pages.
- Kliknij New.
- Nadaj stronie etykietę (Label) oraz nazwę (Name).
- Zaznacz pole Available for Salesforce mobile apps and Lightning Pages.
- Skopiuj i wklej kod poprzedzający te instrukcje, zastępując wstawianą nazwę interfejsu API nazwą obiektu API.
- Kliknij Zapisz.
Jeśli nie korzystasz z usługi Salesforce Lightning, postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- W sekcji Build kliknij Customize.
- Wybierz obiekt, który chcesz edytować w sekcji Customize, a następnie kliknij przycisk Page Layouts.
- Obok układu, na którym chcesz pracować, kliknij Edit (Edytuj).
- Przewiń w dół do sekcji Mobile Cards (tylko w Salesforce1).
- W polu ustawień u góry ekranu kliknij Visualforce Pages.
- Przeciągnij i upuść Mobile Dropbox for [Object] do sekcji Mobile Cards (tylko w Salesforce1).
- Kliknij Zapisz.
Następnie możliwe będzie udostępnianie niestandardowych obiektów w Salesforce1 Mobile. Aby niestandardowe obiekty były zgodne z Salesforce1 mobile, należy najpierw włączyć tę funkcję podczas konfigurowania strony Visualforce. Wykonaj poniższe czynności, aby umożliwić wyświetlanie obiektów niestandardowych:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- W sekcji Build kliknij opcję Develop.
- Kliknij Visualforce Pages.
- Na liście stron kliknij New.
- Dodaj etykietę (Label) i nazwę (Name) dla swojej strony Visualforce.
- Nadaj stronie etykietę (Label) oraz nazwę (Name).
- Zaznacz pole Available for Salesforce mobile apps and Lightning Pages.
- Skopiuj i wklej poniższy kod, zastępując wstawianą nazwę interfejsu API nazwą obiektu API.
- Kliknij Zapisz.
<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>
Znajdź nazwę interfejsu Salesforce Object API
Każdy obiekt w Salesforce ma swoją nazwę API. Jeśli pracujesz z obiektami niestandardowymi, możesz znaleźć nazwę API, wykonując poniższe instrukcje.
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- W sekcji Build w lewej kolumnie, kliknij Create.
- Kliknij Objects w opcjach listy rozwijanej.
- Kliknij nazwę obiektu.
- Po kliknięciu etykiety obiektu zobaczysz jego nazwę API.
Tworzenie szablonów rekordów obiektów
Dropbox for Salesforce może zbudować dla Ciebie strukturę folderów za pomocą „folderów szablonowych”. Te foldery łączą Twoje rekordy Salesforce z folderami na Twoim koncie Dropbox.
Foldery utworzone przez Dropbox for Salesforce domyślnie będą puste. Jeśli zechcesz, aby zawierały własną strukturę podfolderów, możesz użyć funkcji folderów szablonowych.
- Zaloguj się w witrynie Salesforce.
- Sprawdź, który adres e-mail jest połączony z Dropbox for Salesforce.
- Kliknij kartę Dropbox Options na swoim koncie Salesforce, gdzie możesz zobaczyć adres e-mail
- W witrynie dropbox.com otwórz folder Salesforce Documents.
- Kliknij nazwę folderu obiektu, na którym chcesz pracować.
- Utwórz nowy folder i nazwij go „szablon”.
- Utwórz własną strukturę, dodając pliki i foldery do folderu szablon.
- W Salesforce, kliknij kartę Dropbox Options (Opcje Dropbox).
- Przewiń w dół do Standard Object Settings i kliknij Edit.
- Zaznacz pole Enable Templates obok obiektu, na którym chcesz pracować.
- Kliknij Zapisz.
Uwagi :
- Foldery szablonowe nie zmieniają się wstecz. Każda struktura folderu stworzona przez Ciebie przed nowym szablonem struktury folderu pozostanie nienaruszona.
- Aby uruchomić generowanie szablonu w rekordzie, dodaj jakiś plik do folderu Dropbox tego rekordu w folderze Salesforce Documents w swoim Dropbox.
- Foldery szablonów działają tylko w przypadku obiektów znajdujących się w publicznym folderze „Salesforce Documents”. Obecnie nie są kompatybilne z obiektami w folderze „Private Salesforce Documents”.
- Foldery szablonów nie działają w przypadku obiektów niestandardowych ani obiektów z konwencją nazewnictwa.
Śledź nazwy rekordów Salesforce
Domyślnie, zmiana nazwy rekordu Salesforce nie zmieni nazwy folderu w Dropbox. Możesz jednak włączyć automatyczną zmianę nazwy, co gwarantuje, że zmiana nazwy folderu w Dropbox for Salesforce spowoduje również zmianę nazwy folderu w Dropbox.
- Zaloguj się w witrynie Salesforce.
- Kliknij kartę Dropbox Options.
- Przewiń w dół do Standard Object Settings i kliknij Edit.
- Kliknij Follow Salesforce Record Names obok obiektów, dla których chcesz włączyć automatyczną zmianę nazwy.
- Kliknij Zapisz.
Uwagi :
- Jeśli jesteś w folderze udostępnionym z włączoną automatyczną zmianą nazwy, Dropbox for Salesforce zaktualizuje nazwy rekordów dla każdego w tym folderze.
- W przypadku obiektów standardowych można domyślnie skonfigurować automatyczną zmianę nazwy. W przypadku obiektów niestandardowych musisz skonfigurować wyzwalacz dla tego obiektu niestandardowego, jak pokazano w sekcji Use custom objects (Użyj obiektów niestandardowych) powyżej.
Modyfikacja ustawień udostępniania
Administratorzy Salesforce mogą skonfigurować Dropbox for Salesforce, aby działał zgodnie z ich istniejącym modelem bezpieczeństwa Salesforce. Domyślnie Dropbox for Salesforce jest zgodny z modelem bezpieczeństwa Salesforce.
Jeśli chcesz zmienić ustawienia udostępniania integracji, postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Kliknij kartę Dropbox Options.
- Przewiń w dół do Standard Object Settings i kliknij Edit.
- Zaznacz pole wyboru Follow Salesforce Sharing obok obiektów, które chcesz podłączyć.
- Kliknij Zapisz.
Uwagi :
- Jeśli masz włączoną opcję Follow Salesforce Sharing (Postępuj zgodnie z udostępnianiem w Salesforce) dla obiektów z domyślnym ustawieniem prywatnego udostępniania w całej organizacji, po dodaniu plików/folderów do nowych rekordów zostanie utworzony folder Private Salesforce Documents. Ten folder zostanie dodany tylko do konta Dropbox właściciela rekordu.
- Nowe ustawienia zabezpieczeń nie działają wstecz, tak więc foldery utworzone przed wprowadzeniem zmian ustawień zabezpieczeń nie będą stosować się do nowych ustawień bezpieczeństwa.
- Ustawienia udostępniania Salesforce można znaleźć tutaj: Setup > Security > Sharing Settings.
- Folder „Salesforce Documents” trzeba będzie udostępnić wszystkim użytkownikom Dropbox for Salesforce w zespole.
- Tylko użytkownicy Salesforce, którzy mają dostęp do prywatnego obiektu Salesforce, zobaczą zawartość Dropbox poprzez integrację z Dropbox for Salesforce.
Ograniczanie dostępu tylko do swojego zespołu
Administratorzy Salesforce mogą zarządzać sposobem, w jaki użytkownik Salesforce łączy Dropbox z Salesforce.
- Zaloguj się w witrynie Salesforce.
- Kliknij kartę Dropbox Options.
- Przewiń w dół do sekcji Dropbox Business i kliknij Restrict login to Business accounts.
- Kliknij Edit (Edytuj).
- W sekcji Dropbox Business Access zaznacz opcję Team Members Only.
- Kliknij Zapisz.
Przyznawanie dostępu użytkownikom Salesforce
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Setup.
- W sekcji Administration kliknij Users.
- Kliknij Profiles.
- Kliknij nazwę profilu, który chcesz edytować.
- Przewiń w dół do sekcji Enabled Visualforce Page Access i kliknij Edit.
- Wybierz wszystkie strony, które zaczynają się od „Dropbox_for_SF”.
- Kliknij strzałkę Add.
- Kliknij Zapisz.
- Na stronie profilu, na którym pracujesz, przejedź w dół do sekcji Enabled Apex Class Access i kliknij Edit.
- Wybierz wszystkie klasy, które zaczynają się od Dropbox_for_SF.
- Kliknij strzałkę Add.
- Kliknij Zapisz.
Jeśli nie korzystasz z usługi Salesforce Lightning, postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- Przejdź do sekcji Administer i kliknij Manage Users.
- Kliknij Profiles.
- Kliknij nazwę profilu, który chcesz edytować.
- Przewiń w dół do sekcji Enabled Visualforce Page Access i kliknij Edit.
- Wybierz wszystkie strony, które zaczynają się od „Dropbox_for_SF”.
- Kliknij strzałkę Add.
- Kliknij Zapisz.
- Na stronie profilu, na którym pracujesz, przejedź w dół do sekcji Enabled Apex Class Access i kliknij Edit.
- Wybierz wszystkie klasy, które zaczynają się od wbdbox.
- Kliknij strzałkę Add.
- Kliknij Zapisz.
Tworzenie własnych struktur nazw folderów
Dropbox for Salesforce może utworzyć strukturę folderów, która odzwierciedla konfigurację Salesforce w Dropbox. Administratorzy mogą jednak zmienić strukturę domyślną lub konwencję nazewnictwa utworzonych folderów według metody object-by-object.
Standardowe nazewnictwo dla obiektów „Contact” to Imię, Nazwisko. Możesz jednak zmienić to na Nazwisko, Imię. Jeśli wprowadzisz tę zmianę, ustawienia nazewnictwa będą zgodne z preferencjami nazewnictwa podczas tworzenia.
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Setup.
- W sekcji Platform Tools kliknij Objects and Fields.
- Kliknij Object Manager.
- Wybierz obiekt, który chcesz edytować.
- Kliknij Fields & Relationships.
- Kliknij New.
- W polu Data Type wybierz Formula.
- Kliknij Dalej.
- Wpisz „Custom Dropbox Path” w polu Field Label.
- Wpisz „Custom Dropbox Path” w polu Field Name.
- Wybierz Text obok Formula Return Type i kliknij Next.
- Wprowadź formułę (na przykład: „Contact/” & LastName & „, " & FirstName”) i kliknij Next.
- Zaznacz pole Visible obok profili, którym chcesz przyznać dostęp do edycji.
- Kliknij Dalej.
- Kliknij Zapisz.
Jeśli nie korzystasz z usługi Salesforce Lightning, postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- W sekcji Build w lewej kolumnie, kliknij Customize.
- Wybierz Contacts.
- Kliknij Fields.
- Przejdź w dół do listy Contact Custom Fields & Relationships i kliknij New.
- W polu Data Type wybierz Formula.
- Kliknij Dalej.
- Wpisz „Custom Dropbox Path” w polu Field Label.
- Wpisz „Custom Dropbox Path” w polu Field Name.
- Wybierz Text obok Formula Return Type i kliknij Next.
- Wprowadź swoją składnię w postaci formuły i kiknij Next (Dalej).
- Zaznacz pole Visible obok profili, którym chcesz przyznać dostęp do edycji.
- Kliknij Dalej.
- Kliknij Zapisz.
Uwagi :
- Obiekty z niestandardową konwencją nazewnictwa będą miały swoje foldery rekordów bezpośrednio w folderze Salesforce Documents. Jeśli chcesz, aby foldery z rekordami pojawiały się w folderze obiektów (np. kontakty), tak jak bez niestandardowego nazewnictwa, musisz to określić w dodanej formule. Na przykład „Contact/” & LastName & ”, „ & FirstName”.
- Zmiany nie działają wstecz — mają zastosowanie tylko do nowo utworzonych folderów.
- Możesz użyć tego procesu do wszystkich obiektów standardowych oraz własnych. Możesz też dodać swoje pola, takie jak: tekst, liczby lub daty.
Dodaj Dropbox do Publisher Layouts
Możesz udostępnić interfejs Dropbox w aplikacji Chatter. Aby to zrobić, po prostu dodaj Dropbox jako Quick Action w opcji Global Publisher.
- Zaloguj się w witrynie Salesforce.
- Otwórz ikonę koła zębatego i kliknij Setup.
- W sekcji Platform Tools kliknij User Interface.
- Kliknij opcję Global Actions.
- Kliknij opcję Publisher Layouts.
- Wybierz obiekt, który chcesz edytować.
- Kliknij Fields & Relationships.
- W kolumnie Action (Działanie) kliknij Edit (Edytuj) obok wpisu Global Layout (Layout globalny).
- Przeciągnij i upuść Dropbox z sekcji Quick Actions do sekcji Global Publisher.
Jeśli nie korzystasz z usługi Salesforce Lightning, postępuj zgodnie z poniższymi instrukcjami:
- Zaloguj się w witrynie Salesforce.
- Kliknij Setup (Konfiguracja).
- Kliknij Utwórz.
- Kliknij opcję Global Actions.
- Kliknij opcję Publisher Layouts.
- W kolumnie Action (Działanie) kliknij Edit (Edytuj) obok wpisu Global Layout (Layout globalny).
- Przeciągnij i upuść Dropbox z sekcji Quick Actions do sekcji Global Publisher.