Als u wilt communiceren met gegevens in Salesforce® als onderdeel van een keten, voegt u een stap toe met een opdracht voor een Salesforce-verbinding. Bijvoorbeeld:
- Gegevens laden, extraheren en verwijderen via SOQL en bulkbewerkingen
- Salesforce-objecten maken en beheren
- Records bijwerken en aanmaken
Om deze opdrachten in te schakelen, maakt een IT-beheerder eerst een Salesforce-connector. De connector werkt met alle versies van Salesforce Sales Cloud - Salesforce Essentials®, Lightning® Professional, Lightning Enterprise en Lightning Unlimited - via de REST API.
Bulk verwijderen
Als u een grote hoeveelheid records wilt verwijderen op basis van een CSV-bestand (comma-separated values), gebruikt u de opdracht Bulk verwijderen .
Opmerking: Als het verwijderen van een record mislukt, retourneert de opdracht een CSV met de rijnummers van de mislukte records, samen met de reden voor het mislukken. U kunt vertakkingen gebruiken om acties uit te voeren wanneer de opdracht mislukt, of de mislukkingen naar Google® Drive laden voor latere analyse.
Eigenschappen
| Eigendom |
Detail |
| Concurrency-modus |
Selecteer of u records tegelijkertijd of na elkaar wilt verwerken.
- Om records tegelijkertijd te verwerken, selecteert u Parallel.
- Om records opeenvolgend te verwerken, selecteert u Serieel.
Opmerking: Voor een zeer grote taak selecteert u Serial (Serieel), omdat het volume van databaseverbindingen ertoe kan leiden dat de taak in Parallelmodus mislukt. Seriële modus kan echter resulteren in veel langere procestijden. |
| SObjectnaam |
Voer het type SObject in waarop de bewerking moet worden uitgevoerd. |
| Invoerbestand |
Voer het bestand in dat de te verwijderen records bevat. |
| Bestandsformaat |
Selecteer of Invoerbestand CSV, JSON of XML is. |
| Partijgrootte |
Voer het aantal records in dat per batch moet worden verwerkt. Wij raden u aan de standaardinstelling te laten staan. |
| Wachten op voltooiing |
Schakel dit selectievakje in om Salesforce te controleren en pas naar de volgende opdracht te gaan als alle records zijn verwerkt. Als u de opdracht wilt activeren en onmiddellijk naar de volgende stap wilt gaan, verwijdert u het vinkje uit dit vakje. |
Uitgangen
| Uitgang |
Type uitvoer |
| Foutenlogboek bulk verwijderen |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Inzetstuk in bulk
Om een grote hoeveelheid records in te voegen op basis van een CSV-bestand, gebruikt u de opdracht Bulk insert .
Opmerking: Als het invoegen van een record mislukt, retourneert de opdracht een CSV met de rijnummers van de mislukte records, samen met de reden voor het mislukken. U kunt vertakkingen gebruiken om acties uit te voeren wanneer de opdracht mislukt, of de mislukkingen naar Google® Drive laden voor latere analyse.
Eigenschappen
| Eigendom |
Detail |
| Concurrency-modus |
Selecteer of u records tegelijkertijd of na elkaar wilt verwerken.
- Om records tegelijkertijd te verwerken, selecteert u Parallel.
- Om records opeenvolgend te verwerken, selecteert u Serieel.
Opmerking: Voor een zeer grote taak selecteert u Serial (Serieel), omdat het volume van databaseverbindingen ertoe kan leiden dat de taak in Parallelmodus mislukt. Seriële modus kan echter resulteren in veel langere procestijden. |
| SObjectnaam |
Voer het type SObject in waarop de bewerking moet worden uitgevoerd. |
| Invoerbestand |
Voer het bestand in dat de records bevat die u wilt invoegen. |
| Bestandsformaat |
Selecteer of Invoerbestand CSV, JSON of XML is. |
| Partijgrootte |
Voer het aantal records in dat per batch moet worden verwerkt. Wij raden u aan de standaardinstelling te laten staan. |
| Wachten op voltooiing |
Schakel dit selectievakje in om Salesforce te controleren en pas naar de volgende opdracht te gaan als alle records zijn verwerkt. Als u de opdracht wilt activeren en onmiddellijk naar de volgende stap wilt gaan, verwijdert u het vinkje uit dit vakje. |
Uitgangen
| Uitgang |
Type uitvoer |
| Bulkinvoegfoutlogboek |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Bulkaanvraag
Om een grote hoeveelheid records op te vragen, gebruikt u een Bulk query opdracht.
Eigenschappen
| Eigendom |
Detail |
| Concurrency-modus |
Selecteer of u records tegelijkertijd of na elkaar wilt verwerken.
- Om records tegelijkertijd te verwerken, selecteert u Parallel.
- Om records opeenvolgend te verwerken, selecteert u Serieel.
Opmerking: Voor een zeer grote taak selecteert u Serial (Serieel), omdat het volume van databaseverbindingen ertoe kan leiden dat de taak in Parallelmodus mislukt. Seriële modus kan echter resulteren in veel langere procestijden. |
| SObjectnaam |
Voer het type SObject in waarop de bewerking moet worden uitgevoerd. |
| SOQL-query |
Voer de uit te voeren SOQL query in. |
Uitgangen
| Uitgang |
Type uitvoer |
| Bulk query resultaten CSV |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Bulk bijwerken
Om een grote hoeveelheid records bij te werken, gebruikt u de opdracht Bulkupdate .
Opmerking: Als een record niet kan worden bijgewerkt, retourneert de opdracht een CSV met de rijnummers van de mislukte records, samen met de reden voor de mislukking. U kunt vertakkingen gebruiken om acties uit te voeren wanneer de opdracht mislukt, of de mislukkingen naar Google® Drive laden voor latere analyse.
Eigenschappen
| Eigendom |
Detail |
| Concurrency-modus |
Selecteer of u records tegelijkertijd of na elkaar wilt verwerken.
- Om records tegelijkertijd te verwerken, selecteert u Parallel.
- Om records opeenvolgend te verwerken, selecteert u Serieel.
Opmerking: Voor een zeer grote taak selecteert u Serieel, omdat het volume van de databaseverbindingen ertoe kan leiden dat de taak in Parallelmodus mislukt. Seriële modus kan echter resulteren in veel langere procestijden. |
| SObjectnaam |
Voer het type SObject in waarop de bewerking moet worden uitgevoerd. |
| Invoerbestand |
Voer het bestand in dat de bij te werken records bevat. |
| Bestandsformaat |
Selecteer of Invoerbestand CSV, JSON of XML is. |
| Partijgrootte |
Voer het aantal records in dat per batch moet worden verwerkt. Wij raden u aan de standaardinstelling te laten staan. |
| Wachten op voltooiing |
Schakel dit selectievakje in om Salesforce te controleren en pas naar de volgende opdracht te gaan als alle records zijn verwerkt. Als u de opdracht wilt activeren en onmiddellijk naar de volgende stap wilt gaan, verwijdert u het vinkje uit dit vakje. |
Uitgangen
| Uitgang |
Type uitvoer |
| Foutenlogboek bulkupdates |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Bulk upsert
Om een upsert uit te voeren (bestaande records bijwerken of nieuwe records maken op basis van een externe ID) op een grote hoeveelheid records, gebruikt u de opdracht Bulk upsert .
Opmerking: Als het upsertten van een record mislukt, retourneert de opdracht een CSV met de rijnummers van de mislukte records, samen met de reden voor het mislukken. U kunt vertakkingen gebruiken om acties uit te voeren wanneer de opdracht mislukt, of de mislukkingen naar Google® Drive laden voor latere analyse.
Eigenschappen
| Eigendom |
Detail |
| Concurrency-modus |
Selecteer of u records tegelijkertijd of na elkaar wilt verwerken.
- Om records tegelijkertijd te verwerken, selecteert u Parallel.
- Om records opeenvolgend te verwerken, selecteert u Serieel.
Opmerking: Voor een zeer grote taak selecteert u Serieel, omdat het volume van de databaseverbindingen ertoe kan leiden dat de taak in Parallelmodus mislukt. Seriële modus kan echter resulteren in veel langere procestijden. |
| SObjectnaam |
Voer het type SObject in waarop de bewerking moet worden uitgevoerd. |
| Invoerbestand |
Voer het bestand in dat de records bevat die u wilt upsertten. |
| Bestandsformaat |
Selecteer of Invoerbestand CSV, JSON of XML is. |
| Partijgrootte |
Voer het aantal records in dat per batch moet worden verwerkt. Wij raden u aan de standaardinstelling te laten staan. |
| Wachten op voltooiing |
Schakel dit selectievakje in om Salesforce te controleren en pas naar de volgende opdracht te gaan als alle records zijn verwerkt. Als u de opdracht wilt activeren en onmiddellijk naar de volgende stap wilt gaan, verwijdert u het vinkje uit dit vakje. |
| Externe ID |
Om te identificeren of een record al bestaat of moet worden aangemaakt, voert u het externe ID-veld in dat vereist is voor het object dat bij de upsert betrokken is. |
Uitgangen
| Uitgang |
Type uitvoer |
| Bulk upsert foutenlogboek |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Record aanmaken
Als u een nieuwe record in Salesforce wilt maken, gebruikt u de opdracht Record maken .
Eigenschappen
| Eigendom |
Detail |
| Naam |
Voer de naam in van het SObject waaronder u het record wilt maken. |
| Velden |
Voer de recordvelden in die u wilt bijwerken, in het formaat FIELD_NAME:VALUE. |
Uitgangen
| Uitgang |
Type uitvoer |
| Nieuw record ID |
String |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Verwijder record
Als u een record in Salesforce wilt verwijderen op basis van zijn ID, gebruikt u een opdracht Record verwijderen .
Eigenschappen
| Eigendom |
Detail |
| id |
Voer de ID van de te verwijderen record in. Als de ID onbekend is, voert u een externe ID in het formaat EXTERNAL_ID_NAME:VALUEin, zoals Name:John. |
| Naam |
Voer de naam in van het SObject waaronder u de record wilt verwijderen. |
Uitgangen
Geen
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Rapport downloaden
Als u een aangepast rapport wilt downloaden als een CSV-bestand (comma-separated values), gebruikt u de opdracht Download rapport .
Eigenschappen
| Eigendom |
Detail |
| Rapport ID |
Voer de ID in van het aangepaste rapport dat u wilt downloaden. |
Uitgangen
| Uitgang |
Type uitvoer |
| Aangepast rapport CSV |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Objectmetagegevens ophalen
Als u de velden en metagegevens van een Salesforce-object wilt ophalen, gebruikt u de opdracht Get object metadata .
Eigenschappen
| Eigendom |
Detail |
| Object |
Voer de naam in van het object waarvoor u metagegevens wilt ophalen. |
Uitgangen
| Uitgang |
Type uitvoer |
| Objectmetagegevens |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Gegevens krijgen
Als u een record uit Salesforce wilt ophalen op basis van zijn ID, gebruikt u een opdracht Get record .
Eigenschappen
| Eigendom |
Detail |
| id |
Voer de ID van de op te halen record in. |
| Naam |
Voer de naam in van het SObject waaronder het record moet worden opgehaald. |
| Velden |
Voer de velden van het rapport in die u wilt opnemen (optioneel). |
Uitgangen
| Uitgang |
Type uitvoer |
| Record JSON ophalen |
JSON |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Lijst aanmeldingen
Als u een lijst met aanmeldingen in de Salesforce-omgeving wilt maken, gebruikt u de opdracht List logins .
Eigenschappen
Geen
Uitgangen
| Uitgang |
Type uitvoer |
| Lijst logins CSV |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Objecten weergeven
Als u een lijst met SObjecten van Salesforce wilt maken, gebruikt u de opdracht List objects .
Eigenschappen
Geen
Uitgangen
| Uitgang |
Type uitvoer |
| Lijst objecten CSV |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Lijst rapporten
Als u een lijst met rapporten van Salesforce wilt maken, gebruikt u de opdracht List reports .
Eigenschappen
Geen
Uitgangen
| Uitgang |
Type uitvoer |
| Lijst rapporten CSV |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
SOQL-query
Om een SOQL query uit te voeren en de resultaten als CSV-bestand te genereren, gebruikt u een SOQL query opdracht.
Opmerking: SOQL syntax lijkt erg op SQL. De opdracht SOQL Query kan grote hoeveelheden gegevens extraheren en gegevenssets van 1 miljoen of meer records tegelijk retourneren. Als de opdracht mislukt omdat de query onjuist is of naar objecten verwijst die niet bestaan, wordt u hiervan op de hoogte gesteld door de uitvoer van de opdracht.
Eigenschappen
| Eigendom |
Detail |
| Query |
Voer de uit te voeren SOQL query in. |
| Opdracht opvragen |
Selecteer of u verwijderde records wilt opnemen.
- Om verwijderde records uit te sluiten, selecteert u Query.
- Om inclusief verwijderde records te gebruiken, selecteert u QueryAll.
|
Uitgangen
| Uitgang |
Type uitvoer |
| SOQL-query-uitvoer |
Bestand |
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
SObject - maken
Als u een nieuw SObject wilt maken in Salesforce, gebruikt u de opdracht SOjbect- create .
Eigenschappen
| Eigendom |
Detail |
| Naam |
Voer de naam van het nieuwe SObject in. Om aan te geven dat dit een aangepast object is, voegt Salesforce automatisch __ctoe. |
| Velden |
Voer de recordvelden in die u wilt maken, in het formaat FIELD_NAME:TYPE, waarbij TYPE overeenkomt met een veldtype van Salesforce. |
Uitgangen
Geen
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
SObject - verwijderen
Als u SObjects wilt verwijderen in Salesforce, gebruikt u een opdracht SObject - verwijder .
Eigenschappen
| Eigendom |
Detail |
| Naam |
Voer de naam in van de SObjects die u wilt maken. |
Uitgangen
Geen
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
Record bijwerken
Als u de veldwaarden van een record in Salesforce wilt bijwerken, gebruikt u een opdracht Record bijwerken .
Eigenschappen
| Eigendom |
Detail |
| id |
Voer de ID van de bij te werken record in. |
| Naam |
Voer de naam in van het SObject waaronder u de record wilt bijwerken. |
| Velden |
Voer de recordvelden in die u wilt bijwerken, in het formaat FIELD_NAME:VALUE. |
Uitgangen
Geen
Afsluitcodes
| Code |
type |
Detail |
| 0 |
Succes |
Succes |
| 1 |
Fout |
Algemeen falen |
<!--## 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**.
-->