Salesforce-integraation asennus- ja käyttöohje

Transkriptio

1 Salesforce-integraation asennus- ja käyttöohje

2 Sisällysluettelo eri-integraation edellyttämät objektimuutokset... 3 Jakelulista-objektin muutokset... 3 Jakelulista-objekti / Näytä erissa -valinnan määritys... 3 Yhteystieto-Jakelulista -suhdeobjektin muutokset... 4 Yhteystieto-Jakelulista -suhdeobjekti/ Lisäkenttien määritys eri - Salesforce -integraation määritys Salesforcessa... 6 Yhdistetyn sovelluksen luominen eri - Salesforce -integraation määritys erissa... 7 Mistä löydät erissa tarvittavat Salesforce -integraatioasetukset... 7 Salesforce -moduulin toiminnot erissa... 8 Salesforce-jakelulistat näkymä... 8 Salesforce-rajapinnan kirjautuminen ei toimi... 8 Uuden Salesforce-jakelulistan päivitys eriin... 8 Uuden Salesforce-jakelulistan jäsenien päivitys... 8 Postituskieltojen hallinta... 9 Postituskieltojen siirtyminen erista Salesforceen... 9 Kiellon tehneen jäsenen poistuminen jakelulistalta erissa... 9 Postituskiellot ovat virastokohtaisia... 9 Uutiskirjeen lähetys Salesforce-jakelulistaan Postituskieltojen näkyminen Salesforcessa... 11

3 eri-integraation edellyttämät objektimuutokset Salesforce -ympäristöön tarvitaan eri-integraatiota varten muutamia lisäkenttiä Jakelulista- sekä Yhteystieto-Jakelulista-suhde -objekteihin. Jakelulista-objektin muutokset Jakelulista -objektiin lisätään Näytä erissa -valinta, jolla määritetään mitkä jakelulista näkyvät ja ovat synkronoitavissa eriin. Jakelulista-objekti / Näytä erissa -valinnan määritys Alla kuvakaappaus, jossa näkyy Näytä erissa -valinnan asetukset.

4 Yhteystieto-Jakelulista -suhdeobjektin muutokset Yhteystieto-Jakelulista-suhdeobjektiin lisätään virastokohtaiset Postituskielto -valinnat sekä Postituskielto asetettu -tekstikenttä. Alla luettelo kaikista Yhteystieto-Jakelulista-suhdeobjektiin lisättävistä kentistä ja niiden nimeäminen.

5 Yhteystieto-Jakelulista -suhdeobjekti / Lisäkenttien määritys Alla kuvakaappaus, jossa näkyy Postituskielto sekä Postituskielto asetettu -kentän asetukset STM:n osalta. Kaikki muut virastot luodaan vastaavalla tavalla, mutta kentän nimessä pitää olla formaatti unsub_### sekä unsub_info_###, jossa ### korvataan ko. viraston nimellä pienellä kirjoitettuna.

6 eri - Salesforce -integraation määritys Salesforcessa Salesforce -ympäristöön täytyy määrittää uusi Yhdistetty sovellus, jossa aktivoidaan OAuth-asetukset käyttöön sekä määritetään rajapinnan OAuth-näkyvyysalueet. Yhdistetyn sovelluksen luominen Uusi Yhdistetty sovellus luodaan seuraavasti: 1. Napsauta selainnäkymän yläosasta oikealta kohtaa Määritykset. 2. Napsauta vasemmalla näkyvästä valikosta kohtaa Laadi >> Luo >> Sovellukset. 3. Napsauta Yhdistetyt sovellukset -listan yllä olevaa [ Uusi ] -painiketta, jolloin näyttöön avautuu määrityslomake. 4. Lomakkeella on paljon erilaisia kenttiä ja asetuksia, mutta eri -sovelluksen määrityksessä tarvitaan vain seuraavat asetukset: 5. Aseta lomakkeelle em. mallin mukaiset asetukset ja napsauta [ Tallenna ] -painiketta, jolloin Yhdistetty sovellus ( eri) tallennetaan.

7 eri - Salesforce -integraation määritys erissa Kun Salesforce -ympäristöön on määritetty uusi Yhdistetty sovellus ( eri), voidaan sovelluksen asetuksista nähdä erissa Salesforce-integraatioasetuksiin tarvittavat tiedot. Mistä löydät erissa tarvittavat Salesforce -integraatioasetukset Kun uusi Yhdistetty sovellus ( eri) on luotu, näkyy se Yhdistetyt sovellukset -listassa. Napsauttamalla listassa Yhdistetyn sovelluksen nimi ( eri) -linkkiä, näyttöön avautuu näkymä, josta saadaan Kuluttaja-avain (Client ID) ja kuluttajasalaisuus (Client Secret) -arvot. Näiden arvojen lisäksi eriin tarvitaan rajapintaa käyttävän lisenssin käyttäjätunnus (Username) sekä salasana (Password), jossa salasanan perään tulee erissa asettaa Client Secret -arvo. erissa käyttäjä ei pääse itse päivittämään näitä asetuksia vaan ne tehdään ja testataan aina erin asiakaspalvelun kautta.

