Admicom Flex - Admicom Vision -integraatio

Muokattu To, 7 Marras klo 1:21 PM

Admicom Flexin ja Admicom Visionin välille toteutetun integraation avulla voit helposti käyttää Flexiä ja Visionia saumattomasti yhdessä. Tässä artikkelissa on kerrottu miten integraatio toimii sekä kuvattu integraation käytön aloitus.

Miten integraatio toimii?

Kun integraatio on käytössä, tehtävän luonti Flexissä luo automaattisesti tehtäväkohtaisen kansion Visioniin. Voit liikkua helposti linkkiä klikkaamalla Flexistä Visioniin täyttämään tarvittavat lomakkeet.

Integraatiota voidaan käyttää kahdella tavalla:

  1. Integraatio luo Visioniin Kohde/Urakka/Projektikohtaisen kansion ja sen alle tehtäväkohtaisen kansion.
    1. Jos Flexissä on hierarkinen rakenne, niin Visioniin voidaan luoda vastaava hierarkinen kansiorakenne. Esimerkiksi Kohde/Huoneisto/Tehtävät.
  2. Integraatio luo Visioniin vain tehtäväkohtaiset kansiot.

Suosittelemme ensisijaisesti ensimmäistä vaihtoehtoa, jotta Visionin kansiorakenne vastaa Flexin rakennetta ja rakenne säilyy selkeämpänä.

Flexiin syntyy automaattisesti siirtymislinkki Visioniin. Flexin pääkäyttöliittymästä pääset siirtymään linkin kautta Visionin tehtävä- ja/tai kohdekohtaiseen kansioon. Flexin mobiilikäyttöliittymässä on siirtymislinkki tehtäväkohtaiseen kansioon.

Visionin tehtäväkohtaiselle kansiolle siirtyy aina tunnistetietoina tehtävän otsikko, työnumero, toimitusosoite, toimitusasiakas ja laskutusasiakas.

Käytön selkeyden vuoksi Visioniin syntyy integraation avausvaiheessa Flex-juurikansio, jonka sisältä löytyvät Flex-tehtävien kansiot kohteittain ja tehtävittäin.

Visionissa voit halutessasi jakaa pääsyoikeuden valittuihin kansioihin myös yrityksesi ulkopuolisille käyttäjille tai kumppaneillesi. Tutustu tarkemmin Visionin ominaisuuksiin ja hyötyihin Visionin sivulla.

Integraation käyttöönotto: Asiakas

Saat integraation käyttöösi olemalla yhteydessä tukeemme [email protected]. Jos Vision on sinulle tuttu, voit jo etukäteen luoda Visioniin Pohjat sekä API-avaimen. Jos Vision ei ole sinulle entuudestaan tuttu, auttaa tukemme mielellään. Ole siis rohkeasti yhteydessä meihin.

  1. Luo Visioniin tarpeen mukaiset pohjat. Voit siirtyä Visioniin pohjien luontiin tästä, tarkempi ohje täällä
    • Flexissä voit asettaa yhden pohjan per tietotyyppi (kohde, urakka, projekti, huoneisto...) sekä yhden pohjan per tehtävätyyppi. Kaikilla tietotyypeillä ja tehtävätyypeillä voi olla myös sama Visionin kansiopohja.
      • Huomioi, että Flexistä siirtyy automaattisesti tehtäväkohtaiselle kansiolle tunnistekentiksi: otsikko, työnumero, työn otsikko, toimitusosoite, toimitusasiakas ja laskutusasiakas. Älä siis luo pohjaan em. tunnisteita!
      • Suosituksemme on, että nimeät nämä pohjat esimerkiksi Flex-alulla, jotta myöhemmin tunnistat helposti integraation käyttämät pohjat.
      • Suosituksemme on myös, että luot erilliset pohjat eri tehtävätyypeille, jolloin voit myöhemmin helposti tehdä muutoksia yksittäisen tehtävätyypin pohjaan.
    • Ota Visionin pohjan luonnissa talteen selaimen osoiterivillä näkyvä pohjan numerotunnus. Kuvassa numerotunnus on keltaisella yliviivattu 43024.
  2. Toimita tuellemme tieto pohjien numerotunnuksista/haluttu tietotyyppi sekä numerotunnuksista/tehtävätyyppi.
    • Voit myöhemmin tarvittaessa muokata Visionissa pohjien sisältöjä ja nimiä.
  3. Luo Visioniin API-avain. Voit siirtyä Visionin API-avaimen luontiin tästä, tarkempi ohje API-avaimen luontiin on täällä.
    • API-avain kannattaa nimetä esimerkiksi nimellä "Flex", jotta tiedät myöhemmin, minkä integraation avaimesta on kyse.
  4. Toimita tuellemme API-avain suojatulla sähköpostilla osoitteeseen [email protected].


