Atsiliepimai

Sprendimo pakavimo įrankis

  • Straipsnis
  • 7 min. skaityti

„SolutionPackager“ yra įrankis, kuris gali suglaudintą „Microsoft Dataverse“ sprendimo failą išskaidyti į kelis XML ir kitokius failus, kad juos galėtų lengviau valdyti pirminio teksto valdymo sistema. Tolesniuose skyriuose aprašyta, kaip paleisti įrankį ir kaip naudoti įrankį su valdomaisiais ir nevaldomaisiais sprendimais.

Kur ieškoti „SolutionPackager“ įrankio

„SolutionPackager“ įrankis platinamas kaip Microsoft.CrmSdk.CoreTools „NuGet“ paketo dalis. Informacijos, kaip atsisiųsti, žr. Įrankių atsisiuntimas iš „NuGet“.

„SolutionPackager“ komandų eilutės argumentai

„SolutionPackager“ yra komandų eilutės įrankis, su kuriuo galima naudoti toliau pateiktoje lentelėje nurodytus parametrus.

Argumentas Aprašas
/action: {Extract|Pack} Būtina. Atliekamas veiksmas. Veiksmas gali būti sprendimo .zip failo išskleidimas aplanke arba aplanko supakavimas į .zip failą.
/zipfile: <file path> Būtina. Sprendimo. zip failo kelias ir pavadinimas. Išskleidžiant turi egzistuoti failas, iš kurio bus skaitoma. Pakuojant, failas pakeičiamas.
/folder: <folder path> Būtina. Kelias į aplanką. Išskleidžiant, šis aplankas sukuriamas ir užpildomas failais. Pakuojant, šis aplankas turi egzistuoti ir jame turi būti prieš tai gauti komponentų failai.
/packagetype: {Unmanaged|Managed|Both} Pasirenkama. Apdorojamo proceso tipas. Numatytoji reikšmė yra „Nevaldomas“. Šį argumentą daugeliu atveju galima praleisti, nes paketo tipą galima nustatyti iš .zip failo arba komponento failų. Išskleidžiant ir nurodžius „Abu“, turi būti valdomojo ir nevaldomojo sprendimo .zip failai, kurie apdorojami viename aplanke. Pakuojant ir nurodžius „Abu“, valdomojo ir nevaldomojo sprendimo .zip failai bus gauti iš vieno aplanko. Daugiau informacijos žr. toliau esančiame šios temos skyriuje apie darbą su valdomaisiais ir nevaldomaisiais sprendimais.
/allowWrite:{Yes|No} Pasirenkama. Numatytoji reikšmė yra Taip. Šis argumentas naudojamas tik išskleidžiant. Kai nurodyta /allowWrite:No, įrankis atlieka visas operacijas, bet negali rašyti arba panaikinti jokių failų. Skleidimo operacija gali būti patikimai atlikta neperrašant arba nepanaikinant esamų failų.
/allowDelete:{Yes|No|Prompt} Pasirenkama. Numatytoji reikšmė yra „Prompt“. Šis argumentas naudojamas tik išskleidžiant. Kai nurodyta /allowDelete:Yes, visi aplanke, nurodytame parametru /folder esantys failai, kurių neturi būti, yra automatiškai panaikinami. Kai nurodyta /allowDelete:No, naikinimas nebus atliekamas. Kai nurodyta /allowDelete:Prompt, vartotojas informuojamas konsolėje ir gali leisti arba uždrausti visus naikinimo veiksmus. Atkreipkite dėmesį, kad jei nurodyta /allowWrite:No, naikinimas nebus atliekamas, net jei nurodyta /allowDelete:Yes.
/clobber Pasirenkama. Šis argumentas naudojamas tik išskleidžiant. Kai nurodyta /clobber, failai, turintys sukonfigūruotą tik peržiūros atributą, yra perrašomi arba panaikinami. Kai nenurodyta, failai, turintys sukonfigūruotą tik peržiūros atributą, nėra perrašomi arba panaikinami.
/errorlevel: {Off|Error|Warning|Info|Verbose} Pasirenkama. Numatytoji reikšmė yra „Informacija“. Šis argumentas nurodo išvedamos informacijos registravimo lygį.
/map: <file path> Pasirenkama. .xml failo, kuriame yra failo susiejimo direktyvos, kelias ir pavadinimas. Naudojant išskleidimo metu, failai, kurie yra paprastai skaitomi iš aplanko, nurodyto /folder parametru, nuskaitomi iš alternatyvių vietų nurodytų susiejimo faile. Pakavimo metu į failus, atitinkančius sąlygas, nėra rašoma.
/nologo Pasirenkama. Vykdymo metu nerodyti juostos.
/log: <file path> Pasirenkama. Žurnalo failo kelias ir pavadinimas. Jei failas jau yra, nauja registracijos informacija pridedama prie failo.
@ <file path> Pasirenkama. Failo, kuriame yra įrankio komandų eilutės argumentai, kelias ir vardas.
/sourceLoc: <string> Pasirenkama. Šis argumentas generuoja šablono ištekliaus failą ir galioja tik išskleidžiant.

