Jaa

Paikallisesti rekisteröidyn laajennuksen virheenkorjaus

Yleisiä tietoja laajennuksen virheenkorjauksesta on Dataverse-ohjeaiheessa Laajennuksen virheenkorjaus. Seuraavissa vaiheissa kuvataan, miten Dynamics 365 Customer Engagement (on-premises):ssä suoritettavan laajennuksen virheenkorjaus tehdään.

Huomautus

Vaihtoehtoinen tapa korjata laajennus, joka suoritetaan eristysympäristössä missä tahansa käyttöönottotyypissä, on käyttää jäljityspalvelua. Lisätietoja jäljityksestä on kohdassa Kirjaaminen ja jäljittäminen. Lisätietoja virheenkorjauksesta, mukaan lukien opetusohjelma, on Dataverse-ohjeaiheessa Laajennuksen virheenkorjaus.

 

Laajennuksen virheenkorjaus

  1. Rekisteröi ja ota käyttöön laajennuskokoonpano.

    Jos kokoonpanosta on toinen kopio samassa sijainnissa etkä voi korvata kyseistä kopiota, koska Dynamics 365 Customer Engagement (on-premises) on lukinnut sen, sinun on käynnistettävä uudelleen laajennuksen suorittanut huoltoprosessi. Katso alla olevasta taulukosta oikea huoltoprosessi. Lisätietoja: Laajennusten rekisteröinti ja käyttöönotto

  2. Määritä virheenkorjausohjelma.

    Liitä virheenkorjausohjelma Dynamics 365 Serverin prosessiin, joka suorittaa laajennuksen. Katso seuraavasta taulukosta prosessin tunnistaminen.

    Laajennuksen rekisteröinnin määritys Palveluprosessi
    online w3wp.exe
    offline Microsoft.Crm.Application.Hoster.exe
    Asynkroniset rekisteröidyt laajennukset (tai mukautetut työnkulkukokoonpanot) CrmAsyncService.exe
    Hiekkalaatikko (eristystila) Microsoft.Crm.Sandbox.WorkerProcess.exe

    Jos samaa suoritettavaa tiedostoa on käynnissä useissa prosesseissa, esimerkiksi useita w3wp.exe prosesseja, liitä virheenkorjausohjelma kaikkiin käynnissä olevan suoritettavan prosessin esiintymiin. Aseta seuraavaksi yksi tai useampi keskeytyskohta laajennuskoodiin.

  3. Testaa laajennus.

    Suorita Dynamics 365 Customer Engagement (on-premises) -sovellus tai muu SDK:ta käyttävä mukautettu sovellus ja suorita kaikki tarvittavat toimet laajennuksen suorittamiseksi. Jos laajennus on esimerkiksi rekisteröity tilin luontitapahtumaan, luo uusi tili.

  4. Tee laajennuskoodin virheenkorjaus.

    Tee tarvittavat muutokset koodiin, jotta se toimii haluamallasi tavalla. Jos koodia muutetaan, käännä koodi kokoonpanoksi ja toista tämän menettelyn vaiheet 1–4 tarvittaessa. Jos kuitenkin muutat laajennuskokoonpanon pää- tai aliversionumeroita, sinun on poistettava kokoonpanon aiemman version rekisteröinti ja rekisteröitävä uusi versio. Lisätietoja: Laajennusten rekisteröinti ja käyttöönotto

  5. Rekisteröi laajennus tietokantaan.

    Kun laajennuksen muokkaus-, kääntämis-, käyttöönotto-, testaus- ja virheenkorjausjakso on valmis, poista (levyllä olevan tai GAC) laajennuskokoonpanon rekisteröinti ja rekisteröi laajennus sitten uudelleen Dynamics 365 Customer Engagement (on-premises) -tietokantaan. Lisätietoja: Laajennusten rekisteröinti ja käyttöönotto

Vihje

Tietokannan käyttöön otetun laajennuksen virheenkorjaus on mahdollista. Käännetyn laajennuskokoonpanon symbolitiedosto (.pdb) on kopioitava palvelimen <crm-root>\Server\bin\assembly-kansioon ja Internet Information Services (IIS) on käynnistettävä uudelleen. Kun virheenkorjaus on valmis, sinun on poistettava symbolitiedosto ja palautettava IIS, jotta laajennusta suorittava prosessi ei kuluta lisää muistia.

Lisätietoja laajennuksen virheenkorjauksesta laajennuksen profilointityökalulla on ohjeaiheessa Laajennuksen virheenkorjaus.

Sandbox-laajennuksen virheenkorjaus

On tärkeää suorittaa nämä vaiheet ennen hiekkalaatikkolaajennuksen ensimmäistä suorittamista. Jos laajennus on jo suoritettu, joko muuta kokoonpanon koodia, jolloin kokoonpanon hajautusarvo muuttuu palvelimessa, tai käynnistä Dynamics 365 Customer Engagement (on-premises) -eristyskäsittelypalvelu uudelleen eristyspalvelimessa.

Paikallisen palvelimen määrittäminen

Eristysisäntäprosessi valvoo laajennusta suorittavaa eristystyöprosessia. Isäntäprosessi tarkistaa, lakkaako laajennus vastaamasta, ylittääkö se muistin kynnysarvot ja paljon muuta. Jos työprosessi ei vastaa yli 30 sekuntiin, se suljetaan. Jotta voit korjata eristyslaajennuksen, sinun on poistettava tämä sammutusominaisuus käytöstä. Voit poistaa sammutusominaisuuden käytöstä asettamalla seuraavan rekisteriavaimen arvoksi 1 (DWORD):

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM\SandboxDebugPlugins

Laajennuksen virheenkorjaus

Noudata näitä ohjeita eristyksissä olevan laajennuksen virheenkorjauksessa.

  1. Rekisteröi laajennus eristystilaan (eristystila) ja ota se käyttöön Dynamics 365 Server -tietokannassa.

  2. Kopioi käännetyn laajennuskokoonpanon symbolitiedosto (.pdb) palvelimeen\bin\assembly folder on the server running the sandbox worker process named Microsoft.Crm.Sandbox.WorkerProcess.exe. Tämä on palvelin, joka isännöi Sandbox Processing Service -roolia.

  3. Noudata tämän aiheen alussa esitettyjä vaiheiden 2–4 ohjeita.

    Lisätietoja laajennuksen virheenkorjauksesta laajennuksen profilointityökalulla on ohjeaiheessa Laajennuksen virheenkorjaus.

Katso myös

Laajennusten kehittäminen
Laajennuksen virheenkorjaus
Rekisteröi ja ota käyttöön laajennuksia
Laajennuksen kirjoittaminen