Kohteen elinkaari
Suositeltu työnkulku kohteen luomiseen Fabric-käyttöliittymässä on
- Esitä käyttäjälle kehote kohteen nimestä.
- Luo tyhjä kohde.
- Muokkaa ja tallenna uusi kohde.
Tämä prosessi voidaan jakaa seuraaviin vaiheisiin:
Kun käyttäjä valitsee painikkeen minkä tahansatyyppisen kohteen luomiseksi, Fabric FE (portaali) -koodin on ladattava vastaava kohdeeditori. Fabric FE tekee API-kutsun Fabric BE:lle vaadittujen tietojen noutamiseksi, mukaan lukien lähteen URL-osoite, Microsoft Entra ID -sovellustiedot ja kuormituksen BE-URL-osoite, jotka kaikki vastaavat nykyistä kontekstia. Kun nämä tiedot ovat käytettävissä, kohde luodaan. Yleensä kohde lataa staattiset resurssinsa, kuten HTML:n, JavaScriptin, CSS:n ja CDN:n kuvat. Suosittelemme käyttämään usean alueen CDN-käyttöönottoa ja määrittämään nimen tarkkuuden niin, että lähde-URL-osoite ratkaistaan CDN-palvelimeen, joka on fyysisesti lähimpänä selaimen nykyistä sijaintia.
Muistiinpano
Kohdeeditorin on yleensä tehtävä kutsuja kuormitukseen BE mahdollisesti muokkausvaiheessa. Tämä edellyttää kuormituksen BE URL-osoitteen selvittämistä nykyisen kontekstin mukaan. Tällä hetkellä koodi voi käyttää pysyväiskoodatun BE-URL-osoitteen.
Tyhjän kohteen luominen
Fabricissa on yleinen käytäntö luoda kohde, joka ei sisällä käyttäjän syötettä kohteen nimeä lukuun ottamatta. Tällaisten kohteiden ei odoteta tekevän mitään merkityksellistä (siis "tyhjä"), mutta ne näkyvät työtilassa ja voivat osallistua perustason työnkulkuihin ja toimintoihin. Lisäksi joissakin tapauksissa ne voivat olla jopa toiminnallisia kuormituksen määrittämien kohtuullisten oletusarvojen mukaan.
Työnkulku alkaa kehotuksella, että käyttäjä antaa uudelle kohteelle nimen. Kun nimi on , iframe lähettää JS-isäntärajapinnalle kutsun kohteen luomisen työnkulun aloittamiseksi ja välittää valinnaisen JSON-objektin "luomisen tietona", ja isäntä lähettää sitten kutsun Fabric BE:lle. Isäntä käsittelee todentamisen. Fabric BE selvittää kuormituksen BE-URL-osoitteen kontekstin mukaan ja kutsuu kuormituksen CreateItem ohjelmointirajapintaa välittämällä iframen lähettämän "luomisen hyötykuorman". Kuormituksen BE:n odotetaan tallentavan uuden kohteen metatiedot ja mahdollisesti varaavan joitakin resursseja (vaikka tätä vaihetta voidaan lykätä myöhempään kohtaan) ja tehdä mitä tahansa muuta olennaista työtä. Kun kohteen luonti on valmis kuormituksen BE-perspektiivistä, sen on ilmoitettava Fabric BE:lle kohteen metatietojen muutoksesta. Kohteen metatietojen päivityksessä on tapahduttava sama prosessi, joten aihetunnus on vaihdettava Fabric BE -yleisölle.
Muistiinpano
Kohteen metatietopäivitykselle ilmoittamisen ohjelmointirajapinta ei ole tällä hetkellä käytettävissä.
Lataa kohde
Jos haluat muokata kohdetta, iframe-kehyksen on ladattava metatiedot. Tämä prosessi on sama "tyhjän" ja "alustetun" kohteen lataamisessa. Iframe lähettää kutsun JS-isäntäohjelmoijuusrajapinnalle, joka kutsuu Fabric BE:tä, joka puolestaan kutsuu GetItemPayload-kuormituksen ohjelmointirajapintaa. Kuormituksen BE voi palauttaa JSON-objektin, joka siirretään sitten takaisin iframe-kehykseen. Isäntä käsittelee todentamisen.
Kohteen muokkaaminen
Kun kohteen metatiedot on ladattu, muokkausistunto voi käynnistyä. Iframe-kehyksen on ehkä tehtävä kutsuja be-kuormitukseen joko istunnon alussa tai aikana (esimerkiksi määritysten noutamiseksi, käyttöliittymän ohjausobjektien täyttämiseksi, vahvistusten suorittamiseksi ja niin edelleen). Tätä varten sen on pyydettävä tunnus isännän JS-ohjelmointirajapinnasta.