Galimos reikšmės yra auto arba kalbos, kurią norite eksportuoti, LCID/ISO kodas. Naudojant šį argumentą, eilutės ištekliai iš nurodytos lokalės išskleidžiami kaip neutralus .resx failas. Jei nurodyta auto arba tik ilga ar trumpa jungiklio forma, naudojama bazinė lokalė arba sprendimas. Galite naudoti trumpą komandos formą: /src.
/localize Pasirenkama. Visus eilutės išteklius išskleisti arba sulieti į .resx failus. Galite naudoti trumpą komandos formą: /loc. Lokalizavimo parinktis palaiko .resx failų bendrai naudojamus komponentus. Daugiau informacijos: RESX žiniatinklio išteklių naudojimas

/map komandos argumento naudojimas

Toliau aptarta, kaip naudoti /map argumentą su „SolutionPackager“ įrankiu.

Failai, sukurti naudojant automatinio kūrimo sistemą, pvz., .xap „Silverlight“ failai ir priedų rinkiniai, paprastai neregistruojami pirminio teksto valdymo sistemoje. Žiniatinkio ištekliai gali būti pirminio teksto valdymo sistemos vietose, kurios nėra tiesiogiai suderinamos su „SolutionPackager“ įrankiu. Įtraukus parametrą /map, „SolutionPackager“ įrankis gali būti nukreiptas, kad skaitytų ir pakuotų tokius failus iš alternatyvių vietų, o ne iš išskleidimo aplanko, kaip tai daroma įprastai. Į parametrą /map reikia įtraukti vardą ir kelią XML failo, kuriame yra susiejimo sąlygos, nurodančios „SolutionPackager“ susieti failus pagal vardą ir kelią, bei nurodyti alternatyvią vietą, kurioje galima rasti susietą failą. Toliau pateikta informacija vienodai taikoma visoms sąlygoms.

  • Gali būti įtrauktos kelios sąlygos, įskaitant tas, kurias atitinka vienodi failai. Sąlygoms, kurios faile yra nurodytos anksčiau, taikomas didesnis prioritetas vėliau nurodytų sąlygų atžvilgiu.

  • Jei failas yra atitinka bet kurią sąlygą, jis turi būti randamas bent vienoje alternatyvioje vietoje. Jei nerasta atitinkamų alternatyvų, „SolutionPackager“ praneš apie klaidą.

  • Aplanko ir failo keliai gali būti absoliutūs arba santykiniai. Santykiniai keliai visada gaunami pagal aplanką, nurodytą naudojant parametrą /folder.

  • Aplinkos kintamuosius galima nurodyti naudojant %variable% sintaksę.

  • Aplankas su pakaitos simboliu „**“ gali reikšti „bet kuriame poaplankyje“. Jį galima naudoti tik kaip galutinę kelio dalį, pvz., „c:\folderA\**“.

  • Failo vardo pakaitos simbolius galima naudoti tik „*.ext arba „*.*“ formose. Nepalaikomas jos kitas šablonas.

    Čia aprašyti trijų tipų sąlygų susiejimai ir pateiktas pavyzdys, rodantis, kaip juos naudoti.

Aplanko susiejimas

Toliau pateikta išsami informacija apie aplanko susiejimą.

Xml formatas

<Folder map="folderA" to="folderB" />

