Lisää uusia mukautettuja entiteettilomakkeita (Project Service Automation 2.x)

Tyyppi-kenttä

Dynamics 365 Project Service Automation käyttää Mahdollisuus-, Tarjous-, Tilaus- ja Lasku-entiteettien Tyyppi-kentän (msdyn_ordertype) kenttää erottaakseen näiden entiteettien työpohjaiset versiot kohde- ja palvelupohjaisista versioista. PSA käsittelee näiden entiteettien työpohjaiset versiot. Monet liiketoimintalogiikat ratkaisun asiakaspuolella ja palvelinpuolella määräytyvät Tyyppi-kentän mukaan. Siksi on tärkeää, että kenttä alustetaan oikealla arvolla, kun entiteettejä luodaan. Virheellinen arvo voi aiheuttaa virheellisiä toimintoja ja jotkin liiketoimintalogiikat eivät ehkä toimi oikein.

Automaattinen lomakkeen vaihtaminen

Mahdollisten tietojen vioittumisen ja odottamattoman toiminnan välttämiseksi, joka johtuu myyntientiteetin tietueiden virheellisestä alustamisesta ja muokkaamisesta, PSA sisältää nyt logiikan lomakkeen automaattiselle vaihtamiselle valmiissa lomakkeissa. Tämä logiikka vie käyttäjät oikeaan lomakkeeseen työpohjaisen version tai minkä tahansa muuntyyppisen Mahdollisuus-, Tarjous-, Tilaus- tai Lasku-entiteetin kanssa. Kun käyttäjä avaa Mahdollisuus-, Tarjous-, Tilaus- tai Lasku-entiteetin työpohjaisen version, lomake siirtyy projektitietoihin.

Lomakkeen automaattisen vaihtamisen logiikka perustuu formId-arvon ja msdyn_ordertype -kentän väliseen yhdistämiseen. Kaikki valmiit lomakkeet on lisätty tähän yhdistämismääritykseen. Mukautetut lomakkeet on kuitenkin lisättävä manuaalisesti osoittamaan, mitä entiteetin versiota ne on tarkoitettu käsittelemään. Tämä perustuu msdyn_ordertype kenttään. Jos lomakkeen vaihtaminen puuttuu yhdistämismäärityksestä, logiikka vaihtaa valikkolomakkeeseen entiteetin msdyn_ordertype kentässä tallennetun arvon perusteella.

Lisää mukautettuja lomakkeita ja ota käyttöön lomakkeen vaihtamislogiikka

Seuraavassa esimerkissä näytetään, miten voit lisätä mukautetun Oman projektin tiedot -lomakkeen, jotta se toimii työpohjaisten mahdollisuuksien kanssa. Samaa prosessia käytetään mukautettujen lomakkeiden lisäämiseen niin, että ne toimivat tarjousten, tilausten ja laskujen kanssa.

Näiden ohjeiden avulla voit luoda mukautetun version Projektitiedot-lomakkeesta .

1. Avaa Mahdollisuus-entiteetissä Projektitiedot-lomake ja tallenna kopio nimellä Omat projektitiedot.

2. Avaa uusi lomake ja varmista sitten ominaisuuksissa, että projektin tietolomakkeen lomakkeen alustamiskomentosarjat ovat olemassa.

   Tärkeää

   Älä poista komentosarjoja. Muussa tapauksessa jotkin tiedot voidaan alustaa virheellisesti.

3. Varmista, että lomakkeeseen on lisätty Tyyppi (msdyn_ordertype) -kenttä.

   Tärkeää

   Älä poista tätä kenttää. Muussa tapauksessa alustuskomentosarjat epäonnistuvat.

4. Etsi uuden lomakkeen formId-arvo . Voit suorittaa tämän vaiheen kahdella tavalla:

   • Vie Omat projektitiedot - lomake osana hallitsematonta ratkaisua ja etsi sitten formId-arvo viedyn ratkaisun customization.xml-tiedostosta.
   • Avaa Omat projektitiedot - lomake lomake-editorissa ja etsi sitten GUID-tunnus URL-osoitteen fromId-parametrin vierestä seuraavassa kuvassa esitetyllä tavalla.

   

5. Luo msdyn_ordertype-yhdistämismääritys formId-arvolle muokkaamalla msdyn_/SalesDocument/PSSalesDocumentCustomFormIds.js -verkkoresurssia. Poista koodi resurssista ja korvaa se seuraavalla koodilla.

   define(["require", "exports"], function (require, exports) {
       "use strict";
       var SalesDocumentCustomFormIds = (function () {
           function SalesDocumentCustomFormIds() {
           }
           SalesDocumentCustomFormIds.overwriteFormIds = function (mappedFormIds) {
               /*
               ---- Notes ----
               mappedFormIds[SalesEntity][OrderType] => The array of forms IDs that support particular entity and order type
               Add or overwrite customized formId for the particular entity and order type by calling:
                   mappedFormIds[<EntityType>][<msdyn_ordertype>].push("<formId>");
               Allowed msdyn_ordertype values for reference:
                   ServiceBased: 690970002 (Field Service version of the entity)
                   WorkBased: 192350001 (PSA version of the entity)
                   ItemBased: 192350000 (Regular out of the box entity)
               Uncomment and update one of the following lines to register custom PSA form for required entity:
               */		
               //mappedFormIds[1][192350001].push("<formId>"); //Quote
               //mappedFormIds[5][192350001].push("<formId>"); //Quote Line
               //mappedFormIds[2][192350001].push("<formId>"); //Sales Order
               //mappedFormIds[6][192350001].push("<formId>"); //Sales Order Line
               // In this example we have added new form for Opportunity
               mappedFormIds[0][192350001].push("192EE537-DCC4-45D3-B7AF-EA694B9113D2"); //Opportunity
               //mappedFormIds[4][192350001].push("<formId>"); //Opportunity Line
           };
           return SalesDocumentCustomFormIds;
       }());
       exports.default = SalesDocumentCustomFormIds;
   });
   

6. Tallenna ja julkaise mukautukset.