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 inprimaki nagusia elkarrizketa-koadro batean, bezeroaren APIa erabiliz

Sintaxia

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

Parametroak

Eman izena	Mota	Beharrezkoa	Deskribapenak
entityFormOptions	Objektua	Bai	Inprimakia irekitzeko inprimakiaren aukerak. Ikusi entityFormOptions objektua
formParameters	Objektua	Ez	Hiztegiaren objektua, formularioari parametro gehigarriak pasatzen dizkionak. Parametro baliogabeek errorea eragiten 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	Ez	Erregistroa sorkuntza azkarreko inprimakian gordetzean exekutatu beharreko funtzioa. Funtzio honek objektu bat onartzen du 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	Ez	Eragiketan akats bat gertatzen denean egiten den funtzioa.

entityFormOptions objektua

Objektuak honako balio hauek ditu:

Eman izena	Mota	Beharrezkoa	Deskribapenak
entityName	String	Bai	Inprimakia bistaratzeko taularen izen logikoa.
entityId	String	Ez	Inprimakia bistaratzeko taulako erregistroaren IDa.
formId	String	Ez	Bistaratu beharreko inprimakiaren instantziaren IDa.
cmdbar	Bool	Ez	Adierazi komandoen barra erakutsi behar den. Parametro hau zehazten ez baduzu, komando-barra bistaratuko da lehenespenez. Parametroa true gisa pasatzea openInNewWindow eskatzen du.
createFromEntity	Bilaketa	Ez	Mapatutako zutabe-balioetan oinarritutako balio lehenetsiak ematen dituen erregistro bat izendatzen du. Bilaketa-objektuak String propietate hauek ditu: entityType, id, eta name (aukerakoa).
openInNewWindow	Bool	Ez	Inprimakia leiho berri batean edo fitxa berri batean bistaratuko den adierazten du. Altuera edo zabaleraren balioak zehazten true badituzu eta ez badituzu zehazten, inprimakia fitxa berri batean bistaratuko da. Inprimaki bat leiho berri batean edo fitxa berri batean irekitzeak inprimakiaren errendatzea moteldu egiten du, 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	Ez	Pixeletan erakutsiko den formularioaren altuera. Parametroa true gisa pasatzea openInNewWindow eskatzen du.
width	Zenbakia	Ez	Pixeletan erakutsiko den formularioaren leihoa. Parametroa true gisa pasatzea openInNewWindow eskatzen du.
navbar	String	Ez	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. - off: Nabigazio-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	Ez	Definitu erlazio-objektu bat erlazionatutako erregistroak inprimakian bistaratzeko. Ikusi erlazio-objektua
selectedStageId	String	Ez	Negozio-prozesuaren instantzian hautatutako fasearen IDa.
useQuickCreateForm	Bool	Ez	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. Ez baduzu zehazten useQuickCreateForm, balio lehenetsia false.

Erlazio-objektua

Objektuak honako balioak ditu.

Eman 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.Navigation