опенФорм (референца клијентског АПИ-ја)

Отвара ентитетски образац или образац за брзо креирање.

Белешка

Да бисте отворили главни образац као дијалог, користите навигатеТо метод уместо тога. Више информација: Отворите главни образац у дијалогу користећи клијентски АПИ

Синтакса

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

Параметри

Именуј	Тип	Обавезно	Опис
`entityFormOptions`	Објекат	Да	Опције обрасца за отварање обрасца. Погледајте ентитетФормОптионс објекат
`formParameters`	Објекат	Не	Објекат речника који преноси додатне параметре у форму. Неисправни параметри изазивају грешку. За информације о преношењу параметара у форму, погледајте Подешени вредности колона користећи параметре прослеђене форми и Конфигуришите образац да прихвати прилагођене параметре упитног низа.
`successCallback`	Function	Не	Функција за извршавање када се запис чува у обрасцу за брзо креирање. Ова функција прихвата објекат као параметар. Објекат има `savedEntityReference` низ са следећим својствима за идентификацију приказаних или креираних записа: - `entityType`: Логички назив табеле. - `id`: Стринг представљање ГУИД вредности за запис. - `name`: Примарна вредност колоне записа приказаног или креираног. НАПОМЕНА: - Функција `successCallback` се не извршава када отворите образац за постојећи или нови запис. - Функција `successCallback` се извршава само када сачувате запис у обрасцу за брзо креирање који је отворен методом опенФорм.
`errorCallback`	Function	Не	Функција која се извршава када операција не успе.

ентитетФормОптионс објекат

Објекат садржи следеће вредности:

Именуј	Тип	Обавезно	Опис
`entityName`	String	Да	Логички назив табеле за приказ обрасца.
`entityId`	String	Не	ИД записа табеле за приказ обрасца за.
`formId`	String	Не	ИД примера обрасца који ће бити приказан.
`cmdbar`	Омиљено	Не	Означава да ли да прикаже командну траку. Ако не специфицирате овај параметар, командна трака је приказана подразумевано. Захтева доношење `openInNewWindow` параметра као истинито.
`createFromEntity`	Lookup	Не	Означава запис који обезбеђује подразумеване вредности на основу мапираних вредности колона. Објекат за претрагу има следеће Стринг особине: `entityType`, `id`, и `name` (опционо).
`openInNewWindow`	Омиљено	Не	Означава да ли да се прикаже формулар у новом прозору или новој картици. Ако специфицирате `true` и не специфицирате вредности за висину или ширину, образац се приказује у новој картици. Отварање обрасца у новом прозору или новом табу чини приказивање обрасца спорим у поређењу са отварањем обрасца на истој картици; размислите о отварању обрасца у главном дијалогу форме уместо тога. Ова особина тренутно није подржана за обрасце за брзо креирање, јер се не могу отворити у новом прозору или картици.
`height`	Број	Не	Висина прозора обрасца који ће бити приказан у пикселима. Захтева доношење `openInNewWindow` параметра као истинито.
`width`	Број	Не	Ширина прозора обрасца који ће бити приказан у пикселима. Захтева доношење `openInNewWindow` параметра као истинито.
`navbar`	String	Не	Контролише да ли је навигациона трака приказана и да ли је навигација апликација доступна коришћењем подручја и подподручја дефинисаних у мапи сајта. Важеће вредности су: `on`, `off`, или `entity`. Захтева проношење опенИнНеwWиндоw параметар као истинит. - `on`: Приказује се трака за навигацију. Ово је подразумевано понашање ако се не користи параметар навигацијске траке. - `off`: Трака за навигацију се не приказује. Људи могу да се крећу користећи друге елементе корисничког интерфејса или дугмад назад и напред. - `entity`: На обрасцу су доступне само опције навигације за сродне табеле. Након навигације до сродне табеле, дугме за повратак се приказује на траци за навигацију како би се омогућио повратак на оригинални запис.
`relationship`	Објекат	Не	Дефинишите објекат односа за приказ повезаних записа на обрасцу. Погледајте објекат односа
`selectedStageId`	String	Не	ИД изабране фазе у инстанци пословног процеса.
`useQuickCreateForm`	Омиљено	Не	Означава да ли да се отвори образац за брзо креирање. Табела мора имати омогућену опцију Дозволи брзо креирање да би се приказао образац за брзо креирање, а такође морате додати табелу и образац за брзо креирање у вашу апликацију. Ако не специфицирате вредност , `useQuickCreateForm` подразумевано је подешено на `false`.

Објекат односа

Објекат има следеће вредности.

Именуј	Тип	Опис
`attributeName`	String	Назив колоне која се користи за однос.
`name`	String	Назив колоне која се користи за однос.
`navigationPropertyName`	String	Назив колоне која се користи за однос.
`relationshipType`	Број	Тип односа. Наведите једну од следећих вредности: - 0:ОнеТоМани - 1:МанyТоМанy
`roleType`	Број	Тип улоге у вези. Наведите једну од следећих вредности: - 1:Референцирање - 2:УдружењеЕнтитет

Напомене

Морате користити овај метод да бисте отворили табелу или брзо креирали обрасце уместо застарелих метода Кстрм.Утилити.опенЕнтитyФорм и Кстрм.Утилити.опенКуицкЦреате .

Користите сетАцтивеПроцесс да прикажете одређени пословни процес и сетАцтивеПроцессИнстанце да прикажете одређену инстанцу пословног процеса на обрасцу.

Примери

Пример КСНУМКС: Отворите образац за постојећи запис

Следећи узорак кода отвара контакт формулар за приказ постојећег записа контакта:

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);
    });

Пример КСНУМКС: Отворите формулар за нови запис (сложена претрага)

Следећи узорак кода отвара образац активности са неким унапред попуњеним вредностима (укључујући сложену претрагу) да бисте креирали нови запис:

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);
    });

Пример КСНУМКС: Отворите образац за брзо креирање

Следећи узорак кода отвара образац за брзо креирање контакта са неким унапред попуњеним вредностима:

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);
    });

Српскохрватски / српскохрватски

Повратне информације

Да ли је ова страница била од помоћи?

Last updated on 2025-10-04