openForm (Клиент API сілтемесі)

Субъект пішінін немесе жылдам жасау пішінін ашады.

Ескертпе

Негізгі пішінді диалогтық терезе ретінде ашу үшін оның орнына navigateTo әдісін пайдаланыңыз. Қосымша ақпарат: Клиент API көмегімен диалогтық терезеде негізгі пішінді ашыңыз

Синтаксис

Xrm.Navigation.openForm(entityFormOptions, formParameters).then(successCallback, errorCallback);

Параметрлер

Аты	Түр	Қажетті	Сипаттамасы
`entityFormOptions`	Нысан	Иә	Пішінді ашуға арналған пішін параметрлері. EntityFormOptions нысанын қараңыз
`formParameters`	Нысан	Жоқ	Пішінге қосымша параметрлер өтетін сөздік нысан. Жарамсыз параметрлер қате тудырады. Пішінге параметрлерді беру туралы ақпарат алу үшін Пішінге берілген параметрлерді пайдаланып баған мәндерін орнату және Реттелетін сұрау жолының параметрлерін қабылдау үшін пішінді конфигурациялау бөлімін қараңыз.
`successCallback`	Function	Жоқ	Жазба жылдам құру формасында сақталғанда орындалатын функция. Бұл функция объектіні параметр ретінде қабылдайды. Объекттің көрсетілетін немесе жасалған жазбаларды анықтау үшін келесі қасиеттері бар массивке ие `savedEntityReference` : - `entityType`: Кестенің логикалық атауы. - `id`: Жазбаға арналған GUID мәнінің жолдық бейнесі. - `name`: Көрсетілген немесе жасалған жазбаның негізгі баған мәні. ЕСКЕРТУ: - Бар немесе жаңа жазба үшін форма ашқанда бұл `successCallback` функция орындалмайды. - Функция `successCallback` openForm әдісі арқылы ашылған жазбаны жылдам жасау пішінінде сақтағанда ғана орындалады.
`errorCallback`	Function	Жоқ	Операция істен шыққанда орындайтын функция.

entityFormOptions нысаны

Объект келесі құндылықтарды қамтиды:

Аты	Түр	Қажетті	Сипаттамасы
`entityName`	String	Иә	Пішінді көрсетуге арналған кестенің логикалық атауы.
`entityId`	String	Жоқ	Пішінді көрсету үшін кесте жазбасының идентификаторы.
`formId`	String	Жоқ	Көрсетілетін қызметті көрсету формасын анықтау.
`cmdbar`	Буль	Жоқ	Пәрмен жолағын көрсету керектігін көрсетеді. Егер бұл параметрді көрсетпесеңіз, командалар жолағы әдепкі бойынша көрсетіледі. Параметрді шындық ретінде беру `openInNewWindow` қажет.
`createFromEntity`	Қарау	Жоқ	Бейнеленген бағана мәндеріне негізделген әдепкі мәндерді беретін жазбаны белгілейді. Іздеу нысанының келесі Жол қасиеттері бар: `entityType`, `id`және `name` (міндетті емес).
`openInNewWindow`	Буль	Жоқ	Форманы жаңа терезеде немесе жаңа қойындыда көрсету керек пе, көрсетеді. Егер биіктік немесе ені мәндерін көрсетіп `true` , көрсетпесеңіз, форма жаңа қойындыда көрсетіледі. Форманы жаңа терезеде немесе жаңа қойындыда ашқанда, форманы көрсету баяу болады; оның орнына негізгі форма диалогында форманы ашуды қарастырыңыз. Бұл қасиет қазіргі уақытта Quick Create формаларына қолдау көрсетілмейді, себебі оларды жаңа терезеде немесе қойындыда ашу мүмкін емес.
`height`	Саны	Жоқ	Пикселдерде көрсетілетін пішін терезесінің биіктігі. Параметрді шындық ретінде беру `openInNewWindow` қажет.
`width`	Саны	Жоқ	Пішін терезесінің ені пикселдерде көрсетіледі. Параметрді шындық ретінде беру `openInNewWindow` қажет.
`navbar`	String	Жоқ	Шарлау тақтасының көрсетілуін және сайт картасында анықталған аймақтар мен субөңірлерді пайдалана отырып, бағдарлама шарлауының қол жетімді екенін басқарады. Жарамды мәндер: `on`, `off`, немесе `entity`. openInNewWindow параметрін true деп беру қажет. - `on`: Навигация тақтасы көрсетіледі. Егер навигация панелі параметрі қолданылмаса, бұл әдепкі әрекет. - `off`: Навигация жолағы көрсетілмейді. Адамдар басқа пайдаланушы интерфейс элементтерін немесе артқы және алға түймешіктерді пайдалана отырып шарлай алады. - `entity`: Пішінде тек байланысты кестелер үшін шарлау параметрлері қол жетімді. Байланысты кестеге өткеннен кейін, бастапқы жазбаға оралуға мүмкіндік беретін шарлау тақтасында Артқа түймешігі көрсетіледі.
`relationship`	Нысан	Жоқ	Пішіндегі байланысты жазбаларды көрсету үшін қатынас нысанын анықтаңыз. Қатынас нысанын қарау
`selectedStageId`	String	Жоқ	Бизнес-процесс үлгісі бойынша таңдалған кезеңнің идентификаторы.
`useQuickCreateForm`	Буль	Жоқ	Жылдам құру пішінін ашу керек пе, жоқ па, соны көрсетеді. Кестеде жылдам жасау пішінін көрсету үшін Жылдам құруға рұқсат беру параметрі қосылуы керек, сондай-ақ бағдарламаға кесте мен жылдам жасау пішінін қосу керек. Егер мәнін көрсетпесеңіз `useQuickCreateForm`, әдепкі параметр `false`.

