--- title: "Lomakkeiden integrointi asetukset" slug: "lomakkeiden-integrointi-asetukset-1-1-1" updated: 2025-10-31T08:06:37Z published: 2025-10-31T08:06:37Z canonical: "support.keypro.fi/lomakkeiden-integrointi-asetukset-1-1-1" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://support.keypro.fi/llms.txt > Use this file to discover all available pages before exploring further. # Lomakkeiden integrointi asetukset Lomakkeiden integrointityökalut löytyvät valikosta LOMAKEINTEGRAATIO. ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659220010.png) Lomakeintegraatiotyökalujen avulla järjestelmänvalvoja voi ottaa käyttöönsä lomakevalikon, joka näkyy lomakkeen yläosassa sijaitsevalla työkalurivillä. Tälle valikolle voidaan määrittää ryhmiä ja näille ryhmille puolestaan toimintoja, jotka ovat ulkoisia linkkejä, ja joita hallinnoidaan **Ohjattu lomakevalikko** -toiminnolla. ## Ohjattu lomakevalikko Ennen kuin **Ohjattu lomakevalikko**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1727955158297.png)voidaan määrittää hallintasivustolla, on varmistettava, että halutut kohdelomakkeet on aktivoitu vapaasti määritettävien tietojen listalla. Avaa [Vapaasti määritettävät tiedot](/kb/docs/vapaasti-m%C3%A4%C3%A4ritett%C3%A4v%C3%A4t-tiedot-7-1-1-1-1-1) ja hyväksy **Aktiivinen**-valintaruutu halutun lomakkeen nimen kohdalta. Mikäli kohdetta ei aktivoida, sille ei voida määrittää lomakevalikkoa tai toimintoja. ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1728904782344.png) **Ohjattu lomakevalikko** -toimintoa käytetään hallintasivustolla ryhmien luomiseen sekä toimintojen määrittämiseen näille ryhmille. Tiedot näytetään KeyCom-käyttöliittymässä lomakkeen yläosassa sijaitsevan työkalurivin **Ohjattu lomakevalikko**![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1727955158297.png)-painikkeen alla. Painiketta painamalla voidaan valita ryhmiä, joiden alla on puolestaan toimintoja. Nämä toiminnot ovat aina ulkoisia linkkejä.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1728907055689.png) ### Käyttöönottoprosessi **Ohjattu lomakevalikko** -toiminto löytyy hallintasivustolta kohdasta **LOMAKEINTEGRAATIO**:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659284928.png) 1. Ensimmäisenä on valikkoon on integroitava ryhmä tai ryhmiä. Voit valita jo olemassa olevan ryhmän pudotusvalikosta tai luoda uuden plus![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1728041491978.png)-painikkeesta avautuvalta uudelta sivulta:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659391959.png) 2. Mikäli aloitat uuden ryhmän luomisen, sinun on ensin valittava verkkokohteen lomake, jolle kyseinen ryhmä tulee näkyviin. Vain ne kohdetyypit voidaan valita, jotka aktivoitiin ennen käyttöönottoprosessin aloittamista [Vapaasti määritettävät tiedot](/kb/docs/vapaasti-m%C3%A4%C3%A4ritett%C3%A4v%C3%A4t-tiedot-7-1-1-1-1-1) -sivulta. Ryhmälle tulee määrittää myös vapaavalintainen teksti/nimi, josta se voidaan myöhemmin tunnistaa. Mikäli valitsit pudotusvalikosta olemassa olevan ryhmän, voit siirtyä **vaiheeseen 3**:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659524114.png) 3. Kun olet valinnut ryhmän, **Seuraava**-painike vie sinut osioon, jossa voit valita **T****oimintotyypin** ja antaa sille vapaavalintaisen nimen. Tällä hetkellä valittavissa on ainoastaan toimintotyyppi **Ulkoinen linkki**:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659544004.png) 4. Kirjoita sitten URL-osoite, jonka haluat avata linkistä uuteen välilehteen. URL-osoite tukee sekä Dojo- että Ext-kentän tunnuksia paikanhaltijoina. Paikannimet määritellään sulkeilla, joihin tulee antaa sen lomakekentän tunnus, josta arvo otetaan:![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659572482.png) 5. Lopuksi voit viimeistellä prosessin valitsemalla **Valmis.** Voit valita myös **Valmis** **j****a lisää toinen** tallentaaksesi edistymisesi ja käynnistää toiminnon uudelleen. **Keskeytä** voidaan valita missä tahansa prosessin vaiheessa. Se vie sinut takaisin hallintasivuston pääsivulle. ### Lomakevalikon ryhmien ja toimintojen muokkaaminen Voit myöhemmin muokata ohjatun lomakevalikon toimintoja tekstivakioiden ryhmässä CLIENT_FORM_CONFIG, sekä yksittäisiä ryhmiä tekstivakioiden ryhmässä CLIENT_FORM_GROUP. Lomakevalikon toiminnon nimi näkyy **Tekstiarvo**-kentässä, ryhmän tunnus tallennetaan **Kategoria**-kenttään ja **Valinnaiset tiedot** -kenttään tallennetaan toiminnon suorittamiseen tarvittavat tiedot käyttöliittymässä.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738669956380.png) ### Ryhmän tai toiminnon poistaminen 1. Avaa lista aiemmin määritellyistä ryhmistä tai toiminnoista.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659611427.png) 2. Valitse listasta ne ryhmät/toiminnot, jotka haluat poistaa järjestelmästä.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1738659644288.png) 3. Valitse alasvetovalikosta **Toiminto: Poista valitut "Integrated menu items"-kohteet** ja **Suorita**. ## KeyIntegraatiot KeyCom tukee integraatioita ulkoisiin palveluihin konfiguroitavien JSON-objektien avulla. Integraatio mahdollistaa automaattisen tiedonsiirron käyttämällä standardeja HTTP-menetelmiä (esim. GET, POST) ja tukee dynaamisia parametreja sekä useita eri autentikointityyppejä (Token, JWT, Digest, Basic). Konfiguraatio voidaan luoda **KeyIntegration Service wizard** -työkalulla ja sitä voidaan muokata tekstivakion **Valinnaiset tiedot** -kentässä. Konfiguroidut integraatiot löytyvät **Key-integroidun palvelun asetukset** -valikosta. Konfiguraation ryhmänimi on aina **KEY_INTEGRATION_CFG**. ### KeyIntegraatioiden konfigurointi Konfiguroinnin helpottamiseksi käytettävissä on **KeyIntegration Service wizard** -lomake. Toiminto avaa lomakkeen, jonka avulla palvelukonfiguraatio voidaan luoda. Luotu JSON-konfiguraatio määrittelee ulkoisen palvelun URL-osoitteen ja tavan, jolla palvelua kutsutaan (HTTP-menetelmä, parametrit, runko ja autentikointimenetelmä). #### Uuden konfiguraation luominen 1. Aloita määrittämällä pakollinen **HTTP-****menetelmä**-kenttä, joka kertoo, mitä verkkometodia käytetään palvelun kutsumiseen. Tuetut metodit ovat: **GET**, **PUT**, **POST**, **PATCH** ja **DELETE**. 2. Täytä myös toinen pakollinen kenttä **Päätepiste**, joka on ulkoisen palvelun täydellinen URL-osoite. 3. Voit halutessasi määrittää myös: 1. **Parametrit**: kutsussa käytettävä kyselymerkkijono ilman ?-merkkiä 2. **Sisältö**: kutsun sisältö, joka voi olla joko merkkijono tai sanakirjamainen objekti![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1761124806621.png) 4. Klikkaa **Seuraava** jatkaaksesi. 5. Seuraavassa näkymässä valitse haluttu autentikointimenetelmä **Authentication Type** -pudotusvalikosta. Tuetut tyypit ovat: **Token**, **JWT**, **Digest** ja **Basic**. ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1761124977017.png) 6. Klikkaa **Seuraava** jatkaaksesi. 7. Valinnan jälkeen lomake mukautuu näyttämään vain kyseiselle menetelmälle tarkoitetut kentät: 1. **Token**: pyytää kiinteän token-arvon 2. **JWT**: ohjaa määrittämään tokenin päätepisteen, esiautentikointimenetelmän, tunnistetiedot ja tarvittaessa POST-sisältö 3. **Digest** ja **Basic**: pyytävät käyttäjätunnuksen ja salasanan 8. Klikkaa lopuksi **Valmis** tallentaaksesi konfiguraation. Uusi konfiguraatio näkyy nyt **Key-integroidun palvelun asetukset** -listassa, jossa sitä voi tarkastella tai muokata. #### Dynaamiset arvot ja parametrit Konfiguraation **Sisältö**- ja **Parametrit**-kentät voivat sisältää dynaamisia paikkamerkkejä, jotka täytetään automaattisesti käyttäjän syötteiden perusteella. Dynaamiset arvot merkitään **kaksoiskaarisulkeilla**, esimerkiksi: ```json "id={{cable_id}}" ``` Tässä {{cable_id}} on dynaaminen parametri. Kun integraatio käynnistetään, järjestelmä etsii kyselyparametreista kentän nimeltä **cable_id** ja korvaa paikkamerkin käyttäjän antamalla arvolla. Tämä toimii samalla tavalla sekä **Sisältö**- ja **Parametrit**-kentissä, mahdollistaen käyttäjälähtöiset palvelukutsut. ### Konfigurointi lomakevalikkoon Jos haluat käyttää konfiguraatiota lomakkeen kautta, sinun tulee luoda uusi kohde lomakevalikkoon. Tämä yhdistää lomakkeen aiemmin määritettyyn integraatioon linkin kautta. Lue lisää: [Ohjattu lomakevalikko](/kb/docs/lomakkeiden-integrointi-asetukset-1-1-1#ohjattu-lomakevalikko).