Portāla tīmekļa API komponenta parauga ieviešana
Tālāk sniegtajā piemērā ir parādīts koda komponenta ieviešanas piemērs, kas izmanto portāla tīmekļa API, lai veiktu izveides, izgūšanas, atjaunināšanas un dzēšanas darbības. Komponents atveido četras pogas, uz kurām var noklikšķināt, lai izsauktu dažādas tīmekļa API darbības. Tīmekļa API izsaukuma rezultāts tiek ievadīts HTML div
elementā, kas atrodas koda komponenta apakšdaļā.
Priekšnoteikumi
- Jūsu portāla versijai ir jābūt 9.3.10.x vai jaunākai.
- Sākuma portāla pakotnei ir jābūt 9.2.2103.x vai jaunākai.
- Jums ir jāiespējo vietnes iestatījums, lai iespējotu portālu tīmekļa API jūsu portālam. Tīmekļa API vietnes iestatījumi
- Tabulas konfigurēšana, izmantojot tabulu atļaujas. Tabulas atļaujas
Kods
Šeit var lejupielādēt pilnu komponenta paraugu.
Pēc noklusējuma parauga komponents ir konfigurēts, lai veiktu izveidi un izgūšanu un iestatītu nosaukumu un ieņemumu laukus Tīmekļa API piemēros.
Lai mainītu noklusējuma konfigurāciju uz jebkuru tabulu vai kolonnu, atjauniniet tālāk norādītās konfigurācijas vērtības.
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";
Metode createRecord
atveido trīs pogas, kas ļauj izveidot uzņēmuma ierakstu ar ieņēmumu lauku, kas iestatīts dažādām vērtībām (100, 200, 300).
Atlasot kādu no izveides pogām, pogas onClick
notikumu apdarinātājs pārbauda atlasītās pogas vērtību un izmanto tīmekļa API darbību, lai izveidotu uzņēmuma ierakstu ar ieņēmumu lauku, kas ir iestatīts uz pogas vērtību. Konta ieraksta nosaukuma lauks tiek iestatīts kā Tīmekļa API koda komponents (paraugs), un virknes beigās tiek pievienots nejauši izvēlēts int
. Atzvanīšanas metode no tīmekļa API izsaukuma ievieto izsaukuma rezultātu (sekmīgs vai kļūme) pielāgotās vadīklas rezultātā div
.
Izmantojot deleteRecord
metodi, tiek atveidots poga, kas nolaižamajā sarakstā dzēš atlasīto ierakstu. Izmantojot nolaižamo vadīklu, varat atlasīt dzēšamo konta ierakstu. Kad nolaižamajā izvēlnē ir atlasīts konta ieraksts un ir atlasīta poga Dzēst ierakstu, ieraksts tiek dzēsts. Atzvanīšanas metode no tīmekļa API izsaukuma ievieto izsaukuma rezultātu (sekmīgs vai kļūme) pielāgotās vadīklas rezultātā div
.
Metode FetchXMLretrieveMultiple
atveido pogu koda komponentā. Kad tiek izsaukta onClick
šīs pogas metode,tiek FetchXML ģenerēta un nodota funkcijai, retrieveMultiple
lai aprēķinātu ieņēmumu lauka vidējo vērtību visiem konta ierakstiem. Atzvanīšanas metode no tīmekļa API izsaukuma ievieto izsaukuma rezultātu (sekmīgs vai kļūme) pielāgotās vadīklas rezultātā div
.
OData metode retrieveMultiple
komponentā atveido pogu. Kad tiek izsaukta šīs pogas metode onClick
, tiek ģenerēta OData virkne, kas tiek nodota funkcijai retrieveMultiple
, lai izgūtu visus konta ierakstus ar nosaukuma lauku, kas līdzīgs koda komponenta Web API (paraugs), kas attiecas uz visiem ar šo koda komponentu izveidotajiem konta ierakstiem.
Sekmīgas ierakstu izgūšanas gadījumā koda komponentam ir loģika skaitīt, cik konta ierakstu ieņēmumu lauka iestatījums ir 100, 200 vai 300, un parādīt šo skaitu koda komponenta OData statusa konteinerā. Atzvanīšanas metode no tīmekļa API izsaukuma ievieto izsaukuma rezultātu (sekmīgs vai kļūme) pielāgotās vadīklas rezultātā div
.