Örnek portal Web API'si bileşeni uygulama
Aşağıda, oluşturma, alma, güncelleştirme ve silme işlemlerini gerçekleştirmek için portal Web API'sini kullanan bir kod bileşeninin uygulanmasına örnek verilmiştir. Bileşen, farklı Web API eylemlerini çağırmak için tıklanabilecek dört düğme oluşturur. Web API çağrısının sonucu, kod bileşeninin alt kısmındaki bir HTML div öğesine eklenir.
Önkoşullar
- Portal sürümünüz 9.3.10.x veya üzeri olmalıdır.
- Başlangıç portal paketini 9.2.2103.x veya daha üst bir sürüm olmalıdır.
- Portalınızın, portal Web API'sini etkinleştirmek için site ayarını etkinleştirmeniz gerekir. Web API'si için site ayarları
- Tablo izinlerini kullanarak tablo güvenliğini yapılandırın. Tablo izinleri
Kod
Örnek bileşenin tümünü buradan indirebilirsiniz.
Varsayılan olarak, örnekteki bileşen oluşturma, alma,Web API örneklerinde ad ve gelir alanlarını belirleyecek şekilde yapılandırılmıştır.
Varsayılan yapılandırmayı herhangi bir tablo veya sütunla değiştirmek için, aşağıdaki yapılandırma değerlerini gösterildiği gibi güncelleştirin
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";
createRecord yöntemi üç düğme oluşturur, bu da gelir alanını farklı değerlere ayarlanmış olarak bir firma kaydı oluşturmanıza olanak sağlar (100, 200, 300).
Oluştur düğmelerinden birini seçtiğinizde, düğmenin onClick olay işleyicisi seçilen düğmenin değerini denetler ve gelir alanını düğmenin değerine ayarlanmış olarak firma kaydı oluşturmak için Web API eylemini kullanır. Firma kaydının ad alanı, dizenin sonuna rastgele int eklenmiş olarak, Web API kod bileşeni (Örnek) olarak ayarlanır. Web API çağrısındaki geri çağırma yöntemi, aramanın sonuçlarını (başarılı veya başarısız) özel denetim sonucu div'e çıkarır.
deleteRecord yöntemi, açılır listede seçilen kaydı silen bir düğme oluşturur. Drop down denetimi, silmek istediğiniz firma kaydını seçmenize olanak sağlar. Açılan kutudan firma kaydı seçildikten ve Kaydı Sil düğmesi seçildikten sonra kayıt silinir. Web API çağrısındaki geri çağırma yöntemi, aramanın sonuçlarını (başarılı veya başarısız) özel denetim sonucu div'e çıkarır.
yöntemi FetchXMLretrieveMultiple , kod bileşeninde bir düğme işler. onClick Bu düğmenin yöntemi çağrıldığında,oluşturulur FetchXML ve tüm hesap kayıtları için gelir alanının ortalama değerini hesaplamak için işleve geçirilir retrieveMultiple . Web API çağrısındaki geri çağırma yöntemi, aramanın sonuçlarını (başarılı veya başarısız) özel denetim sonucu div'e çıkarır.
OData retrieveMultiple yöntemi, kod bileşeninde bir düğme oluşturur. Bu düğmenin onClick yöntemi çağrıldığında bir OData dizesi oluşturulur ve kod bileşeni Web API (Örnek) gibi bir ad alanına sahip tüm firma kayıtlarını almak için retrieveMultiple işlevine geçirilir. Bu, ilgili kod bileşeni tarafından oluşturulan tüm firma kayıtları için doğrudur.
Kayıtların başarılı bir şekilde alınması üzerine, kod bileşeni, gelir alanının 100, 200 veya 300 olarak ayarlandığı firma kaydının sayısını saymak ve bu sayıyı kod bileşenindeki OData durum kapsayıcısına bir div olarak görüntülemesini sağlar. Web API çağrısındaki geri çağırma yöntemi, aramanın sonuçlarını (başarılı veya başarısız) özel denetim sonucu div'e çıkarır.