Asenna paketteja Package Deployerin ja Windows PowerShellin avulla
Microsoft Dynamics CRM Package Deployerin avulla järjestelmänvalvojat voivat ottaa paketteja käyttöön ympäristössä.
Muistiinpano
Package Deployer toimii myös Dynamics 365 Customer Engagement (on-premises) -organisaatioiden kanssa.
"Paketti" voi sisältää minkä tahansa tai kaikki seuraavista toimista:
Yhden tai useamman Dataverse ratkaisutiedoston.
Vakiotiedostot tai määrityksen siirtotyökalun viedyt datatiedostot. Lisätietoja määrityksen siirtotyökalusta on ohjeaiheessa Määritystietojen hallinta.
Mukautettua koodia, joka voidaan suorittaa paketin ympäristöön käyttöönoton aikana tai sen jälkeen.
HTML-sisältö, joka sisältyy tiettyyn pakettiin ja joka voidaan näyttää paketin käyttöönoton alussa ja lopussa. Tämä voi olla hyödyllistä, jotta saadaan tarjottua kuvaus ratkaisuista ja tiedostoista, jotka on otettu käyttöön paketissa.
Kehittäjät voivat luoda paketteja käyttämällä paketin käyttöönottomallia sovelluksessa Visual Studio. Lisätietoja: Package Deployer -pakettien luominen
Kun paketti on luotu, voit ottaa sen käyttöön joko suorittamalla CRM:n Package Deployerin tai käyttämällä työkalun Windows PowerShellin cmdlet-komentoja
Tärkeä
Ennen kuin tuot ja suoritat paketin tuotanto-organisaatiossa, testaa paketti tuotanto-organisaation ei-tuotannollisessa peilikuvassa.
Tee aina tuotanto-organisaation varmuuskopio ennen paketin käyttöönottoa.
Paketin käyttöönotto Package Deployer-työkalun avulla
Voit ottaa paketit käyttöön Package Deployer -työkalun avulla (packagedeployer.exe) seuraavasti.
Pakettien käyttöönotto CRM-työkalun Package Deployer avulla
CRM-työkalun Package Deployer käyttäminen komentorivillä
Ota paketit käyttöön Package Deployer -työkalun avulla
Tämä Package Deployer -työkalu voi käsitellä kerrallaan vain yhden paketin. Kuitenkin se tarjoaa käyttäjille mahdollisuuden valita käyttöön otettavan paketin monista käytettävissä olevista paketeista Package Deployer -työkalukansiossa. Jotkin näytöt ja toiminnot työkalussa eroavat paketin kuvauksen perusteella. Sinun ei tarvitse asentaa Package Deployer -työkalua. Voit vain ladata ja suorittaa sen.
Hanki paketti käyttöön otettavaksi. Paketti on kokoelma tiedostoja ja kansioita, jotka on luotu Visual studio -projektin kansioon (<Project>\Bin\Debug), kun muodostat projektin Visual Studiossa. Kopioi seuraava projektin debug-kansiosta:
<PackageName-kansio> : Tämä kansio sisältää paketin ratkaisut, tuontimääritykset ja sisällön.
<PackageName.DLL>: Kokoonpano sisältää paketin koodin. Kokoonpanon nimi on oletusarvon mukaan sama kuin Visual Studio projektin nimi.
Lisätietoja paketin rakentamisesta Visual Studio -sovelluksella on kohdassa Pakettien luominen Package Deployer -työkalulla.
Tässä ohjeaiheessa oletetaan, että pakettikansio ja kokoonpano kopioidaan Visual Studio -projektin debug-kansiosta (<Project>\Bin\Debug)
c:\DeployPackage-kansioon.
Hanki Package Deployer -työkalu. Package Deployer -työkalu on saatavilla NuGet-pakettina. Voit käyttää Package Deployer -työkalua lataamalla ja purkamalla paketin tietokoneeseesi käyttämällä nuget.exe-tiedostoa.
Lataa nuget.exe osoitteesta https://www.nuget.org/downloads ja tallenna se tietokoneeseen, esimerkiksi polkuun d:\. Seuraavaksi voit purkaa paketin sisällön tietokoneesi kansioon (esimerkiksi PD) suorittamalla komentokehotteessa seuraavan komennon:d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
Kun olet purkanut Package Deployer -työkalun, siirry kansioon[ExtractedLocation]\tools, josta löydät PackageDeployer.exe-tiedoston.Kopioi paketin kansio ja kokoonpano kansiosta
c:\DeployPackagekansioon[ExtractedLocation]\tools.Kun tiedostot on kopioitu, suorita työkalu kaksoisnapsauttamalla
PackageDeployer.exe-tiedostoa[ExtractedLocation]\tools-kansiossa.Valitse Jatka työkalun pääikkunassa.
Anna Muodosta yhteys Microsoft Dynamics 365 for Customer Engagementiin -näytössä todennustiedot, joiden avulla muodostetaan yhteys Dynamics 365 Serveriin, jossa haluat ottaa paketin käyttöön. Jos CRM-palvelimella on useita organisaatioita ja haluat valita organisaation, jolle paketti otetaan käyttöön, valitse Näytä aina käytettävissä olevien organisaatioiden luettelo -valintaruutu. Valitse Kirjaudu.
Jos Dynamics 365 Serverissä on useita organisaatioita, valitse se Dynamics 365 -sovellusten organisaatio, johon haluat muodostaa yhteyden.
Valitse käyttöönotettava paketti ja valitse sitten Seuraava.
Noudata seuraavien näyttöjen ohjeita paketin käyttöönoton viimeistelemiseksi.
Näytöt tulevat näkyviin käyttöönottoa varten valitsemasi paketin perusteella. Lisätietoja kokonaisvaltaisesta, Package Deployer -työkalua käyttävästä paketin käyttöönotosta on Unified Service Desk -pakettien käsittelevässä aiheessa: Unified Service Desk -mallisovellusten ottaminen käyttöön CRM-palvelimella Package Deployerin avulla
Käytä Package Deployer -työkalua komentorivillä
Järjestelmänvalvojat ja mukauttajat voivat siirtää parametreja, kuten alueellisen kielikoodin packagedeployer.exe -tiedostoon komentoriviltä. Nämä parametrit voidaan määrittää vain suorittamalla Package Deployer -työkalu komentorivillä.
Muistiinpano
Tämä ominaisuus otettiin ensin käyttöön Dynamics CRM Online 2016 Update 0.1 -versiossa.
Käytettävät parametrit ovat tässä taulukossa.
| Parametri | Description | Oletusarvo |
|---|---|---|
| RuntimePackageSettings | Määrittää packagedeployer.exe -tiedoston hyväksymään komentoriviparametrit kuten LCID ja SkipChecks. | Ei käytettävissä |
| LCID=localeID | Määrittää aluekohtaisten asetusten tunnusten arvot, kuten 1033, jos kyseessä on englanti – Yhdysvallat tai 1036 ranska – Ranska paketin käytettävissä olevista aluekohtaisen asetusten tunnusten arvosta. Jos tätä ei määritetä, käytetään oletuskieltä. | Käytä oletuskieltä |
| SkipChecks=tosi/epätosi | Tätä parametria pitää käyttää vain, kun kohdeympäristö ei sisällä muita ratkaisuja tai mukautuksia. Kun arvo on tosi, ratkaisun tuominen ohittaa joitakin turvallisuustarkistuksia, jotka voivat nopeuttaa tuontia. | Epätosi |
Seuraava esimerkki ohjaa CRM Package Deployerin ohittamaan joitakin turvallisuustarkistuksia ja määrittää tuotavaksi kieleksi puolan.
packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"
Muistiinpano
Erota parametrit pystyviivalla |, kun packagedeployer.exe suoritetaan komentorivillä, jolla on useita parametreja.
Lisätietoja parametreista ja arvoista, jotka voidaan siirtää packagedeployer.exe-tiedostoon, on kohdassa Pakettien luominen CRM Package Deployer -työkalulla.
Asenna paketteja Windows PowerShellin avulla
Package Deployer -työkalu tukee myös Windows PowerShelliä pakettien käyttöönotossa. Lisätietoja: Paketin käyttöönottomoduulin käytön aloittaminen
Vianhakupaketin käyttöönotto-ongelmien vianmääritys lokitiedostojen avulla
Package Deployer -työkalulla saa tarkkoja tietoja virheistä, joita on tapahtunut kirjauduttaessa Microsoft Dynamics 365 for Customer Engagement -esiintymään käyttämällä työkalu- ja käyttöönottopaketteja. Oletusarvon mukaan työkalu luo kolme lokitiedostoa, jotka ovat käytettävissä seuraavassa sijainnissa tietokoneessa, jossa suoritat työkalun: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Voit määrittää eri kansion käyttämällä PowerShell-cmdlet-parametria -LogWriteDirectory. Lisätietoja: Pakettien noutaminen cmdlet-komennon avulla
Login_ErrorLog.log: Sisältää tietoja ongelmista, jotka ilmenivät, kun kirjauduit työkalun avulla Dynamics 365 esiintymään. Jos kirjautumisessa on ongelmia, työkalun kirjautumisikkunaan avautuu sanoma, jossa on linkki tähän kirjautumistiedostoon. Sanoman mukaan kirjautumispyynnön käsittelyn aikana tapahtui virhe, ja käyttäjä voi katsella virhelokia. Voit tarkastella tätä lokitiedostoa viestin linkkiä napsauttamalla. Lokitiedosto luodaan, kun työkalussa ilmenee ensimmäisen kerran ongelmia kirjautumisen aikana. Lokitiedostoa käytetään tämän jälkeen merkitsemään kirjautumisen aikaisia virheitä aina, kun sellaista tapahtuu.PackageDeployer.log: Antaa yksityiskohtaisia tietoja jokaisesta työkalussa pakettien käyttöönoton aikana suoritetusta tehtävästä. Voit tarkastella työkalun lokitiedostoa napsauttamalla Näytä lokitiedosto -linkkiä näytön alareunassa.ComplexImportDetail.log: Sisältää yksityiskohtaisia tietoja työkalun viimeisimmässä käyttöönotossa tuoduista tiedoista. Aina kun otat käyttöön paketin työkalua käyttäen, lokitiedostossa olevat tiedot siirretään samassa kansiossa olevaan ComplexImportDetail._old.log-tiedostoon. ComplexImportDetail.log-tiedosto sisältää työkalulla viimeksi tehdyn tuontityön tiedot.
Pakettien käyttöönoton parhaat käytännöt
Pakettien käyttöönoton aikana Dynamics 365 -järjestelmänvalvojien on tehtävä seuraavat:
Varmistaa paketin kokoonpanon allekirjoitus niin, että he voivat seurata kokoonpanoa takaisin sen lähteeseen.
Testata pakettia esituotannon esiintymässä (mieluiten peilatussa tuotantoesiintymässä) ennen sen suorittamista tuotantopalvelimella.
Varmuuskopioi tuotantoesiintymä ennen paketin käyttöönottoa.