Ulkaiset yhteydet
Yhdistä toinen palvelu oikeaan projektikontekstiin
Kuvaile liitettävä ulkoinen palvelu, toimita sen dokumentaatio ja liitä se asiaankuuluviin liiketoiminta-alueisiin.
Kokoa dokumentaatio ja käyttöoikeustiedot yhteen
- Ilmoita palvelu
Määritä ulkoinen API ja anna dokumentaation linkki tai teksti.
- Pidä käyttöoikeustiedot erillään
Anna yhteyttä varten pyydetyt testi- ja tuotantotunnukset.
- Liitä liiketoiminnan konteksti
Liitä olemassa oleva yhteys alueisiin, jotka käyttävät sitä.
Anna integraatiolle sen tarvitsemat tiedot
Yhteys alkaa palvelun nimestä ja dokumentaatiosta. Kerro, mikä liiketoiminnan toiminto sitä edellyttää ja mitä tietoja järjestelmien välillä pitää siirtyä.
Ilmoitus tukee erillisiä testi- ja tuotantoympäristön käyttöoikeustietoja. Tarkista ne yhteyden tietosivulla ja pidä ympäristön konteksti selkeänä.
Valmistele integraatio sen liiketoiminnan toiminnon ympärille, jota se tukee
Kerro, millaista tiedonvaihtoa tarvitset. Ulkoinen palvelu voi toimittaa tai vastaanottaa tietoja, joita liiketoiminnan tehtävä käyttää. Ilmoita sen nimi ja dokumentaatio ja kerro sitten aiottu tiedonvaihto projektin kontekstissa. Näin integraatiolla on käytännön tarkoitus, joka ulottuu palvelun URL-osoitetta pidemmälle.
Erota testaus tuotannosta. Testi- ja tuotantotunnukset voivat kuulua palveluntarjoajan eri tileille. Syötä ne vastaaviin kenttiin ja tarkista niiden käyttötarkoitus. Kontekstien erottaminen auttaa valmistelemaan integraation kehitys- ja tuotantovaiheita varten.
Käytä ilmoitettua yhteyttä uudelleen. Sama ulkoinen palvelu voi tukea useita liiketoiminta-alueita. Liitä olemassa oleva yhteys sinne, minne se kuuluu, ja tarkista sitten sen liitokset. Yhteyden irrottaminen alueesta ja sen poistaminen koko projektista ovat eri päätöksiä.
Käytä yhteyttä uudelleen siellä, minne se kuuluu
Ilmoitettu yhteys voidaan liittää useampaan kuin yhteen liiketoiminta-alueeseen. Tarkastele alueen liitettyjä yhteyksiä ja liitä tai irrota sopiva palvelu.
Palvelun ilmoittaminen antaa integraation vaatimukset. Tarkista sen tila ja testaa koko liiketoimintaprosessi ennen kuin luotat siihen tuotannossa.
Kerro, millaista tiedonvaihtoa sovelluksesi tarvitsee
Määritä palvelu, lähetettävät tai vastaanotettavat tiedot sekä liiketoiminta-alue, joka käyttää sitä. Linkki ajantasaiseen dokumentaatioon auttaa kuvaamaan todellisen ulkoisen sopimuksen.
Kuvaa hyödyllinen esimerkki ja odotettu toiminta silloin, kun palvelu ei ole käytettävissä. Yhteydestä voidaan silloin keskustella käyttäjiesi työn kannalta eikä pelkän palveluntarjoajan nimen perusteella.
Palvelun ilmoittamisesta testattuun prosessiin
Anna palvelun tiedot. Anna dokumentaation linkki tai sen sisältö sekä pyydetyt käyttöoikeustiedot. Määritä liiketoiminnan toiminto, joka edellyttää yhteyttä.
Liitä oikeat alueet. Liitä ilmoitettu yhteys alueisiin, jotka käyttävät sitä. Tarkista olemassa olevat liitokset ennen kuin lisäät tai poistat niitä.
Varmista valmis integraatio. Seuraa sen tilaa ja testaa aiottu tiedonvaihto asianmukaisessa ympäristössä. Pelkkä ilmoitus ei todista, että prosessi toimii.
Valmistele yhteys, jota sovelluksesi todella tarvitsee
Aloita palvelun dokumentaatiosta ja liiketoiminnan tavoitteesta. Pidä käyttöoikeustiedot ja liitokset selkeinä koko projektin ajan.
Kysymyksiä ulkoisista yhteyksistä
Anna ulkoisen palvelun nimi ja dokumentaation linkki tai liitetty sisältö. Anna testausta ja tuotantoa varten pyydetyt käyttöoikeustiedot. Pelkkä nimi ei määritä integraation toimintaa.
Olemassa oleva yhteys voidaan liittää useisiin liiketoiminta-alueisiin. Tarkista liitetyt alueet liittimen tiedoista, jotta sen laajuus pysyy ymmärrettävänä.
Ulkoinen yhteys kuvaa, miten sovelluksesi käyttää toista palvelua. Valinnainen projektin API tarjoaa sovelluksesi sovitut toiminnot muiden käyttöön. Ne palvelevat eri integraatiotarpeita.
Liittimen irrottaminen koskee vain sen liitosta yhteen alueeseen. Liittimen poistaminen projektista on erillinen toimenpide, jonka laajuus on eri; lue vahvistus ennen kuin jatkat.
Seuraa toteutusta ja testaa koko liiketoiminnan tiedonvaihto. Ilmoitettu palvelu ja sen aktivointitila ovat hyödyllistä taustaa, mutta ne eivät korvaa lopputuloksen tarkistamista.