pac solution

Dataverse irtenbide-proiektuekin lan egiteko komandoak.

Komandoak

Komandoa Deskribapenak
pac solution add-license Gehitu lizentzia eta planaren informazioa irtenbideari.
pac solution add-reference Uneko direktorioko proiektuaren erreferentzia gehitzen dio proiektuari 'path'
pac solution add-solution-component Gehitu irtenbidearen osagai bat edo gehiago Dataverse-n kudeatu gabeko helburuko irbanbideari.
pac solution check Igo Dataverse irtenbidearen proiektu bat Power Apps Checker zerbitzuan exekutatzeko.
pac solution clone Sortu irtenbide proiektu bat zure erakundean dagoen irtenbide batean oinarrituta.
pac solution create-settings Sortu ezarpen-fitxategi bat soluzioaren zip edo soluzioaren karpetatik.
pac solution delete Ezabatu irtenbide bat Dataverse-tik uneko ingurunean.
pac solution export Esportatu irtenbide bat Dataverse-tik.
pac solution import Inportatu irtenbidea Dataverse-ra.
pac solution init Direktorio bat hasieratzen du Dataverse-ren soluzio-proiektu berri batekin
pac solution list Zerrendatu egungo Dataverse erakundeko soluzio guztiak
pac solution online-version Dataverse-n kargatutako soluzioaren bertsioa lortzen edo ezartzen du.
pac solution pack Paketatu irtenbidearen osagaiak fitxategi-sistema lokaleko solution.zip (SolutionPackager).
pac solution publish Pertsonalizazio guztiak argitaratzen ditu
pac solution sync Sinkronizatu uneko Dataverse irtenbidearen proiektua zure erakundeko irtenbidearen uneko egoerarekin.
pac solution unpack Erauzi soluzioaren osagaiak solution.zip fitxategi-sistema lokalera (SolutionPackager).
pac solution upgrade Aplikatu solution upgrade
pac solution version Eguneratu irtenbidearen eraikuntza edo berrikuspenaren bertsioa.

pac solution add-license

Gehitu lizentzia eta planaren informazioa irtenbideari.

Adibidea

Adibide honek irtenbide bati lizentziaren informazioa nola gehitu erakusten du.

pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv

Planaren definizio-fitxategia

Jarraian, planaren definizio-fitxategiaren adibide bat aurkituko duzu:

ServiceID,Display name,More info URL
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,Fabrikam Bronze Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,Fabrikam Silver Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,Fabrikam Gold Plan,http://www.microsoft.com

Planoaren mapatze-fitxategia

Jarraian, planoaren mapa fitxategiaren adibide bat aurkituko duzu:

Service ID,Component name
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_GoldApp

Beharrezko parametroak honako solution add-license

--planDefinitionFile -pd

Lizentzia planaren definizio-fitxategia CSV formatuan; Espero diren zutabeak: Zerbitzuaren IDa, Bistaratze-izena, Informazio gehiagoren URLa.

--planMappingFile -pm

Lizentzia planaren mapa fitxategia CSV formatuan; Espero diren zutabeak: Zerbitzuaren IDa, Osagaiaren izena

pac solution add-reference

Uneko direktorioko proiektuaren erreferentzia gehitzen dio proiektuari 'path'

Adibidea

pac solution add-reference --path c:\Users\Downloads\SampleComponent

Beharrezko parametroak honako solution add-reference

--path -p

Erreferentziazko proiektuaren bide-izena

pac solution add-solution-component

Gehitu irtenbidearen osagai bat edo gehiago Dataverse-n kudeatu gabeko helburuko irbanbideari.

Adibidea

Adibide honek irtenbidearen osagai bat nola gehitu erakusten du. Kasu honetan, kontaktu-taula gehitzen ari gara irtenbideari SampleSolution. Taula bat 1. osagaia da.

pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1

Beharrezko parametroak honako solution add-solution-component

--component -c

Helburu-soluzioan gehitu beharreko osagaiaren eskemaren izena edo IDa.

--componentType -ct

Gehitzen ari zaren irtenbidearen osagaia adierazten duen balioa.

--solutionUniqueName -sn

Irtenbidearen izena.

