Allmänt
Den här guiden handlar om att definiera modulverktygens parametrar och andra möjliga verktygsspecifika inställningar. För mer information om modulverktygen i allmänhet, se guiden Modulverktyg.
Parametrar
Du kan ställa in parametrar för modulverktyget för att till exempel hämta/komplettera information från källenheten eller fylla i fältet med viss information:
- Formeln för parametrar vid hämtning av information från en annan modul: target field={$source field} (e.g. cf_1103={$cf_1499}).
- Formeln för parametrar vid hämtning av information från samma enhet: målfält=the wanted value/text (e.g. in a picklist: cf_1548=Approved OR in a text field: cf_5823=This is an example).
När man skriver parametrarna är det i vissa fall viktigt att ta hänsyn till den modul som modulverktyget är skapat i. T.ex. om du skapar ett verktyg för kontomodulen, som skapar en ny kontakt för ett konto, görs länken mellan kontot och kontakten med parametern account_id={$ID}. När du skapar ett verktyg för kontaktmodulen, som skapar en ny potential för en kontakt, görs länken till kontaktens konto med account_id={$account_id}.
Det finns exempel på användning av parametrarna nedan. För tydlighetens skull har de alla skrivits för ”Länk till annan modul” modulverktyg, men parametrarna fungerar på samma sätt i alla andra modulverktyg som du kan skriva parametrar för.
Exempel 1: Skapa ett verktyg för kontomodulen som skapar en ny kontakt för kontot (genom att länka kontakten till kontot med en parameter account_id={$ID} , se exempelbild nedan).
Exempel 2: Skapa ett verktyg för kontaktmodulen som skapar en ny potential för kontakten (genom att lägga till en kontorelation och en kontaktrelation till potentialen med parametrar contact_id={$ID}&account_id={$account_id} , se bild nedan).
Dynamiska formler
Dynamiska formler är användbara som parametrar med länk till andra moduler och modulverktyg för att uppdatera entitetsfält.
Här kan du lära dig att använda dynamiska formler: Exempel på dynamiska fältformler
Konvertera ett erbjudande/försäljningsorder till en försäljningsorder/faktura (länk till en annan modul)
Raderna i offerten/försäljningsordern kopieras till försäljningsordern/fakturan med följande parameter:
copy_inventory_rows_from={$ID}
Rader med en viss status kan kopieras till en försäljningsorder/faktura genom att kombinera parametern copy_inventory_rows med en annan parameter, condition_rowstatus. Om du till exempel endast vill inkludera rader vars status har lämnats tom på fakturan använder du följande parameter:
&condition_rowstatus=empty!
Skapa en aktivitet från en annan modul (länk till en annan modul / Skapa händelse eller uppgift)
När du vill koppla t.ex. en kund markerad i utdatamodulen till den skapade aktiviteten måste parametern vara i formen konton[]={$konto_id}. I exemplet nedan skapas en transaktionsaktivitet från modulen Kontakter, till vilken en kund och en kontakt är kopplade.
accounts[]={$account_id}&contacts[]={$ID}
Kopiera en aktivitet (länk till en annan modul)
Om du vill kopiera aktiviteten med modulverktyget så att kund- och kontaktkopplingarna för den ursprungliga aktiviteten också kopieras, krävs följande parametrar:
copy_relation.accounts={$ID}©_relation.contacts={$ID}
NOTERA! Webbläsare känner vanligtvis igen ©-märket som copyrightmärket © och kan ibland ersätta den delen med detta märke. Detta påträffas inte när du skapar ett modulverktyg, men om det någonsin är nödvändigt att ändra och spara modulverktyget igen, se till att detta märke inte har ändrats till ett copyrightmärke. Om detta har hänt kan det korrigeras genom att skriva om ©-avsnittet manuellt.
Kopiera underevenemang när du kopierar massevenemanget (Länk till en annan modul)
När du använder mallen för massevenemang och även vill kopiera massevenemangets underevenemang, använder du följande parametrar:
copy_mass_event_sub_events_from={$ID}
Kopiera enkät när du kopierar massevenemanget (Länk till en annan modul)
När du använder mallen för massevenemang och även vill kopiera massevenemangets enkät, använder du följande parametrar:
survey={$survey}
Kopiera enkät i modulen Enkäter
När du använder modulverktyget för att kopiera en enkät i modulen Enkäter används följande parametrar:
options={$options}
Kopiera en enskild relation från en multi-relation
När det finns ett behov av att kopiera en enskild relation från en multirelation läggs parametrar till i form med <relation_id>.single. Anta t.ex. att det finns ett behov av att skapa en potential från en aktivitet, samtidigt som konto och kontakt överförs från aktiviteten till potentialen. I så fall skrivs parametrarna på följande sätt:
account_id=account.single&contact_id=contacts.single
Parametrar för att skapa entiteteter med
modulverktyg
Det är möjligt att skapa ett modulverktyg för att skapa nya entiteter. Det är dock viktigt att komma ihåg att när verktyget används för att kopiera data från andra entiteter måste parametrarna innehålla prefixet ”rel_”. Så parametrarna kan se ut så här, till exempel:
firstname={$rel_firstname}&lastname={$rel_lastname}&email={$rel_email}
Lägga till relationer till aktiviteter
Ibland finns det ett behov av att skapa olika relationer till enheter som skapats med verktyget för skapande av enheter, t.ex. aktiviteter.
Här finns en parameter som heter related_ids[]
Till exempel:
related_ids[]={$ID}
Detta kan användas för alla relationer. Om du t.ex. vill skapa en aktivitet i arbetsflödet när du sparar ett ärende kan du använda följande parametrar för att lägga till en relation till kund, ärende och kontakt för aktiviteten:
related_ids[]={$ID}&related_ids[]={$rel_accountid}&related_ids[]={$contact_id}
Kopiera projektfaser
Projektet kopieras med hjälp av modulverktyget Länk till annan modul. Om du vill kopiera projektfaserna när du kopierar projektet använder du följande parameter:
project_rows_from={$ID}