Propojení aplikace FileMaker se Salesforce

6. vlastní skriptování pro specializované integrace

V některých případech může mít smysl vyvinout vlastní skriptovací řešení v aplikaci FileMaker pro splnění konkrétních požadavků na integraci se Salesforce. Vlastní skriptování umožňuje vytvářet přizpůsobené pracovní postupy a funkce, které jsou přesně přizpůsobeny potřebám společnosti.

Příklad aplikace pro vlastní skriptování

• Řízení vedeníSpolečnost může vytvořit vlastní skript, který automaticky přenese nové potenciální zákazníky z aplikace FileMaker do Salesforce, přičemž zohlední určitá pravidla a podmínky, například stav potenciálního zákazníka nebo prodejní území.

Výhody integrace FileMakeru/gFM Business a Salesforce

• Konzistence datIntegrace znamená, že údaje o zákaznících, objednávkách a prodejních příležitostech zůstávají mezi systémy synchronizovány, což zaručuje centrální a aktuální databázi.
• AutomatizaceOpakující se úkoly, jako je přenos potenciálních zákazníků nebo informací o zákaznících, lze automatizovat, čímž se zkrátí časová náročnost a minimalizují chyby.
• FlexibilitaPomocí rozhraní API, middlewaru nebo ODBC můžete integraci flexibilně navrhnout a přizpůsobit ji konkrétním požadavkům vaší společnosti.
• Přístup k datům v reálném časePomocí metod, jako je připojení ODBC nebo využití rozhraní REST API, mohou společnosti přistupovat k datům v reálném čase a přijímat tak lepší rozhodnutí na základě aktuálních informací.

Ukázkový skript FileMakeru pro rozhraní Salesforce REST API

Níže je uveden příklad skriptu aplikace FileMaker, který se připojí k rozhraní API REST služby Salesforce a odešle požadavek. Tento příklad ukazuje, jak se můžete ověřit a poté načíst nebo odeslat záznamy ze Salesforce.

Předpoklady:

• Adresa URL rozhraní REST API služby SalesforceAdresa URL, kterou používáte k přístupu do služby Salesforce.
• ID a tajemství klienta Salesforce: Obdržíte ji po registraci své aplikace v Salesforce.
• Token OAuth2OAuth2 se používá k ověřování, aby byl zajištěn bezpečný přístup k Salesforce.

Příklad skriptu pro připojení aplikace FileMaker k Salesforce:

1. ověřování a načítání tokenů

K vytvoření připojení potřebujete přístupový token, který obdržíte od Salesforce prostřednictvím požadavku OAuth2.

# Nastavení proměnných pro ověřování Salesforce
Nastavit proměnnou [ $client_id ; Hodnota: "Your_Client_ID" ]
Nastavit proměnnou [ $client_secret ; Hodnota: "Your_Client_Secret" ]
Nastavit proměnnou [ $username ; Hodnota: "Your_Salesforce_username" ]
Nastavit proměnnou [ $password ; Hodnota: "Your_Salesforce_Password" & "Your_Security_Token" ] # Heslo + bezpečnostní token dohromady
Nastavit proměnnou [ $auth_url ; Hodnota: "https://login.salesforce.com/services/oauth2/token" ]

# Vytvoření možností cURL pro požadavek na ověření
Nastavení proměnné [ $postData ; Hodnota:
"grant_type=password&client_id=" & $client_id &
"&client_secret=" & $client_secret &
"&username=" & $username &
"&password=" & $password ]

# Odeslání požadavku na ověření do služby Salesforce
Vložit z adresy URL [ Výběr ; Dialog: $auth_response ; $auth_url ; cURL options: "--request POST --data " & $postData ]

Výpis přístupového tokenu #
Nastavení proměnné [ $access_token ; Hodnota: JSONGetElement ( $auth_response ; "access_token" ) ]
Nastavení proměnné [ $instance_url ; Hodnota: JSONGetElement ( $auth_response ; "instance_url" ) ]
Jakmile obdržíte přístupový token, můžete jej použít k přístupu k rozhraní Salesforce API.

2. načtení dat ze Salesforce
V tomto příkladu načteme seznam účtů (zákazníků) ze Salesforce.

# Nastavení adresy URL pro požadavek API
Nastavit proměnnou [ $api_url ; Hodnota: $instance_url & "/services/data/v50.0/sobjects/Account" ]

# Nastavení možností cURL pomocí přístupového tokenu
Nastavení proměnné [ $cURL_options ; Hodnota:
"--header \"Authorisation: Bearer " & $access_token & "\"¶" &
"--header \"Content-Type: application/json\"¶" &
"--header \"Accept: application/json\"" ]

# Odeslání požadavku GET do služby Salesforce za účelem načtení údajů o účtu
Vložit z adresy URL [ Výběr ; Dialog: $response ; $api_url ; cURL-Options: $cURL_options ]

# Zobrazení odpovědi API v dialogu (například jako JSON)
Nastavit proměnnou [ $formatted_response ; Hodnota: JSONFormatElements( $response ) ]
Zobrazení vlastního dialogového okna ["API response" ; $formatted_response ]

3. zpracování dat v aplikaci FileMaker

Nyní můžete data dále zpracovat a vložit je do databáze FileMaker.

# Příklad: Výpis názvu prvního účtu z odpovědi JSON
Nastavit proměnnou [ $account_name ; Hodnota: JSONGetElement ( $response ; "records[0].Name" ) ]

# Uložení názvu účtu do pole FileMakeru
Nastavit hodnotu pole [ Customers::Name ; $account_name ]

Vysvětlení scénáře

• OvěřováníOdesláním požadavku OAuth2 do Salesforce získáte přístupový token. Tento token se používá ve všech následujících požadavcích na ověření dat Salesforce.
• Vyhledávání datPomocí přístupového tokenu odešlete požadavek GET do služby Salesforce a získáte data účtu. Odpověď je vrácena ve formátu JSON.
• Zpracování datZískaná data jsou uložena v aplikaci FileMaker. V tomto příkladu je první název účtu extrahován a vložen do pole FileMakeru.

Úpravy:

• Koncové bodyKoncové body můžete změnit tak, abyste měli přístup k dalším objektům, jako jsou potenciální zákazníci, příležitosti nebo přizpůsobené objekty.
• Řešení chybJe vhodné přidat chybové dotazy, aby byl zajištěn hladký průběh procesu v případě chybných dotazů.
• Ostatní oblastiV závislosti na vašich požadavcích můžete extrahovat další pole a uložit je v aplikaci FileMaker.