Aukerako parametroak solution add-solution-component

--AddRequiredComponents -arc

Gehitzen ari zaren irtenbidearen osagaiak eskatzen dituen beste soluzio-osagai batzuk kudeatu gabeko irtenbideari gehitu behar zaizkion ala ez adierazten du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--async -a

Irtenbidea asinkronoki inportatzen du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Ingurunearen URLa edo helburuko ingurunearen IDa.

pac solution check

Igo Dataverse irtenbidearen proiektu bat Power Apps Checker zerbitzuan exekutatzeko.

Adibidea

pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates

Aukerako parametroak solution check

--clearCache -cc

Garbitzen solution checkdu er betearazteko cachea, zure maizterrarentzat, zure irtenbideen iraganeko emaitzei dagozkien erregistro guztiak.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--customEndpoint -ce

Zehaztu URL pertsonalizatua Power Apps Checker amaiera-puntu gisa.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--excludedFiles -ef

Baztertu fitxategiak analisitik. Pasatu komaz bereizitako balio gisa

--geo -g

Power Apps Checker zerbitzuaren zein instantzia geografiko erabili behar den.

Erabili balio hauetako bat:

  • PreviewUnitedStates
  • UnitedStates
  • Europe
  • Asia
  • Australia
  • Japan
  • India
  • Canada
  • SouthAmerica
  • UnitedKingdom
  • France
  • SouthAfrica
  • Germany
  • UnitedArabEmirates
  • Switzerland
  • Norway
  • Singapore
  • Korea
  • Sweden
  • Italy
  • Poland
  • NewZealand
  • USGovernment
  • USGovernmentL4
  • USGovernmentL5DoD
  • China

--outputDirectory -o

Irteerako direktorioa

--path -p

Egiaztatu beharreko soluzio-fitxategi bat edo gehiago dauden bide-izena. Bide-izenak globo/komodinen karaktereak izan ditzake.

--ruleLevelOverride -rl

JSON matrizearen arauak eta gainidazteko mailak dituen fitxategiaren bide-izena. OverrideLevel-erako onartutako balioak hauek dira: Critical, High, Medium, Low, Informational. Adibidez: [{"Id":"meta-remove-dup-reg", "OverrideLevel":"Ertaina"},{"Id": "il-Avoid-Specialized-Update-Ops","OverrideLevel": "Ertaina"}]

--ruleSet -rs

Hautatu eraikuntza honen zati gisa exekutatzen den arau-multzoa. Balioak: baliozko GUID, "AppSource ziurtagiria", "Irtenbide-egiaztatzailea" (lehenetsia).

--saveResults -sav

Uneko ingurunea erabiltzen du Solution Health Hub aplikazioan ikus daitezkeen irtenbideen analisiaren emaitzak gordetzeko. Lehenespenez, argumentu hau false gisa ezarrita.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--solutionUrl -u

SAS Uri-k aztertu beharreko solution.zip adierazten du

pac solution clone

Sortu irtenbide proiektu bat zure erakundean dagoen irtenbide batean oinarrituta.

Adibideak

Ondorengo adibideek komandoaren pac solution clone erabilera erakusten dute.

Oinarrizko klonazioa

Adibide honek irtenbidea sampleSolution uneko direktorioan klonatzen du.

pac solution clone --name sampleSolution

Klonatu zenbakitze orokorrak eta automatikoki ezarpenak barne

Adibide honek uneko direktorioaren irtenbidea sampleSolution klonatzen du, zenbakitze orokorra eta automatikoa barne.

pac solution clone --name sampleSolution --include general,autonumbering

Beharrezko parametroak honako solution clone

--name -n

Esportatu beharreko soluzioaren izena.

Aukerako parametroak solution clone

--async -a

Irtenbidea asinkronoki esportatzen du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--include -i

Esportatzen ari den irtenbidean zein ezarpen sartu behar diren.

Erabili balio hauetako bat edo gehiago komaz bereizita:

  • autonumbering
  • calendar
  • customization
  • emailtracking
  • externalapplications
  • general
  • isvconfig
  • marketing
  • outlooksynchronization
  • relationshiproles
  • sales

