Yleistä
Tässä ohjeessa käsitellään moduulityökalujen parametrien määrittämistä sekä muita eri moduulityökalujen vaatimia asetuksia. Moduulityökaluista yleisesti on ohjeessa Moduulityökalut.
Parametrit
Moduulityökaluun voidaan asettaa parametreja, joilla voidaan esimerkiksi tuoda/täydentää tietoa alkuperäiseltä entiteetiltä tai täyttää kenttiä halutuilla tiedoilla.
- Parametrit toimivat toisesta moduulista tietoa tuodessa kaavalla: kenttä, johon tuodaan tietoa={$kenttä, josta tuodaan tietoa} (esim. cf_1103={$cf_1499}). Kaava toimii aina vastaavalla tavalla kenttätyypistä riippumatta.
- Parametrit toimivat saman entiteetin sisällä tietoa täydennettäessä kaavalla: kenttä, johon tietoa halutaan=haluttu arvo/teksti (esim. valintalistassa: cf_1548=Hyväksytty TAI tekstikentässä: cf_5823=Tämä on esimerkkitekstiä).
Parametrien kirjoituksessa tulee tietyissä tapauksissa ottaa huomioon, mihin moduuliin työkalua tehdään. Jos esimerkiksi luodaan Asiakkaat-moduuliin työkalua, jolla luodaan asiakkaalle uusi kontakti, luodaan kontaktin linkitys asiakkaaseen kirjoitusmuodolla account_id={$ID}. Jos taas luodaan esimerkiksi Kontaktit-moduuliin työkalu, jolla luodaan kontaktille uusi potentiaali, luodaan linkitys kontaktin edustamaan asiakkaaseen parametrilla account_id={$account_id}.
Alla on kuvattu esimerkkejä parametrien käytöstä. Selkeyden vuoksi ne on tehty eri moduulien Linkki toiseen moduuliin -moduulityökaluihin, mutta ne toimivat vastaavalla tavalla kaikissa työkaluissa, joihin parametrejä voidaan tehdä.
Lue lisää erikoisparametreista täältä
Esimerkissä 1 tehdään Asiakkaat-moduulille työkalu, jota painamalla luodaan asiakkaalle uusi Kontakti (linkittäen kontakti kyseiseen asiakkaaseen asiakasrelaatiolla parametrilla account_id={$ID} , ks. kuva alla).
Esimerkissä 2 tehdään Kontaktit-moduulille työkalu, jota painamalla luodaan uusi Potentiaali kontaktille (linkittäen potentiaalille kontakti- ja asiakasrelaatiot parametreilla contact_id={$ID}&account_id={$account_id} , ks. kuva alla).
Entiteettien luomisen parametrit
On mahdollista luoda moduulityökalu myös entiteettien luomiseen. Tässä on kuitenkin hyvä ottaa huomioon se, että kun entiteettien luomiseen käytettävällä työkalulla kopioidaan tietoja muista entiteeteistä, täytyy parametreissä käyttää etuliitettä rel_ näiden tietojen kohdalla. Parametrit voisivat siis näyttää esimerkiksi tältä:
firstname={$rel_firstname}&lastname={$rel_lastname}&email={$rel_email}
Entiteetin luomiseen käytettävää työkalua voidaan käyttää kopioimaan lähteenä olevan entiteetin rivitason tiedot. Tämä voidaan tehdä seuraavasti:
copy_inventory_rows
Eli parametrit voisivat näyttää esimerkiksi tältä:
copy_inventory_rows&field=Value
Relaatioiden lisääminen aktiviteettiin
Joskus on tarve luoda erilaisia relaatioita entiteettien luomisen työkalulla tehtyihin entiteetteihin, kuten aktiviteetteihin.
Tässä käytetään parametria nimeltä related_ids[]
Esimerkiksi:
related_ids[]={$ID}
Tätä voidaan käyttää kaikissa relaatioissa. Jos esimerkiksi halutaan tiketin tallennuksen yhteydessä luoda työnkululla aktiviteetti, voidaan aktiviteettiin liittää relaatiolla asiakas, tiketti ja kontakti seuraavasti:
related_ids[]={$ID}&related_ids[]={$rel_accountid}&related_ids[]={$contact_id}
Moduulityökalun mukautettu kuvake
Mihin tahansa moduulityökaluun on mahdollista lisätä mukautettu kuvake. Jos olet kiinnostunut tästä toiminnallisuudesta, ota yhteyttä asiakaspalveluumme aloittaaksesi. Tässä on joitakin esimerkkejä käytettävissä olevista kuvakkeista:
Talo | |
Maapallo | |
Kuulokkeet | |
Ympyröity kysymysmerkki | |
Pilvi |