openForm (Bezeroaren APIaren erreferentzia)

Ireki entitate-inprimaki bat edo sortze azkarreko formulario bat.

Oharra

Inprimaki nagusi bat elkarrizketa-koadro gisa irekitzeko, erabili navigateTo metodoa. Informazio gehiago: Ireki formulario nagusia elkarrizketa-koadro batean bezeroaren APIa erabiliz

Sintaxia

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

Parametroak

Izena	Mota	Beharrezkoa	Deskribapenak
entityFormOptions	Objektua	Yes	Inprimakia irekitzeko inprimakiaren aukerak. Ikusi entityFormOptions objektua
formParameters	Objektua	No	Hiztegiaren objektua, formularioari parametro gehigarriak pasatzen dizkionak. Baliozkoak ez diren parametroek akatsa eragingo dute. Parametroak inprimaki bati pasatzeari buruzko informazioa nahi izanez gero, ikus Ezarri zutabe-balioak inprimaki bati pasatutako parametroak erabiliz eta Konfiguratu inprimaki bat kontsulta-katearen parametro pertsonalizatuak onartzeko.
successCallback	Function	No	Erregistroa sorkuntza azkarreko inprimakian gordetzean exekutatu beharreko funtzioa. Funtzio honi objektu bat ematen zaio parametro gisa. Objektuak propietate hauek dituen matrize bat savedEntityReference du, bistaratutako edo sortutako erregistroak identifikatzeko: - entityTypeTaularen izen logikoa. - id: Erregistroaren GUID balio baten kate-irudikapena. - name: bistaratutako edo sortutako erregistroaren zutabe-balio nagusia. OHARRA: - Funtzioa successCallback ez da exekutatzen lehendik dagoen edo erregistro berri baten inprimaki bat irekitzen duzunean. - Funtzioa successCallback erregistro bat openForm metodoa erabiliz irekitako sorkuntza azkarreko inprimaki batean gordetzen duzunean bakarrik exekutatzen da.
errorCallback	Function	No	Eragiketan akats bat gertatzen denean egiten den funtzioa.

entityFormOptions objektua

Objektuak honako balio hauek ditu:

Izena	Mota	Beharrezkoa	Deskribapenak
entityName	String	Yes	Inprimakia bistaratzeko taularen izen logikoa.
entityId	String	No	Inprimakia bistaratzeko taulako erregistroaren IDa.
formId	String	No	Bistaratu beharreko inprimakiaren instantziaren IDa.
cmdbar	Bool	No	Adierazi komandoen barra erakutsi behar den. Parametro hori zehazten ez badu, komandoen barra aurrez zehaztuta agertzen da. Parametroa true gisa pasatzea openInNewWindow eskatzen du.
createFromEntity	Bilaketa	No	Mapatutako zutabe-balioetan oinarritutako balio lehenetsiak emango dituen erregistro bat izendatzen du. Bilaketa-objektuak String propietate hauek ditu: entityType, id, eta name (aukerakoa).
openInNewWindow	Bool	No	Inprimakia leiho berri batean edo fitxa berri batean bistaratuko den adierazten du. Altuera edo zabaleraren balioak zehazten true badituzu eta ez badituzu, inprimakia fitxa berri batean bistaratuko da. Inprimaki bat leiho berri batean edo fitxa berri batean irekitzean inprimakiaren errendatzea moteldu egiten da inprimakia fitxa berean irekitzearekin alderatuta. Horren ordez, inprimaki bat ireki behar da inprimakiaren elkarrizketa-koadro nagusian. Propietate hau ez onartzen Sortzen azkarreko inprimakietan, ezin baitira leiho edo fitxa berri batean ireki.
height	Zenbakia	No	Pixeletan erakutsiko den formularioaren altuera. Parametroa true gisa pasatzea openInNewWindow eskatzen du.
width	Zenbakia	No	Pixeletan erakutsiko den formularioaren leihoa. Parametroa true gisa pasatzea openInNewWindow eskatzen du.
navbar	String	No	Kontrolatu nabigazio-barra erakusten den eta aplikazioaren nabigazioa gunearen mapan definitutako eremu eta azpiaordeen bidez eskuragarri dagoen. Baliozko balioak hauek dira: on, off, edo entity. openInNewWindow parametroa true gisa pasatzea eskatzen du. - onNabigazio-barra bistaratzen da. Portaera lehenetsia da nabigazio-barraren parametroa erabiltzen ez bada. - offNabigazio-barra ez da bistaratzen. Pertsonek erabiltzailearen interfazearen beste elementu batzuk edo Atrás eta Adelante botoiak erabiliz nabiga dezakete. - entity: Inprimaki batean, erlazionatutako taulen nabigazio-aukerak soilik daude erabilgarri. Erlazionatutako taula batera nabigatu ondoren, atzera botoi bat bistaratuko da nabigazio-barran jatorrizko erkora itzultzeko.
relationship	Objektua	No	Definitu erlazio-objektu bat erlazionatutako erregistroak inprimakian bistaratzeko. Ikusi erlazio-objektua
selectedStageId	String	No	Negozio-prozesuaren instantzian hautatutako fasearen IDa.
useQuickCreateForm	Bool	No	Sortzen azkarreko inprimakia irekiko den ala ez adierazten du. Taulak Baimendu sorkuntza azkarra aukera gaituta eduki behar du sorkuntza azkarreko inprimakia bistaratzeko, eta taula eta sorkuntza azkarreko inprimakia ere gehitu behar dizkiozu aplikazioari. , balioa useQuickCreateFormzehazten ez baduzu, lehenetsia honela falseezarriko da.

Erlazio-objektua

Objektuak honako balioak ditu.

Izena	Mota	Deskribapenak
attributeName	String	Erlaziorako erabilitako zutabearen izena.
name	String	Erlaziorako erabilitako zutabearen izena.
navigationPropertyName	String	Erlaziorako erabilitako zutabearen izena.
relationshipType	Zenbakia	Harreman mota. Zehaztu balio hauetako bat: - 0:OneToMany - 1:ManyToMany
roleType	Zenbakia	Rol mota harremanetan. Zehaztu balio hauetako bat: - 1:Erreferentziak - 2:AssociationEntity

Oharrak

Metodo hau erabili behar duzu taula irekitzeko edo inprimakiak azkar sortzeko, Xrm.Utility.openEntityForm eta Xrm.Utility.openQuickCreate metodoen ordez.

Erabili setActiveProcess negozio-prozesu jakin bat bistaratzeko, eta setActiveProcessInstance negozio-prozesuaren instantzia jakin bat inprimakian bistaratzeko.

Adibideak

1. adibidea: Ireki lehendik dagoen erregistrorako inprimakia

Ondorengo adibide-kodeak kontaktu-inprimaki bat irekitzen du lehendik dagoen kontaktu-erregistroa bistaratzeko:

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. adibidea: Ireki inprimakia erregistro berrirako

Ondorengo adibide-kodeak kontaktu-inprimaki bat irekitzen du aurrez betetako balio batzuekin, erregistro berri bat sortzeko:

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. adibidea: Ireki erregistro berrirako inprimakia (bilaketa konplexua)

Ondorengo adibide-kodeak jarduera-inprimaki bat irekitzen du aurrez betetako balio batzuekin (bilaketa konplexu bat barne) erregistro berri bat sortzeko:

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. adibidea: Ireki sorkuntza azkarreko inprimakia

Ondorengo adibide-kodeak sorkuntza azkarreko kontaktu-inprimakia irekitzen du, aurrez betetako balio batzuekin:

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

Erlazionatutako artikuluak

Xrm.nabigazioa