--localize -loc

Atera edo konbinatzeko kate-baliabide guztiak artxiboetan.resx.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--map -m

Mapatze-xml fitxategi baten bide-izen osoa, paketatu beharreko osagaien karpetak irakurtzeko.

--max-async-wait-time -wt

Itxaronaldi asinkronoaren gehienezko denbora (minututan). Balio lehenetsia 60 minutukoa da.

--outputDirectory -o

Irteerako direktorioa

--packagetype -p

Soluzioaren erauzketa-mota zehazten du. Izan daitezke: 'Kudeatu gabea', 'Kudeatuta' edo 'Biak'. Balio lehenetsia hau da: 'Biak'.

--targetversion -v

Zaharkituta: parametro honi ez ikusi egiten zaio.

pac solution create-settings

Sortu ezarpen-fitxategi bat soluzioaren zip edo soluzioaren karpetatik.

Adibidea

pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json

Aukerako parametroak solution create-settings

--settings-file -s

Konexio-erreferentzien eta ingurune-aldagaien inplementazio-ezarpenen .json fitxategia.

--solution-folder -f

Paketatu gabeko irtenbide-karpeta lokalaren bide-izena: 'Bestea/Solution.xml' fitxategiaren erroa edo .cdsproj fitxategia duen karpeta bat.

--solution-zip -z

Soluzioaren ZIP fitxategirako bide-izena.

pac solution delete

Ezabatu irtenbide bat Dataverse-tik uneko ingurunean.

Adibidea

pac solution delete --solution-name Samplesolution

Beharrezko parametroak honako solution delete

--solution-name -sn

Irtenbidearen izena.

Aukerako parametroak solution delete

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

pac solution export

Esportatu irtenbide bat Dataverse-tik.

Adibidea

pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general

Beharrezko parametroak honako solution export

--name -n

Esportatu beharreko soluzioaren izena.

Aukerako parametroak solution export

--async -a

Irtenbidea asinkronoki esportatzen du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--include -i

Esportatzen ari den irtenbidean zein ezarpen sartu behar diren.

Erabili balio hauetako bat edo gehiago komaz bereizita:

  • autonumbering
  • calendar
  • customization
  • emailtracking
  • externalapplications
  • general
  • isvconfig
  • marketing
  • outlooksynchronization
  • relationshiproles
  • sales

--managed -m

Irtenbidea kudeatutako irtenbide gisa esportatu behar den ala ez adierazten du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--max-async-wait-time -wt

Itxaronaldi asinkronoaren gehienezko denbora (minututan). Balio lehenetsia 60 minutukoa da.

--overwrite -ow

Esportatutako soluzio-fitxategiak irtenbidearen zip fitxategia gainidatzi dezake fitxategi-sistema lokalean.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--path -p

Esportatutako irtenbidearen zip fitxategia idatzita dagoen bide-izena.

--targetversion -v

Zaharkituta: parametro honi ez ikusi egiten zaio.

pac solution import

Inportatu irtenbidea Dataverse-ra.

Adibidea

pac solution import --path c:\Users\Documents\Solution.zip

Aukerako parametroak solution import

--activate-plugins -ap

Aktibatu pluginak eta lan-fluxuak irtenbidean.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--async -a

Irtenbidea asinkronoki inportatzen du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--force-overwrite -f

Behartu kudeatu gabeko pertsonalizazioak gainidaztea

Parametro honek ez du baliorik behar. Aldaketa bat da.

--import-as-holding -h

Inportatu irtenbidea euskarri gisa.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--max-async-wait-time -wt

Itxaronaldi asinkronoaren gehienezko denbora (minututan). Balio lehenetsia 60 minutukoa da.

--path -p

Soluzioaren ZIP fitxategirako bide-izena. Zehazten ez bada, uneko karpeta cdsproj proiektua dela suposatzen du.

--publish-changes -pc

Argitaratu aldaketak inportazio arrakastatsua denean.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--settings-file

Konexio-erreferentzien eta ingurune-aldagaien inplementazio-ezarpenen .json fitxategia.

--skip-dependency-check -s

Saltatu mendekotasun-egiaztapena produktuaren eguneratze gisa markatutako mendekotasunen aurrean

