Portalų žiniatinklio API komponento pavyzdžio įdiegimas
Toliau pateikiamas kodo komponento, kuris naudoja portalo žiniatinklio API tokiems veiksmams kaip kurti, nuskaityti, naujinti ir naikinti atlikti, diegimo pavyzdys. Komponentas generuoja keturis mygtukus, kuriuos spustelėjus iškviečiami skirtingi žiniatinklio API veiksmai. Žiniatinklio API iškvietimo rezultatas konvertuojamas į HTML div elementą kodo komponento apačioje.
Būtinosios sąlygos
- Jūsų portalo versija turi būti 9.3.10.x arba naujesnė.
- Darbo pradžios portalo paketas turi būti 9.2.2103.x arba didesnis.
- Turite įjungti svetainės parametrus, kad galėtumėte įjungti portalų žiniatinklio API savo portalui. Žiniatinklio API svetainės parametrai
- Konfigūruokite lentelės saugą naudodami lentelės teises. Lentelės teisės
Kodas
Visą komponento pavyzdį galite atsisiųsti čia.
Pagal numatytuosius nustatymus pavyzdyje komponentas sukonfigūruotas taip, kad žiniatinklio API pavyzdžiuose būtų galima kurti, nuskaityti ir nustatyti pavadinimo ir pajamų laukus.
Norėdami pakeisti bet kurios lentelės ar stulpelio numatytąją konfigūraciją, atnaujinkite toliau nurodytas konfigūracijos reikšmes, kaip parodyta.
private static \_entityName = "account";
private static \_requiredAttributeName = "name";
private static \_requiredAttributeValue = "Web API Custom Control (Sample)";
private static \_currencyAttributeName = "revenue";
private static \_currencyAttributeNameFriendlyName = "annual revenue";
Naudojant createRecord metodą, sugeneruojami trys mygtukai, kurie leidžia kurti kliento įrašą, kurio pajamų laukui nustatytos skirtingos reikšmės (100, 200, 300).
Kai pasirenkate vieną iš kūrimo mygtuku, mygtuko onClick įvykio apdorojimo programa patikrina pasirinkto mygtuko reikšmę ir naudoja žiniatinklio API veiksmą, kad sukurtų kliento įrašą, kuriame pajamų laukui nustatyta mygtuko reikšmė. Kliento įrašo pavadinimo laukas bus nustatytas kaip Žiniatinklio API kodo komponentas (imtis) su prie eilutės pabaigos pridėtu atsitiktiniu int. Naudojant atgalinio iškvietimo metodą, žiniatinklio API iškvietimas konvertuoja iškvietimo (sėkmingo ir nesėkmingo) rezultatą į pasirinktinio valdiklio rezultato div.
Naudojant deleteRecord metodą, sugeneruojamas mygtukas, kuris ištrina pasirinktą įrašą iš išskleidžiamojo valdiklio. Išskleidžiamasis valdiklis leidžia pasirinkti kliento įrašą, kurį norite ištrinti. Išskleidžiamajame valdiklyje pasirinktus įrašą ir pažymėjus mygtuką Ištrinti įrašą, įrašas ištrinamas. Naudojant atgalinio iškvietimo metodą, žiniatinklio API iškvietimas konvertuoja iškvietimo (sėkmingo ir nesėkmingo) rezultatą į pasirinktinio valdiklio rezultato div.
Metodas FetchXMLretrieveMultiple pateikia mygtuką kodo komponente. Kai iškviečiamas onClick šio mygtuko metodas,sugeneruojamas ir perduodamas funkcijai FetchXML , retrieveMultiple kad būtų galima apskaičiuoti vidutinę visų sąskaitų įrašų pajamų lauko vertę. Naudojant atgalinio iškvietimo metodą, žiniatinklio API iškvietimas konvertuoja iškvietimo (sėkmingo ir nesėkmingo) rezultatą į pasirinktinio valdiklio rezultato div.
Naudojant OData retrieveMultiple metodą, sugeneruojamas kodo komponento mygtukas. Iškvietus šio mygtuko onClick metodą, sugeneruojama ir funkcijai retrieveMultiple perduodama „OData“ eilutė, kad būtų galima nuskaityti visus kliento įrašus, kurių pavadinimo laukas yra panašus į kodo komponento žiniatinklio API (imtis), kuris yra teisingas visiems kliento įrašams, kuriuos sukūrė šis kodo komponentas.
Sėkmingai nuskaičius įrašus, kodo komponentas įgyja logiką, pagal kurią galima apskaičiuoti, kelių kliento įrašų pajamų laukas nustatytas į 100, 200 arba 300; šis skaičius rodomas „OData“ būsenos konteinerio div kodo komponente. Naudojant atgalinio iškvietimo metodą, žiniatinklio API iškvietimas konvertuoja iškvietimo (sėkmingo ir nesėkmingo) rezultatą į pasirinktinio valdiklio rezultato div.