Sisällysluettelo
- Johdanto
- Natiiviintegraatioiden ymmärtäminen
- Integraation luominen
- Integraatiolomakkeen tiedot
- Tuoteintegraation luominen
- Integraation luomisen jälkeen
- Integraatioiden tarkasteleminen ja hallinta
- Yhdistettävät tiliintegraatiot
- Yhteisömerkki ja yhteisöintegraatiot
- Asennusvirran parhaat käytännöt
- [Integraation tuki] (#integration-support)
- Johtopäätös
Johdanto
Integraatio Esadaxin kanssa tarjoaa tehokkaan tavan parantaa sovellustasi tai palveluasi. Oletpa sitten luomassa työkalua sisäiseen käyttöön tai julkaisemassa työkalua muille, tämä opas opastaa sinua integroinnin luomisen, hallinnoinnin ja optimoinnin jokaisessa vaiheessa — parhaiden käytäntöjen avulla varmistat sujuvan kokemuksen käyttäjillesi.
Natiiviintegraatioiden ymmärtäminen
Natiiviintegraatiot ovat Esadaxin ekosysteemin ensimmäisen luokan kansalaisia, jotka tarjoavat suoran ja saumattoman integraation alustan ominaisuuksien kanssa.
Tärkeimmät edut:
- Mitään väliohjelmistoa ei tarvita — Alkuperäinen tuki Esadax-alustan sisältä.
- Lyhyempi kehitysaika — Valmiit komponentit ja yksinkertaistettu asennus.
- Vahvempi kehittäjä kokemus — Täysi dokumentaatio ja alustan tuki.
Voit myös halutessasi rakentaa Custom-integraatioita, jos käyttötapauksesi vaatii ulkoisia palveluita tai ohjelmointirajapintoja.
Integraation luominen
Näin pääset alkuun:
- Siirry Integraatiot-konsoliin.
- Valitse Luo integraatio.
- Täytä lomake integraatiosi perustiedoilla (katso seuraava osio).
Integrointilomakkeen tiedot
Integrointilomaketta täytettäessä ilmoita:
- Nimi: Integroinnin yksilöllinen tunniste.
- Kuvaus: Lyhyt selitys siitä, mitä integraatiosi tekee.
- Integraatiotyyppi: Valitse ”Natiivi” tai ”Mukautettu”.
- Näkyvyysasetukset: Määritä, kuka voi nähdä tai käyttää integraatiota.
- Tuki Sähköposti: Anna yhteystiedot tukea.
- Dokumentointilinkki * (valinnainen) *: Auta käyttäjiä ymmärtämään, miten asentaa ja käyttää sitä.
- Käyttöönottopainike (valinnainen): Lisää painike, jolla integrointi otetaan automaattisesti käyttöön Gitistä.
Tuoteintegraation luominen
Kun integrointiin liittyy asennettava tuote, sinun tulee:
- Tarjoa selkeä asennusvirta, joka sopii sekä uusille että nykyisille käyttäjille.
- Sisällytä tiivis dokumentaatio asennuksesta ja käytöstä.
- Määritä oletusasetukset, jotka toimivat heti käyttöönoton jälkeen ja mahdollistavat samalla mukautuksen.
- Käytä lomakkeessa versiointia, jotta voit seurata päivityksiä ja taaksepäin yhteensopivuutta.
Integroinnin jälkeen Luominen
Julkaisun jälkeen voit:
- Valvo lokeja käyttämällä Näytä lokit -painiketta Integraatiot-konsolissa.
- Päivityksen tila: Seuraa asennusmittareita, virheitä ja versiomuutoksia.
- Hio integraatiota: Iteroi käyttäjien palautteen tai testauksen perusteella.
Integraatioiden tarkasteleminen ja hallinta
Integrointikonsolissa voit:
- Näytä luettelo integroinneistasi.
- Voit tarkastella tietoja, kuten live-URL-osoitteita, asennuslokeja ja näkyvyyden tilaa.
- Suodata lokit pyyntötyypin mukaan (esim. virheet, asennukset).
Yhdistettävät tiliintegraatiot
Jos integraatiosi yhdistää ulkoisia palveluita (esim. analytiikka, todennus, verkkokauppa):
- Ota käyttöön turvalliset tilien linkitys -työnkulut.
- Tuki usean tilin skenaarioita (yksittäinen vs. (ks. kohta 4.4).
- Vahvista tunnukset ja identiteetit Esadaxin jaetun tietoturvamallin mukaisesti.
Yhteisömerkki ja yhteisöintegraatiot
- Ulkopuolisten kehittäjien lähettämät integraatiot saavat yhteisömerkin, joka osoittaa niiden olevan kolmannen osapuolen tukemia.
- Nämä saattavat ilmestyä markkinapaikalle selkeällä merkinnällä.
- Ennen yhteisön integroinnin asentamista käyttäjien tulee tarkistaa kehittäjän:
- Tietosuojakäytännön yhteenveto
- Käyttöehdot
- Tuen tiedot
Asennusvirran parhaat käytännöt
Intuitiivisen asennuskokemuksen suunnittelu parantaa käyttöönottoa.
Suositeltava virtausnopeus:
- Uudet käyttäjät:
- Opastus tilin luomiseen asennusprosessin aikana.
- Palaavat käyttäjät:
- Salli saumaton kirjautuminen menettämättä asennuksen edistymistä.
- Virheen palautus:
- Käsittele salasanan nollauksia ja vanhentuneita istuntoja sulavasti.
- Oletusarvot:
- Määritä järkevät asetukset etukäteen tarvittavan syötteen minimoimiseksi.
- Lisäasetukset:
- Anna ne, mutta piilota ne toggle- tai laajennettavan osan taakse.
Integroinnin tukipalvelu
Olet vastuussa integraatiosi jatkuvasta tuesta:
- Vastaa nopeasti ongelmiin tukisähköpostisi kautta.
- Sisällytä vianmääritysvinkit ja tunnetut rajoitukset dokumentaatioosi.
- Harkitse versioitujen muutoslokien perustamista päivitysten kommunikoimiseksi selkeästi.
Johtopäätös
Tämän oppaan avulla voit toimittaa luotettavan ja käyttäjäystävällisen integraation Esadax-alustalle. Olitpa laajentamassa sisäisiä työnkulkuja tai rakentamassa työkaluja yhteisölle, harkittu integraatiosuunnittelu — lomakkeen rakenteesta käyttäjävirtaan — varmistaa työsi onnistumisen ja skaalautuvuuden.