Parametro honek ez du baliorik behar. Aldaketa bat da.

--skip-lower-version -slv

Saltatu solution import uneko ingurunean bertsio bera edo berriagoa badago.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--stage-and-upgrade -up

Inportatu eta eguneratu irtenbidea.

Parametro honek ez du baliorik behar. Aldaketa bat da.

Oharrak

Ingurune batera konektatuta zaude autentifikazio komandoa pac erabilizpac solution import.

pac solution import

Parametroa zehazten ez denean Path , uneko karpeta cdsproj proiektua dela suposatzen du. cdsproj fitxategiaren propietatea SolutionPackageType honela ezartzen Bothbada, kudeatutako irtenbidea lehenespenez erabiltzen da.

pac solution init

Direktorio bat hasieratzen du Dataverse-ren soluzio-proiektu berri batekin

Adibidea

pac solution init --publisher-name developer --publisher-prefix dev

Beharrezko parametroak honako solution init

--publisher-name -pn

Dataverse solution publisher-aren izena

Oharra: [A - Z], [a - z], [0 - 9] edo _ barrutietako karaktereak soilik onartzen dira. Lehenengo karakterea [A - Z], [a - z] edo _ barrutietan bakarrik egon daiteke.

--publisher-prefix -pp

Dataverse solution publisher-aren pertsonalizazio-aurrizkiaren balioa

Oharra: aurrizkiak 2 eta 8 karaktere izan behar ditu, alfanumerikoz soilik izan daiteke, letra batekin hasi behar du eta ezin da 'mscrm'-rekin hasi.

Aukerako parametroak solution init

--outputDirectory -o

Irteerako direktorioa

pac solution list

Zerrendatu egungo Dataverse erakundeko soluzio guztiak

Adibidea

pac solution list

Aukerako parametroak solution list

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--includeSystemSolutions

Microsoft-ek argitaratutakoak bezalako sistemen irtenbideak

Parametro honek ez du baliorik behar. Aldaketa bat da.

--json

Komandoaren irteera JSON formatuan dagoen kate gisa itzultzen du.

pac solution online-version

Dataverse-n kargatutako soluzioaren bertsioa lortzen edo ezartzen du.

Adibidea

pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2

Beharrezko parametroak honako solution online-version

--solution-name -sn

Irtenbidearen izena.

Aukerako parametroak solution online-version

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--solution-version -sv

Zehaztu zenbakia solution version . Baztertzen bada, uneko online solution version itzuliko da.

pac solution pack

Paketatu irtenbidearen osagaiak fitxategi-sistema lokaleko solution.zip (SolutionPackager).

Adibidea

pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Beharrezko parametroak honako solution pack

--zipfile -z

Irtenbidearen ZIP fitxategiaren bide-izen osoa

Aukerako parametroak solution pack

--allowDelete -ad

Ezabatze-eragiketak gerta daitezkeen zehazten du. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--allowWrite -aw

Idazketa-eragiketak gerta daitezkeen zehazten du. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--clobber -c

Irakurtzeko soilik markatutako fitxategiak ezabatu edo gainidatzi daitezkeela gaitzen du. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--disablePluginRemap -dpm

Pluginaren motaren izen guztiz kualifikatua birmapatzea desgaitu da. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--errorlevel -e

Egunkariaren irteeraren gutxieneko erregistro-maila [Verbose|Informazioa|Abisua|Errorea|Desaktibatuta]. Balio lehenetsia 'Info' da.

--folder -f

Fitxategi-sistema lokaleko erroko karpetaren bide-izena. Despaketatzean edo erauztean, hau idatzi egiten da. Paketatzean, hau irakurtzen da.

--localize -loc

Atera edo konbinatzeko kate-baliabide guztiak artxiboetan.resx.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--log -l

Egunkari-fitxategiaren bide-izena.

--map -m

Mapatze-xml fitxategi baten bide-izen osoa, paketatu beharreko osagaien karpetak irakurtzeko.

--packagetype -p