Aprašas

Failo keliai, atitinkantys „folderA“, bus pakeisti į „folderB“.

  • Visų poaplankių hierarchijos turi tiksliai sutapti.

  • Aplankų pakaitos simboliai nepalaikomi.

  • Negalima nurodyti failų vardų.

    Pavyzdžiai

    <Folder map="folderA" to="folderB" />  
<Folder map="folderA\folderB" to="..\..\folderC\" />  
<Folder map="WebResources\subFolder" to="%base%\WebResources" />

Failo susiejimas su failu

Toliau pateikta išsami informacija apie failo susiejimą su failu.

Xml formatas

<FileToFile map="path\filename.ext" to="path\filename.ext" />

Aprašas

Bet kuris failas, atitinkantis parametrą map, bus nuskaitytas naudojant vardą ir kelią, nurodytą parametre to.

Parametras map:

  • Turi būti nurodytas failo vardas. Kelias yra pasirinktinis. Jei kelias nenurodytas, gali būti susieti failai iš bet kurio aplanko.

  • Failo vardo pakaitos simboliai nepalaikomi.

  • Palaikomi aplanko pakaitos simboliai.

    Parametras to:

  • Turi būti nurodytas failo vardas ir kelias.

  • Failo vardas gali skirtis nuo parametro map vardo.

  • Failo vardo pakaitos simboliai nepalaikomi.

  • Palaikomi aplanko pakaitos simboliai.

Pavyzdžiai

  <FileToFile map="assembly.dll" to="c:\path\folder\assembly.dll" />  
  <FileToFile map="PluginAssemblies\**\this.dll" to="..\..\Plugins\**\that.dll" />  
  <FileToFile map="Webresrouces\ardvark.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\aardvark.jpg" />

Failo susiejimas su keliu

Toliau pateikta išsami informacija apie failo susiejimą su keliu.

Xml formatas

<FileToPath map="path\filename.ext" to="path" />

Aprašas

Bet kuris failas, atitinkantis parametrą map, bus nuskaitomas naudojant kelią, nurodytą parametre to.

Parametras map:

  • Turi būti nurodytas failo vardas. Kelias yra pasirinktinis. Jei kelias nenurodytas, gali būti susieti failai iš bet kurio aplanko.

  • Failo vardo pakaitos simboliai palaikomi.

  • Palaikomi aplanko pakaitos simboliai.

Parametras to:

  • Turi būti nurodytas kelias.

  • Palaikomi aplanko pakaitos simboliai.

  • Failo vardas negali būti nurodytas.

    Pavyzdžiai

  <FileToPath map="assembly.dll" to="c:\path\folder" />  
  <FileToPath map="PluginAssemblies\**\this.dll" to="..\..\Plugins\bin\**" />  
  <FileToPath map="*.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\" />  
  <FileToPath map="*.*" to="..\..\%ARCH%\%TYPE%\drop" />

Susiejimo pavyzdys

Toliau esančiame XML kodo pavyzdyje pateiktas visas susiejimo failas, leidžiantis „SolutionPackager“ įrankiui nuskaityti bet kurį žiniatinklio išteklių ir du numatytuosius sugeneruotus rinkinius iš kūrėjo įrankių rinkinio projekto, pavadinto CRMDevTookitSample.

<?xml version="1.0" encoding="utf-8"?>  
<Mapping>  
       <!-- Match specific named files to an alternate folder -->  
       <FileToFile map="CRMDevTookitSamplePlugins.dll" to="..\..\Plugins\bin\**\CRMDevTookitSample.plugins.dll" />  
       <FileToFile map="CRMDevTookitSampleWorkflow.dll" to="..\..\Workflow\bin\**\CRMDevTookitSample.Workflow.dll" />  
       <!-- Match any file in and under WebResources to an alternate set of sub-folders -->  
       <FileToPath map="WebResources\*.*" to="..\..\CrmPackage\WebResources\**" />  
       <FileToPath map="WebResources\**\*.*" to="..\..\CrmPackage\WebResources\**" />  
</Mapping>

Valdomieji ir nevaldomieji sprendimai

„Dataverse“ suglaudinto sprendimo (.zip) failą galima eksportuoti, kaip pavaizduota, pasirinkus vieną iš dviejų tipų.

