Aby wchodzić w interakcje z danymi wewnątrz Salesforce® jako część łańcucha, dodaj krok z poleceniem połączenia Salesforce. Na przykład:
- Ładuj, wyodrębniaj i usuwaj dane za pomocą SOQL i operacji zbiorczych
- Twórz obiekty Salesforce i zarządzaj nimi
- Aktualizuj i twórz rekordy
Aby włączyć te polecenia, administrator IT najpierw tworzy konektor Salesforce. Konektor współpracuje ze wszystkimi wersjami Salesforce Sales Cloud - Salesforce Essentials®, Lightning® Professional, Lightning Enterprise i Lightning Unlimited - za pośrednictwem interfejsu API REST.
Usuwanie zbiorcze
Aby usunąć dużą liczbę rekordów na podstawie pliku CSV (comma-separated values), użyj polecenia Bulk delete .
Uwaga: Jeśli usunięcie rekordu nie powiedzie się, polecenie zwraca plik CSV z listą numerów wierszy rekordów, których usunięcie nie powiodło się, wraz z przyczyną niepowodzenia. Możesz użyć rozgałęzienia, aby wykonać akcje, gdy polecenie się nie powiedzie, lub załadować niepowodzenia na Dysk Google® w celu późniejszej analizy.
Właściwości
| Właściwość |
Szczegóły |
| Tryb współbieżności |
Wybierz, czy rekordy mają być przetwarzane jednocześnie, czy sekwencyjnie.
- Aby przetwarzać rekordy w tym samym czasie, wybierz opcję Równolegle.
- Aby przetwarzać rekordy sekwencyjnie, wybierz Serial.
Uwaga: W przypadku bardzo dużych zadań wybierz opcję Serial, ponieważ ilość połączeń z bazą danych może spowodować niepowodzenie zadania w trybie Parallel. Tryb szeregowy może jednak skutkować znacznie dłuższym czasem trwania procesu. |
| Nazwa obiektu |
Wprowadź typ obiektu SObject, na którym ma zostać wykonana operacja. |
| Plik wejściowy |
Wprowadź plik zawierający rekordy do usunięcia. |
| Format pliku |
Wybierz, czy plik wejściowy to CSV, JSON czy XML. |
| Wielkość partii |
Wprowadź liczbę rekordów do przetworzenia na partię. Zalecamy pozostawienie ustawień domyślnych. |
| Poczekaj na zakończenie |
Aby sondować Salesforce i przechodzić do następnego polecenia dopiero po przetworzeniu wszystkich rekordów, zaznacz to pole. Aby uruchomić polecenie i natychmiast przejść do następnego kroku, odznacz to pole. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Dziennik błędów masowego usuwania |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Wkładka zbiorcza
Aby wstawić dużą liczbę rekordów na podstawie pliku CSV, użyj polecenia Bulk insert .
Uwaga: Jeśli wstawienie rekordu nie powiedzie się, polecenie zwraca plik CSV z listą numerów wierszy nieudanych rekordów wraz z przyczyną niepowodzenia. Możesz użyć rozgałęzienia, aby wykonać akcje, gdy polecenie się nie powiedzie, lub załadować niepowodzenia na Dysk Google® w celu późniejszej analizy.
Właściwości
| Właściwość |
Szczegóły |
| Tryb współbieżności |
Wybierz, czy rekordy mają być przetwarzane jednocześnie, czy sekwencyjnie.
- Aby przetwarzać rekordy w tym samym czasie, wybierz opcję Równolegle.
- Aby przetwarzać rekordy sekwencyjnie, wybierz Serial.
Uwaga: W przypadku bardzo dużych zadań wybierz opcję Serial, ponieważ ilość połączeń z bazą danych może spowodować niepowodzenie zadania w trybie Parallel. Tryb szeregowy może jednak skutkować znacznie dłuższym czasem trwania procesu. |
| Nazwa obiektu |
Wprowadź typ obiektu SObject, na którym ma zostać wykonana operacja. |
| Plik wejściowy |
Wprowadź plik zawierający rekordy do wstawienia. |
| Format pliku |
Wybierz, czy plik wejściowy to CSV, JSON czy XML. |
| Wielkość partii |
Wprowadź liczbę rekordów do przetworzenia na partię. Zalecamy pozostawienie ustawień domyślnych. |
| Poczekaj na zakończenie |
Aby sondować Salesforce i przechodzić do następnego polecenia dopiero po przetworzeniu wszystkich rekordów, zaznacz to pole. Aby uruchomić polecenie i natychmiast przejść do następnego kroku, odznacz to pole. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Dziennik błędów wstawiania zbiorczego |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Zapytanie zbiorcze
Aby wysłać zapytanie do dużej liczby rekordów, użyj polecenia Bulk query .
Właściwości
| Właściwość |
Szczegóły |
| Tryb współbieżności |
Wybierz, czy rekordy mają być przetwarzane jednocześnie, czy sekwencyjnie.
- Aby przetwarzać rekordy w tym samym czasie, wybierz opcję Równolegle.
- Aby przetwarzać rekordy sekwencyjnie, wybierz Serial.
Uwaga: W przypadku bardzo dużych zadań wybierz opcję Serial, ponieważ ilość połączeń z bazą danych może spowodować niepowodzenie zadania w trybie Parallel. Tryb szeregowy może jednak skutkować znacznie dłuższym czasem trwania procesu. |
| Nazwa obiektu |
Wprowadź typ obiektu SObject, na którym ma zostać wykonana operacja. |
| Zapytanie SOQL |
Wprowadź zapytanie SOQL do wykonania. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Zbiorcze wyniki zapytań CSV |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Aktualizacja zbiorcza
Aby zaktualizować dużą liczbę rekordów, użyj polecenia Bulk update .
Uwaga: Jeśli aktualizacja rekordu nie powiedzie się, polecenie zwraca plik CSV z listą numerów wierszy rekordów, których aktualizacja nie powiodła się, wraz z przyczyną niepowodzenia. Możesz użyć rozgałęzienia, aby wykonać akcje, gdy polecenie się nie powiedzie, lub załadować niepowodzenia na Dysk Google® w celu późniejszej analizy.
Właściwości
| Właściwość |
Szczegóły |
| Tryb współbieżności |
Wybierz, czy rekordy mają być przetwarzane jednocześnie, czy sekwencyjnie.
- Aby przetwarzać rekordy w tym samym czasie, wybierz opcję Równolegle.
- Aby przetwarzać rekordy sekwencyjnie, wybierz Serial.
Uwaga: W przypadku bardzo dużych zadań wybierz opcję Serial, ponieważ ilość połączeń z bazą danych może spowodować niepowodzenie zadania w trybie Parallel. Tryb szeregowy może jednak skutkować znacznie dłuższym czasem trwania procesu. |
| Nazwa obiektu |
Wprowadź typ obiektu SObject, na którym ma zostać wykonana operacja. |
| Plik wejściowy |
Wprowadź plik zawierający rekordy do aktualizacji. |
| Format pliku |
Wybierz, czy plik wejściowy to CSV, JSON czy XML. |
| Wielkość partii |
Wprowadź liczbę rekordów do przetworzenia na partię. Zalecamy pozostawienie ustawień domyślnych. |
| Poczekaj na zakończenie |
Aby sondować Salesforce i przechodzić do następnego polecenia dopiero po przetworzeniu wszystkich rekordów, zaznacz to pole. Aby uruchomić polecenie i natychmiast przejść do następnego kroku, odznacz to pole. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Dziennik błędów aktualizacji zbiorczej |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Bulk upsert
Aby wykonać upsert - zaktualizować istniejące rekordy lub utworzyć nowe na podstawie zewnętrznego identyfikatora - na dużej liczbie rekordów, użyj polecenia Bulk upsert .
Uwaga: Jeśli nie uda się wstawić rekordu, polecenie zwraca plik CSV z listą numerów wierszy nieudanych rekordów wraz z przyczyną niepowodzenia. Możesz użyć rozgałęzienia, aby wykonać akcje, gdy polecenie się nie powiedzie, lub załadować niepowodzenia na Dysk Google® w celu późniejszej analizy.
Właściwości
| Właściwość |
Szczegóły |
| Tryb współbieżności |
Wybierz, czy rekordy mają być przetwarzane jednocześnie, czy sekwencyjnie.
- Aby przetwarzać rekordy w tym samym czasie, wybierz opcję Równolegle.
- Aby przetwarzać rekordy sekwencyjnie, wybierz Serial.
Uwaga: W przypadku bardzo dużych zadań wybierz opcję Serial, ponieważ ilość połączeń z bazą danych może spowodować niepowodzenie zadania w trybie Parallel. Tryb szeregowy może jednak skutkować znacznie dłuższym czasem trwania procesu. |
| Nazwa obiektu |
Wprowadź typ obiektu SObject, na którym ma zostać wykonana operacja. |
| Plik wejściowy |
Wprowadź plik zawierający rekordy do wstawienia. |
| Format pliku |
Wybierz, czy plik wejściowy to CSV, JSON czy XML. |
| Wielkość partii |
Wprowadź liczbę rekordów do przetworzenia na partię. Zalecamy pozostawienie ustawień domyślnych. |
| Poczekaj na zakończenie |
Aby sondować Salesforce i przechodzić do następnego polecenia dopiero po przetworzeniu wszystkich rekordów, zaznacz to pole. Aby uruchomić polecenie i natychmiast przejść do następnego kroku, odznacz to pole. |
| Zewnętrzny identyfikator |
Aby zidentyfikować, czy rekord już istnieje, czy musi zostać utworzony, wprowadź zewnętrzne pole ID wymagane dla obiektu zaangażowanego w aktualizację. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Dziennik błędów masowego wstawiania |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Utwórz rekord
Aby utworzyć nowy rekord w Salesforce, użyj polecenia Create record .
Właściwości
| Właściwość |
Szczegóły |
| Nazwa |
Wprowadź nazwę obiektu SObject, w ramach którego ma zostać utworzony rekord. |
| Pola |
Wprowadź pola rekordu do aktualizacji w formacie FIELD_NAME:VALUE. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Nowy identyfikator rekordu |
Ciąg |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Usuń rekord
Aby usunąć rekord w Salesforce na podstawie jego ID, użyj polecenia Usuń rekord .
Właściwości
| Właściwość |
Szczegóły |
| Identyfikator |
Wprowadź identyfikator rekordu do usunięcia. Jeśli identyfikator jest nieznany, wprowadź identyfikator zewnętrzny w formacie EXTERNAL_ID_NAME:VALUE, np. Name:John. |
| Nazwa |
Wprowadź nazwę obiektu SObject, z którego chcesz usunąć rekord. |
Dane wyjściowe
Brak
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Pobierz raport
Aby pobrać raport niestandardowy w postaci pliku CSV (comma-separated values), użyj polecenia Download report .
Właściwości
| Właściwość |
Szczegóły |
| Identyfikator raportu |
Wprowadź identyfikator raportu niestandardowego do pobrania. |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Raport niestandardowy CSV |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Pobierz metadane obiektu
Aby pobrać pola i metadane powiązane z obiektem Salesforce, użyj polecenia Get object metadata .
Właściwości
| Właściwość |
Szczegóły |
| Obiekt |
Wprowadź nazwę obiektu, dla którego mają zostać pobrane metadane. |
Wyjścia
| Dane wyjściowe |
Typ wyjścia |
| Metadane obiektu |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Pobierz rekord
Aby pobrać rekord z Salesforce na podstawie jego ID, użyj polecenia Get record .
Właściwości
| Właściwość |
Szczegóły |
| Identyfikator |
Wprowadź identyfikator rekordu do pobrania. |
| Nazwa |
Wprowadź nazwę obiektu SObject, pod którą ma zostać pobrany rekord. |
| Pola |
Wprowadź pola raportu do uwzględnienia (opcjonalnie). |
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Pobierz rekord JSON |
JSON |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Lista loginów
Aby wyświetlić listę loginów w środowisku Salesforce, użyj polecenia List logins .
Właściwości
Brak
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Lista loginów CSV |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Lista obiektów
Aby wyświetlić listę obiektów z Salesforce, użyj polecenia List objects .
Właściwości
Brak
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Lista obiektów CSV |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Lista raportów
Aby wyświetlić listę raportów z Salesforce, użyj polecenia List reports .
Właściwości
Brak
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Lista raportów CSV |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Zapytanie SOQL
Aby wykonać zapytanie SOQL i wygenerować jego wyniki jako plik CSV, użyj polecenia SOQL query .
Uwaga: Składnia SOQL jest bardzo podobna do SQL. Polecenie SOQL Query może wyodrębniać duże ilości danych i zwracać zestawy danych zawierające 1 milion lub więcej rekordów jednocześnie. Jeśli polecenie nie powiedzie się, ponieważ zapytanie jest nieprawidłowe lub odwołuje się do obiektów, które nie istnieją, dane wyjściowe polecenia powiadomią Cię o tym.
Właściwości
| Właściwość |
Szczegóły |
| Zapytanie |
Wprowadź zapytanie SOQL do wykonania. |
| Polecenie zapytania |
Wybierz, czy mają być uwzględniane usunięte rekordy.
- Aby wykluczyć usunięte rekordy, wybierz Zapytanie.
- Aby zawierał usunięte rekordy , wybierz QueryAll.
|
Dane wyjściowe
| Dane wyjściowe |
Typ wyjścia |
| Dane wyjściowe zapytania SOQL |
Plik |
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
SObject - utwórz
Aby utworzyć nowy obiekt SObject w Salesforce, użyj polecenia SOjbect- create .
Właściwości
| Właściwość |
Szczegóły |
| Nazwa |
Wprowadź nazwę nowego obiektu SObject. Aby oznaczyć, że jest to obiekt niestandardowy, Salesforce automatycznie dołącza __c. |
| Pola |
Wprowadź pola rekordów do utworzenia w formacie FIELD_NAME:TYPE, gdzie TYPE odpowiada typowi pola Salesforce. |
Dane wyjściowe
Brak
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
SObject - usuń
Aby usunąć SObjects w Salesforce, użyj polecenia SObject - delete .
Właściwości
| Właściwość |
Szczegóły |
| Nazwa |
Wprowadź nazwę obiektu SObjects do utworzenia. |
Dane wyjściowe
Brak
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
Zaktualizuj rekord
Aby zaktualizować wartości pól rekordu w Salesforce, użyj polecenia Update record .
Właściwości
| Właściwość |
Szczegóły |
| Identyfikator |
Wprowadź identyfikator rekordu do aktualizacji. |
| Nazwa |
Wprowadź nazwę obiektu SObject, pod którą ma zostać zaktualizowany rekord. |
| Pola |
Wprowadź pola rekordu do aktualizacji w formacie FIELD_NAME:VALUE. |
Dane wyjściowe
Brak
Kody wyjścia
| Kod |
Typ |
Szczegóły |
| 0 |
Powodzenie |
Powodzenie |
| 1 |
Błąd |
Ogólna awaria |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->