Integraation käyttöönotto: Flexin asiakastuki

Vaihtoehto 1: Integraatio luo Visioniin Kohde/Urakka/Projekti/Huoneisto-kohtaisen kansion ja sen alle tehtäväkohtaisen kansion

Huom! Jos Flexin tietorakenne on hierarkkinen (esimerkiksi Kohde/Huoneisto), niin suositus on, että hierarkian kaikille tietotyypeille lisätään tässä olevan ohjeen mukaisesti Kansiopohjan tunnus ja "Linkki"-attribuutti.

  1. Lisää Asetukset - Järjestelmä - Tietotyypit -näkymän kautta halutuille tietotyypeille Visionin kansiotunnus tietotyypin muokkauksessa Integraatiot-välilehdellä kohtaan "Kansiopohjan tunnus".
    • Suositus on, että kaikille tietotyypeille lisätään kansiopohjan tunnus heti alkuvaiheessa, jotta tunnuksia ei tarvitse lisätä myöhemmin, jos asiakas esimerkiksi haluaakin ottaa käyttöön uudella tehtävätyypillä Visionin lomakkeet.
  2. Lisää samaisille tietotyypeille uusi attribuutti, jonka tyyppi on "Linkki". Nimeä attribuutti esimerkiksi "Avaa Vision".
    • Linkki-attribuuttityyppi on yksittäisellä tietotyypillä muokattavissa superadmin-roolilla.
  3. Lisää Asetukset - Tehtävät ja resursointi -näkymän kautta halutuille tehtävätyypeille Visionin kansiotunnus tehtävätyypin muokkauksessa Integraatiot-välilehdellä kohtaan "Kansiopohjan tunnus".
  4. Toimita tekniikalle API-avain ja tekniikka käynnistää integraation. HUOM! Api-avaimen tulee olla asiakkaan luoma, jotta toimii!
  5. Kuittaa asiakkaalle, kun integraatio on käynnistetty.
    • Asiakas kannattaa myös ohjeistaa antamaan tarvittaville käyttäjille käyttöoikeus Visionin Flex-juurikansioon. Jos käyttöoikeutta juurikansioon ei ole, on luvitus tehtävä aina kohde tai tehtäväkohtaisesti erikseen.

Vaihtoehto 2: Integraatio luo Visioniin vain tehtäväkohtaisen kansion 

  1. Lisää Asetukset - Tehtävät ja resursointi -näkymän kautta halutuille tehtävätyypeille Visionin kansiotunnus tehtävätyypin muokkauksessa Integraatiot-välilehdellä kohtaan: "Kansiopohjan tunnus".
  2. Toimita tekniikalle API-avain ja tekniikka aktivoi integraation. HUOM! Api-avaimen tulee olla asiakkaan luoma, jotta toimii! 
  3. Kuittaa asiakkaalle, kun integraatio on käynnistetty.
    • Asiakas kannattaa myös ohjeistaa antamaan tarvittaville käyttäjille käyttöoikeus Visionin Flex-juurikansioon. Jos käyttöoikeutta juurikansioon ei ole, on luvitus tehtävä aina kohde tai tehtäväkohtaisesti erikseen.

Integraatiossa siirtyvät tiedot

Jos sekä Flexin tietotyypillä ja Flexin tehtävätyypillä on Flexin asetuksissa asetettu kansiopohjan tunnus, niin tiedot siirtyvät seuraavasti:

Flexissä oleva tietoKotoprossa oleva tieto
Tietotyypin nimi monikossa (Kohteet/ Urakat/ Projektit)Kotopron Flex-juurikansioon luotavan kansion nimi
Tietotyypin nimi (As Oy Haapa/ Saneerausurakka 123)Edellä mainitun kansion nimi
Alitietotyypin nimi (Huoneisto)Edellä mainitun kansion alikansion nimen alku
Alitietotyyppi (A3)Edellä mainitun kansion alikansion nimen loppu. Alikansion nimi on siis esimerkiksi (Huoneisto - A3)
Tehtävänumero (12345/ 65432)Tehtäväkohtaisen kansion nimi sekä tehtäväkohtaisen kansion metatiedot
Tehtävän otsikko (Sähköpistokkeen asennus)Tehtäväkohtaisen kansion nimi ja
Tehtäväkohtaisen kansion tunnistetiedot
Toimitusosoite (Esimerkkikuja 1, 00100 Helsinki)
Tehtäväkohtaisen kansion tunnistetiedot
Toimitusasiakas (As Oy Haapa)
Tehtäväkohtaisen kansion tunnistetiedot
Laskutusasiakas (As Oy Haapa)
Tehtäväkohtaisen kansion tunnistetiedot

Mahdolliset ongelmatilanteet

OngelmaRatkaisu
Saan Visionissa ilmoituksen "Tämä kohde on poistettu tai sitä ei ole jaettu sinulle."Kyseessä voi olla kaksi eri tilannetta:
1. Visionin kyseinen kansio on poistettu: Visionissa kansion poisto siirtää kansion Vision-ohjelmiston sisäiseen roskakoriin. Voit palauttaa kansion Visionissa. Jos kansiota ei haluta palauttaa, voi kansiolinkin poistaa Flexistä tukemme kautta, ole tarvittaessa yhteydessä [email protected].

2. Sinulla ei ole oikeutta Visionin kansioon. Suosittelemme, että käyttöönoton yhteydessä tarvittaville käyttäjille annetaan pääsy Visionin Flex-juurikansioon, jolloin myös alikansiot perivät käyttöoikeuden. Vaihtoehtoisesti voit antaa luvan aina kansiokohtaisesti Visionissa esim. asentajille.
Flexin kohteen nimi ei päivity Visionin kansiolleKansio luodaan kerran ja kansion nimeä ei päivitetä Flexistä Visioniin tai Visionista Flexiin. Jos haluat muuttaa kohteen/kansion nimeä, muokkaa nimi käsin molemmissa järjestelmissä.
Tehtävän otsikko ei päivity Visionin kansiolleTehtäväkohtainen kansio luodaan kerran ja kansion nimeä ei päivitetä Flexistä Visioniin tai Visionista Flexiin. Jos haluat muuttaa kansion nimeä, muokkaa nimi käsin molemmissa järjestelmissä.
Visionin kansion tunnistekentät eivät päivity, vaikka muutan esimerkiksi osoitetta FlexissäTunnistekenttien tiedot luodaan kerran ja tietoja ei päivitetä Flexistä Visioniin tai Visionista Flexiin. Jos haluat muuttaa tunnistekenttien tietoja, muokkaa ne käsin molemmissa järjestelmissä.
Kaikkien Flexin kautta Visioniin luotujen kansioiden luoja ja omistaja on aina sama käyttäjäViosionin kansioiden omistajaksi ja luojaksi asetetaan aina se käyttäjä, joka on luonut API-avaimen.
Tehtäväkohtaiset kansiot luodaan Visionissa Flex-juurikansioonIntegraatio on konfiguroitu vaihtoehto 2:n mukaisesti. Ole yhteydessä tukeemme ja kerro, että haluaisit, että integraatio toimii vaihtoehto 1:n mukaisesti.
Flexin mobiilisovelluksen Vision-linkki ei avaa Visionia tai Vision ei aukea oikean tehtävän kohdalle
Varmista, että sinulla on Flex-sovelluksen uusin versio käytössä. Lataa tarvittaessa sovelluksen päivitys Google Play -kaupasta.