Қатынас нысаны

Объект келесі құндылықтарға ие.

Аты	Түр	Сипаттамасы
`attributeName`	String	Қарым-қатынас үшін қолданылатын бағанның атауы.
`name`	String	Қарым-қатынас үшін қолданылатын бағанның атауы.
`navigationPropertyName`	String	Қарым-қатынас үшін қолданылатын бағанның атауы.
`relationshipType`	Саны	Қатынас түрі. Келесі мәндердің бірін көрсетіңіз: - 0:OneToMany - 1:Көптен көпке
`roleType`	Саны	Қарым-қатынастағы рөл түрі. Келесі мәндердің бірін көрсетіңіз: - 1:Сілтеме жасау - 2:Қауымдастық субъектісі

Ескертпелер

Бұл әдісті ескірген Xrm.Utility.openEntityForm және Xrm.Utility.openQuickCreate әдістерінің орнына кесте ашу немесе пішіндерді жылдам жасау үшін пайдалану керек.

Белгілі бір бизнес-процесті көрсету үшін setActiveProcess және пішінде белгілі бір бизнес-процесс данасын көрсету үшін setActiveProcessInstance функциясын пайдаланыңыз.

Мысалдар

1-мысал: Бар жазбаға арналған пішінді ашу

Келесі үлгі код бұрыннан бар контакт жазбасын көрсету үшін контакт пішінін ашады:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["entityId"] = "00aa00aa-bb11-cc22-dd33-44ee44ee44ee";

// Open the form.
Xrm.Navigation.openForm(entityFormOptions).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

2-мысал: Жаңа жазбаға арналған пішінді ашу

Келесі үлгі код жаңа жазбаны жасау үшін алдын ала толтырылған мәндері бар контакт пішінін ашады:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

3-мысал: Жаңа жазбаға арналған пішінді ашу (күрделі іздеу)

Төмендегі үлгі код алдын ала толтырылған мәндермен (күрделі іздеуді қоса) жаңа жазба жасау үшін әрекет формасын ашады:

var entityFormOptions = {};
entityFormOptions["entityName"] = "email";

// Set default values for the Contact form
var formParameters = {};
formParameters["subject"] = "Sample";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["regardingobjectid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["regardingobjectidname"] = "Admin user"; // Name of the user.
formParameters["regardingobjectidtype"] = "systemuser"; // Table name. 
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

4-мысал: Жылдам жасау пішінін ашу

Келесі үлгі код алдын-ала толтырылған мәндері бар жылдам құру контакт пішінін ашады:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["useQuickCreateForm"] = true;

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
formParameters["preferredsystemuseridtype"] = "systemuser"; // Table name.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

Xrm.Navigation

Кері байланыс

Бет пайдалы болды ма?

Last updated on 2026-05-01