8 Salesforce -moduulin toiminnot erissa Salesforce-jakelulistat näkymä Jos eri-käyttäjän tiliin on määritetty Salesforce-integraatio, näkyy palvelun päävalikon Asiakashallintaosassa Salesforce -toiminto, jota napsauttamalla näyttöön avautuu Salesforce-jakelulistat luettelo. Luettelossa näkyvät kaikki ne Jakelulistat, joihin on Salesforcessa asetettu Näytä erissa -valinta. Salesforce-rajapinnan kirjautuminen ei toimi Mikäli Salesforce -toiminto ei avaa Salesforce-jakelulistat luetteloa vaan sen sijaan ohjaa käyttäjän palvelun etusivu-näkymään, niin tällöin Salesforce -rajapinnan kirjautumisessa on tapahtunut virhe. Tällöin myös selaimen osoiterivillä näkyy SF_LOGIN_FAILED -virheilmoitus. Jos tällainen virhe tulee, kokeile uudestaan napsauttaa Salesforce toimintoa. Jos virhe toistuu, ota yhteyttä eri-palvelun asiakaspalveluun tai puhelin Uuden Salesforce-jakelulistan päivitys eriin Salesforce-jakelulistat luettelon oikeassa yläreunassa on Hae jakelulistat -toimintolinkki. Napsauttamalla linkkiä palvelu hakee eriin kaikki Salesforceen luodut uudet jakelulistat, joihin on Salesforcessa asetettu Näytä erissa -valinta. Uuden Salesforce-jakelulistan jäsenien päivitys Salesforce-jakelulistat luettelossa näkyy rivikohtaisesti Päivitä jakelulista -toimintolinkki. Napsauttamalla linkkiä palvelu hakee eriin kaikki ko. jakelulistaan liitetyt jäsenet, joilla ei ole Salesforcessa jakelulistakohtaista postituskieltoa asetettuna. Päivityksen yhteydessä erissa jakelulistasta poistetaan kaikki ne asiakasliitokset, joita ei enää esiinny Salesforcessa tulevassa tiedossa. Eli jos jokin yhteyshenkilö poistetaan Salesforcessa jakelulistalta tai hänelle asetetaan postituskielto, niin tällöin hän poistuu myös erissa vastaavalta jakelulistalta.

9 Postituskieltojen hallinta eri-palvelu käsittelee Salesforce-jakelulistaan tehdyn lähetyksen postituskiellot jakelulistakohtaisesti. Jos vastaanottaja napsauttaa viestissä Peruuta uutiskirje -linkkiä, tallennetaan kielto siihen jakelulistaan, johon ko. lähetys on tehty. Postituskieltojen siirtyminen erista Salesforceen Postituskiellot siirretään eri Salesforceen aina, kun käyttäjä napsauttaa erissa Salesforce - toimintoa. Tällöin eri tunnistaa kaikki sellaiset kiellot, joita ei ole vielä siirretty ja siirtää nämä Salesforcen Bulk API -rajapinnan kautta Salesforceen. Vaikka kieltojen siirto Salesforceen tapahtuu viivästetysti, ei tästä ole haittaa, koska eri ei salli lähettää viestejä sellaisille jakelulistan jäsenille, joilla on kielto päällä. Kiellon tehneen jäsenen poistuminen jakelulistalta erissa Kun kielto on siirretty Salesforceen, kieltänyt jakelulistan jäsen ei enää ole mukana Salesforcesta eriin siirrettävässä kohderyhmässä. Tällöin jäsen poistetaan myös erissa ko. jakelulistalta. Vastaavasti, jos CRM-käyttäjä poistaa Salesforcessa jokin jäsenen jakelulistalta, niin seuraavalla kerralla, kun tämän jakelulistan jäsenet päivitetään eriin, poistuu ko. jäsen myös erissa tältä jakelulistalta. Postituskiellot ovat virastokohtaisia Postituskiellot hallitaan Salesfrocessa virastokohtaisesti eli STM:n lähetyksessä kiellon tehnyt jäsen kieltää ainoastaan STM:n postitukset, jolloin kielto ei vaikuta muiden virastojen postituksiin.

10 Uutiskirjeen lähetys Salesforce-jakelulistaan erissa uutiskirjeen lähetys Salesforce-jakelulistaan tapahtuu aivan vastaavasti kuin mihin tahansa muuhun kohderyhmään. Ainoana erona on se, että Salesforce-jakelulistaan tehtävässä lähetyksessä kohderyhmiä ei voida yhdistää eli vastaanottajajoukko muodostuu vain ko. jakelulistan jäsenistä. Alla kuvakaappaus erin vastaanottajien valintanäkymästä.

11 Postituskieltojen näkyminen Salesforcessa Salesforcessa postituskiellot näkyvät jäsen- ja virastokohtaisesti Yhteystieto-Jakelulista-suhde -näkymässä. Kiellot saadaan näkymään myös suoraan Jakelulista-näkymän Jakelulistalle kuuluvat yhteystiedot -listassa, mutta tämä edellyttää listanäkymään lisätään nämä sarakkeet Muokkaa asettelua -toiminnolla.