Despaketatzean edo erauztean, erabili Kudeatutako eta Kudeatu gabeko eragiketa bikoitza zehazteko. Paketatzean, erabili Kudeatua edo Kudeatu gabea aurreko 'Biak' despaketatzetik zehazteko. Izan daitezke: 'Kudeatu gabea', 'Kudeatuta' edo 'Biak'. Balio lehenetsia 'Kudeatu gabea' da.

--singleComponent -sc

Egin ekintza osagai bakar batean soilik [WebResource|Plugina|Lan-fluxua|Bat ere ez]. Balio lehenetsia 'Bat ere ez' da.

--sourceLoc -src

Txantiloi-baliabideen fitxategia sortzen du. Erauzketan soilik baliozkoa da. Balio erabilgarriak: 'auto' edo esportatu nahi duzun hizkuntzaren hizkuntza-kodea. Hizkuntza-kodearen identifikatzailea (LCID) edo Estandarizaziorako Nazioarteko Erakundearen (ISO) hizkuntza-kode-formatuak erabil ditzakezu. Dagoenean, honek kate-baliabideak emandako lokaletik erauzten ditu .resx neutro gisa. 'auto' edo etengailuaren forma luzea edo laburra zehazten bada, soluzioaren oinarrizko lokala erabiliko da.

--useLcid -lcid

Erabili Language Code Identifier (LCID) balioak (1033) hizkuntza-fitxategietarako, Normalizaziorako Nazioarteko Erakundearen (ISO) kodeen (en-US) ordez.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--useUnmanagedFileForMissingManaged -same

Erabili XML iturburu-fitxategi bera Kudeatu eta kudeatu gabeko XML fitxategia paketeatzean; AppModuleSiteMap, AppModuleMap eta FormXml fitxategiei aplikatzen zaie.

Parametro honek ez du baliorik behar. Aldaketa bat da.

solution pack Iruzkinak

pac solution pack Osagaien fitxategiak irakurtzean iturburu-karpeten bi diseinu onartzen ditu: XML formatua (zaharra) eta YAML iturburu-kontroleko formatua.

Garrantzitsua

YAML iturburu-kontrolaren formatuaren euskarriak Microsoft behar du. PowerApps.CLI 2.4.1 bertsioa edo berriagoa. Deskargatu NuGet edo eguneratu pac install latest-rekin.

Formatua automatikoki detektatzen da karpetaren edukian oinarrituta:

  • Karpetak fitxategiak dituen solutions/ azpidirektorio bat *solution.yml badu→ YAML formatua erabiliko da.
  • Azpidirektoriorik aurkitzen ez solutions/ bada→ XML formatua (zaharra) erabiliko da, eta horrek Other\Solution.xml eta Other\Customizations.xml.

YAML formatuaren adibidea:

pac solution pack --zipfile C:\output\MySolution.zip --folder C:\repos\myrepo

Irtenbide anitzeko biltegi batekin lan egitea:

Karpetak irtenbide solutions/*/solution.ymlbat baino gehiago dituenean , erabili SolutionPackager.exe zuzenean honekin:/SolutionName

SolutionPackager.exe /action:Pack /zipfile:SolutionA.zip /folder:C:\repos\myrepo /SolutionName:SolutionA

Oharra

YAML iturburu-kontrol formatua Dataverse Git integrazioa jatorrizko formatua da, Power Apps-ko irtenbideak egiaztatzen dituzunean. Git-en integratutako biltegi batetik karpeta bat eskuz paketatzen ari bazara, erabili pac solution pack--folder biltegiaren erroa seinalatuz.

YAML karpeten egiturari eta onartzen diren osagaiei buruzko informazio gehiago nahi izanez gero, ikus SolutionPackager tresna - Iturburu-kontroleko fitxategi-formatuak.

pac solution publish

Pertsonalizazio guztiak argitaratzen ditu

Adibidea

pac solution publish

Aukerako parametroak solution publish

--async -a

Pertsonalizazio guztiak asinkronoki argitaratzen ditu

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--max-async-wait-time -wt

Itxaronaldi asinkronoaren gehienezko denbora (minututan). Balio lehenetsia 60 minutukoa da.

pac solution sync

Sinkronizatu uneko Dataverse irtenbidearen proiektua zure erakundeko irtenbidearen uneko egoerarekin.

Adibideak

Ondorengo adibideek komandoaren pac solution sync erabilera erakusten dute.

Oinarrizko sinkronizazioa

Adibide honek irtenbidea uneko direktorioarekin sinkronizatzen du.

pac solution sync

Aukerako parametroak solution sync

--async -a

Irtenbidea asinkronoki esportatzen du.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--include -i

Esportatzen ari den irtenbidean zein ezarpen sartu behar diren.

Erabili balio hauetako bat edo gehiago komaz bereizita:

  • autonumbering
  • calendar
  • customization
  • emailtracking
  • externalapplications
  • general
  • isvconfig
  • marketing
  • outlooksynchronization
  • relationshiproles
  • sales

--localize -loc

Atera edo konbinatzeko kate-baliabide guztiak artxiboetan.resx.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--map -m

Mapatze-xml fitxategi baten bide-izen osoa, paketatu beharreko osagaien karpetak irakurtzeko.

--max-async-wait-time -wt

Itxaronaldi asinkronoaren gehienezko denbora (minututan). Balio lehenetsia 60 minutukoa da.

--packagetype -p

Despaketatzean edo erauztean, erabili Kudeatutako eta Kudeatu gabeko eragiketa bikoitza zehazteko. Paketatzean, erabili Kudeatua edo Kudeatu gabea aurreko 'Biak' despaketatzetik zehazteko. Izan daitezke: 'Kudeatu gabea', 'Kudeatuta' edo 'Biak'. Balio lehenetsia hau da: 'Biak'.

--solution-folder -f

Paketatu gabeko irtenbide-karpeta lokalaren bide-izena: 'Bestea/Solution.xml' fitxategiaren erroa edo .cdsproj fitxategia duen karpeta bat.

pac solution unpack

Erauzi soluzioaren osagaiak solution.zip fitxategi-sistema lokalera (SolutionPackager).

Adibidea

pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Beharrezko parametroak honako solution unpack

--zipfile -z

Irtenbidearen ZIP fitxategiaren bide-izen osoa

Aukerako parametroak solution unpack

--allowDelete -ad

Ezabatze-eragiketak gerta daitezkeen zehazten du. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--allowWrite -aw

Idazketa-eragiketak gerta daitezkeen zehazten du. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--clobber -c

Irakurtzeko soilik markatutako fitxategiak ezabatu edo gainidatzi daitezkeela gaitzen du. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--disablePluginRemap -dpm

Pluginaren motaren izen guztiz kualifikatua birmapatzea desgaitu da. Balio lehenetsia 'false' da.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--errorlevel -e

Egunkariaren irteeraren gutxieneko erregistro-maila [Verbose|Informazioa|Abisua|Errorea|Desaktibatuta]. Balio lehenetsia 'Info' da.

--folder -f

Fitxategi-sistema lokaleko erroko karpetaren bide-izena. Despaketatzean edo erauztean, hau idatzi egiten da. Paketatzean, hau irakurtzen da.

--localize -loc

Atera edo konbinatzeko kate-baliabide guztiak artxiboetan.resx.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--log -l

Egunkari-fitxategiaren bide-izena.

--map -m

Mapatze-xml fitxategi baten bide-izen osoa, paketatu beharreko osagaien karpetak irakurtzeko.

--packagetype -p

Despaketatzean edo erauztean, erabili Kudeatutako eta Kudeatu gabeko eragiketa bikoitza zehazteko. Paketatzean, erabili Kudeatua edo Kudeatu gabea aurreko 'Biak' despaketatzetik zehazteko. Izan daitezke: 'Kudeatu gabea', 'Kudeatuta' edo 'Biak'. Balio lehenetsia 'Kudeatu gabea' da.

--singleComponent -sc

Egin ekintza osagai bakar batean soilik [WebResource|Plugina|Lan-fluxua|Bat ere ez]. Balio lehenetsia 'Bat ere ez' da.

--sourceLoc -src

Txantiloi-baliabideen fitxategia sortzen du. Erauzketan soilik baliozkoa da. Balio erabilgarriak: 'auto' edo esportatu nahi duzun hizkuntzaren hizkuntza-kodea. Hizkuntza-kodearen identifikatzailea (LCID) edo Estandarizaziorako Nazioarteko Erakundearen (ISO) hizkuntza-kode-formatuak erabil ditzakezu. Dagoenean, honek kate-baliabideak emandako lokaletik erauzten ditu .resx neutro gisa. 'auto' edo etengailuaren forma luzea edo laburra zehazten bada, soluzioaren oinarrizko lokala erabiliko da.

--useLcid -lcid

Erabili Language Code Identifier (LCID) balioak (1033) hizkuntza-fitxategietarako, Normalizaziorako Nazioarteko Erakundearen (ISO) kodeen (en-US) ordez.

Parametro honek ez du baliorik behar. Aldaketa bat da.

--useUnmanagedFileForMissingManaged -same

Erabili XML iturburu-fitxategi bera Kudeatu eta kudeatu gabeko XML fitxategia paketeatzean; AppModuleSiteMap, AppModuleMap eta FormXml fitxategiei aplikatzen zaie.

Parametro honek ez du baliorik behar. Aldaketa bat da.

solution unpack Iruzkinak

Lehenespenez, pac solution unpack irtenbidearen osagaiak fitxategi batetik .zipXML formatuan erauzten ditu, hierarkia bat Other\Solution.xml sortuz.

Garrantzitsua

YAML iturburu-kontrolaren formatuaren euskarriak Microsoft behar du. PowerApps.CLI 2.4.1 bertsioa edo berriagoa. Deskargatu NuGet edo eguneratu pac install latest-rekin.

Dataverse Git jatorrizko integrazioaren bidez kudeatutako edo erauzitako pac solution cloneirtenbideekin lan egiten duzunean, lortutako karpetak YAML iturburu-kontrol formatua erabiltzen du:

<folder>/
├── solutions/
│   └── <SolutionUniqueName>/
│       ├── solution.yml
│       ├── solutioncomponents.yml
│       ├── rootcomponents.yml
│       └── missingdependencies.yml
├── publishers/
│   └── <PublisherUniqueName>/
│       └── publisher.yml
└── [component folders — entities/, workflows/, canvasapps/, ...]

YAML diseinu honetako karpeta bat birpaketatzeko, erabili pac solution pack --folder <rootFolder>. Azpidirektorioaren solutions/ presentziak automatikoki seinalatzen du YAML formatua.

Garrantzitsua

Osagai bat zerrendatzen baduzu, rootcomponents.yml baina bere iturburu-fitxategiak karpetan sartzen ez badituzu (adibidez, oihaleko aplikazio-fitxategi .msapp bat azpian canvasapps/<name>/), pakete-eragiketak arrakasta izango du, baina osagai hori irteeratik .zipkanpo uzten du. Osagaien fitxategi guztiak daudela ziurtatzeko, berriro esportatu eta despaketatu irtenbide osoa Dataverse-tik.

YAML karpeten egiturari eta osagaien euskarriari buruzko informazio gehiago nahi izanez gero, ikus SolutionPackager tresna - Iturburu-kontroleko fitxategi-formatuak.

pac solution upgrade

Aplikatu solution upgrade

Adibidea

pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60

Beharrezko parametroak honako solution upgrade

--solution-name -sn

Irtenbidearen izena.

Aukerako parametroak solution upgrade

--async -a

Eguneratzen du irtenbidea asinkronoki

Parametro honek ez du baliorik behar. Aldaketa bat da.

--environment -env

Helburuko Dataverse-a zehazten du. Balioa Guid edo https URL absolutua izan daiteke. Zehaztu ezean, uneko autentifikazio-profilerako hautatutako erakunde aktiboa erabiliko da.

--max-async-wait-time -wt

Itxaronaldi asinkronoaren gehienezko denbora (minututan). Balio lehenetsia 60 minutukoa da.

pac solution version

Eguneratu irtenbidearen eraikuntza edo berrikuspenaren bertsioa.

Adibidea

pac solution version --patchversion 2
pac solution version --strategy gittags

Aukerako parametroak solution version

--buildversion -bv

Eraiki irtenbidearen bertsioa.

Oharra: balioak zenbaki osoa izan behar du, gutxieneko 0 balioarekin.

--filename -fn

Fitxategien jarraipena estrategia gisa erabiltzean erabiliko den CSV fitxategi-izena. Balio lehenetsia 'ControlsStateVersionInfo.csv' da.

--patchversion -pv

Zaharkituta: parametro honi ez ikusi egiten zaio.

--revisionversion -rv

Irtenbidearen berrikuspen-bertsioa.

Oharra: balioak zenbaki osoa izan behar du, gutxieneko 0 balioarekin.

--solutionPath -sp

Dataverse-ren soluzioaren direktorioaren edo Solution.xml fitxategiaren bide-izena.

--strategy -s

'Solution.xml' fitxategiaren eraikuntza-bertsioa eguneratzen du zehaztutako estrategia erabiliz. Gittags erabiltzen baduzu, ezarri sarbide pertsonalaren token "PacCli.PAT" ingurune-aldagai honetan

Erabili balio hauetako bat:

  • None
  • GitTags
  • FileTracking
  • Solution

Esportazioaren arteko desberdintasunak eta esportazioak pac solution clone

Badira egoerak non ez zauden ziur noiz erabili pac solution clone edo pac solution export agindu. Komandoetako bat erabil dezakezu ondorengo agertokietan:

  • Erabili pac solution clone irtenbideari osagai berriak gehitu behar dizkiozunean.
  • Erabili pac solution export irtenbide-fitxategi bateko lehendik dagoen edukia aldatu nahi duzunean, baina irtenbideari osagai berririk gehitu gabe.

pac solution clone

Esportatutako irtenbideak Visual Studio proiektu baten itxura du irtenbidea pac solution clone komandoa erabiliz esportatzen duzunean. .csproj baten ordez (Visual Studio bezala), cdsproj fitxategi bat ikusiko duzu. Fitxategiak cdsproj proiektua eraikitzeko beharrezkoa den osagaien informazio guztia dauka. Eraikuntzaren irteera irtenbidearen zip fitxategi bat da, ingurune desberdinetara inportatu dezakezuna.

Pac solution clone.

Garatzaileak ez du klonatutako irtenbidea despaketatu beharrik, src (iturburu) karpetan paketatu gabeko formatuan errendatuta dagoelako.

Pac solution unpack.

Orain, sortu berri den plugin bat irtenbide honekin lotu nahi baduzu, ed-rekin solution unpack, komandoa erabil pac solution add-reference dezakezu fitxategia .cdsproj eguneratzeko plugin berria gehitzeko. Ondoren, proiektua eraiki dezakezu edo dotnet builderabilizmsbuild.

Proiektua eraiki aurretik eraikuntza zaharberritzea gomendatzen da. Eraikuntza berreskuratzeak (dotnet build-ek lehenik eta behin automatikoki egiten du) paketatutako soluzio bat sortzeko beharrezko .NET liburutegiak berreskuratuko ditu.

pac solution export

Irtenbidea erabiliz pac solution export esportatzen duzunean, irtenbidea maker ataria erabiliz esportatu nahi duzu, eta emaitza irtenbidearen zip fitxategia da.

Pac solution export.

Irtenbidearen zip fitxategia despaketatzen duzunean (ez dugu gomendatzen zip-a tresna estandarrekin irekitzea eta CLI-ko komando egokia erabiltzea). Lortutako direktorio-egitura pac solution clone. Desberdintasun bakarra da ezin duzula erreferentziarik gehitu despaketatu gabeko irtenbide honi, ez baitu proiektuaren fitxategirik .cdsproj .

Pac soluzioaren egitura.

Eguneratu nahi dituzun dagokion fitxategi multzoa alda dezakezu eta, ondoren solution pack, irtenbidearen zip fitxategia berriro sortzen du, irtenbidea helburuko ingurunean inportatzea errazteko. Ekintzaren emaitza irtenbidearen zip fitxategi bat da, eduki eguneratuarekin eta denbora-zigiluarekin eguneratuta.

Ikusi ere bai

Microsoft Power Platform CLI komando-taldeak
Microsoft Power Platform CLI ikuspegi orokorra