Valdomasis sprendimas
Baigtas sprendimas, paruoštas importuoti į organizaciją. Importavus, komponentų negalima įtraukti arba pašalinti, nors jie gali būti pasirinktinai tinkinami. Tai daryti rekomenduojama, kai sprendimo kūrimas baigtas.

Nevaldomasis sprendimas
Atviras sprendimas be apribojimų, ką galima įtraukti, pašalinti ar modifikuoti. Rekomenduojama naudoti kuriant sprendimą.

Suglaudinto sprendimo failo formatas bus skirtingas, atsižvelgiant į tipą, t. y. valdomąjį arba nevaldomąjį. „SolutionPackager“ gali apdoroti bet kokio tipo suglaudintų sprendimų failus. Tačiau įrankis negali konvertuoti vieno tipo į kitą. Vienintelis būdas konvertuoti sprendimo failus į kitą tipą, pvz., iš nevaldomojo į valdomąjį, yra importuoti nevaldomojo sprendimo .zip failą į „Dataverse“ serverį, o tada eksportuoti sprendimą kaip valdomąjį sprendimą.

Naudojant parametrą /PackageType:Both, „SolutionPackager“ gali apdoroti nevaldomųjų ir valdomųjų sprendimų .zip failus kaip rinkinį. Norint atlikti šią operaciją, skirtingo tipo sprendimą reikia eksportuoti du kartus, suteikiant .zip failams nurodytus pavadinimas.
Nevaldomojo sprendimo .zip failas: AnyName.zip Valdomojo sprendimo .zip failas: AnyName_managed.zip

Įrankis remsis prielaida, kad valdomojo sprendimo .zip failai yra tame pačiame aplanke kaip ir nevaldomojo sprendimo, ir išskleis abu failus į vieną aplanką, išsaugant skirtumus, kai yra valdomieji ir nevaldomieji komponentai.

Išskleidus sprendimą kaip nevaldomąjį ir valdomąjį, naudojant parametrą /PackageType, kuriame nurodoma, kokį tipą sukurti, šiame vieninteliame aplanke galima supakuoti abu kartu arba atskirai pagal tipą. Nurodžius abu, naudojant prieš tai pateiktas pavadinimų suteikimo taisykles bus sukurti 2 .zip failai. Jei parametro /PackageType nėra, pakuojant dvigubame valdomojo ir nevaldomojo sprendimo aplanke, standartiškai sukuriamas vienas nevaldomasis .zip failas.

Trikčių šalinimas

Jei išteklių failams, kuriuos sukūrė sprendimų pakavimo įrankis, redaguoti naudojate „Visual Studio“, pakuojant iš naujo jums gali būti rodomas pranešimas, panašus į šį: “Failed to determine version id of the resource file <filename>.resx the resource file must be exported from the solutionpackager.exe tool in order to be used as part of the pack process.”. Taip gali įvykti, nes „Visual Studio“ ištekliaus failo metaduomenų žymes pakeičia duomenų žymėmis.

Alternatyvus sprendimas

  1. Atidarykite ištekliaus failą savo mėgstamiausioje teksto rengyklėje ir suraskite bei atnaujinkite šias žymes:

    <data name="Source LCID" xml:space="preserve">  
<data name="Source file" xml:space="preserve">  
<data name="Source package type" xml:space="preserve">  
<data name="SolutionPackager Version" mimetype="application/x-microsoft.net.object.binary.base64">

  2. Mazgo pavadinimą pakeiskite iš <data> į <metadata>.

    Pavyzdžiui, ši eilutė:

    <data name="Source LCID" xml:space="preserve">  
  <value>1033</value>  
</data>

    Pakeičiama į:

    <metadata name="Source LCID" xml:space="preserve">  
  <value>1033</value>  
</metadata>

    Tokiu būdu sprendimų pakavimo įrankis galės perskaityti ir importuoti ištekliaus failą. Su šia problema susidurta tik naudojant „Visual Studio“ išteklių rengyklę.

Taip pat žr.

Pirminio teksto valdymo sistemos naudojimas su sprendimo failais

Sprendimų konceptai

Pastaba

Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)

Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).