Ratkaisun YAML-lähteen hallinnan muotoviittaus

Tämä artikkeli on viittaus YAML-pohjaiseen lähdeohjausmuotoon, jota käytetään, kun:

• Lähetä ratkaisuja käyttämällä Power Apps alkuperäistä Dataverse Git -integrointia.
• Poimi ratkaisuja käyttämällä pac solution clone tai pac solution sync.
• Suorita SolutionPackager manuaalisesti kansioon, joka sisältää YAML-kokoonpanotiedostoja.

YAML-muoto eroaa perinteisestä XML-asettelusta. Rakenteen ymmärtäminen on tärkeää, kun haluat pakata YAML-kansion manuaalisesti takaisin tiedostoon .zip , jonka Dataverse voi tuoda.

Kansiorakenteen yleiskatsaus

YAML-format-säilön pääkansio sisältää seuraavat ylimmän tason hakemistot:

<repositoryRoot>/
├── solutions/
│   └── <SolutionUniqueName>/       (one subfolder per solution)
│       ├── solution.yml
│       ├── solutioncomponents.yml
│       ├── rootcomponents.yml
│       └── missingdependencies.yml
├── publishers/
│   └── <PublisherUniqueName>/      (one subfolder per publisher)
│       └── publisher.yml
├── entities/                        (entity components, if any)
│   └── <entity_schema_name>/
│       ├── attributes/
│       ├── formxml/
│       ├── savedqueries/
│       └── ...
├── workflows/                       (classic workflow definitions, if any)
├── modernflows/                     (Power Automate cloud flows, if any)
├── canvasapps/                      (canvas app .msapp files, if any)
│   └── <canvas_app_schema_name>/
│       └── <name>.msapp
├── environmentvariabledefinitions/  (environment variable definitions, if any)
├── connectors/                      (custom connectors, if any)
└── [other component folders]/

- ja publishers/ -solutions/hakemistot ovat pakollisia. Kaikki juuressa olevat komponenttikansiot ovat valinnaisia, ja ne riippuvat siitä, mitä ratkaisu sisältää.

Automaattisen tunnistuksen muotoileminen

SolutionPackager (ja pac solution pack) tunnista muoto automaattisesti seuraavasti:

Kokoonpanotiedostot

solution.yml

Sijaitsee osoitteessa solutions/<SolutionUniqueName>/solution.yml. Sisältää ylimmän tason ratkaisun metatiedot – YAML-vastaavuus solution.xml XML-muodossa.

Avainkenttiä ovat ratkaisun yksilöivä nimi, versio, kutsumanimi, kuvaus ja viittaus julkaisijaan.

solutioncomponents.yml

Sijaitsee osoitteessa solutions/<SolutionUniqueName>/solutioncomponents.yml. Näyttää luettelon kaikkien tähän ratkaisuun sisältyvien osatiedostojen suhteellisista poluista. SolutionPackager lukee tämän tiedoston paketin aikana ja paikantaa sen komponenttilähteet.

Esimerkkikatkelma:

- Path: entities/account
- Path: entities/contact
- Path: canvasapps/myapp_<guid>
- Path: publishers/MyPublisher

rootcomponents.yml

Sijaitsee osoitteessa solutions/<SolutionUniqueName>/rootcomponents.yml. Näyttää luettelon päätason osista (yleensä taulukoista ja muista ylimmän tason objekteista), jotka kuuluvat tähän ratkaisuun.

missingdependencies.yml

Sijaitsee osoitteessa solutions/<SolutionUniqueName>/missingdependencies.yml. Kirjaa ratkaisun riippuvuudet, joita ei ollut ratkaisun viemisen aikana. Käytetään tietotarkoituksiin ja täydentävuuden vahvistamiseen tuonnin yhteydessä.

publisher.yml

Sijaitsee osoitteessa publishers/<PublisherUniqueName>/publisher.yml. Sisältää julkaisijan määrityksen: yksilöivän nimen, näyttönimen, mukautuksen etuliitteen ja asetuksen arvon etuliitteen.

Vaadittu rakenne on mahdollisimman pieni:

Publisher:
  UniqueName: mypublisher
  LocalizedNames:
    LocalizedName:
      '@description': My Publisher
      '@languagecode': '1033'
  Descriptions:
  EMailAddress:
    '@xsi:nil': 'true'
    '@xmlns:xsi': http://www.w3.org/2001/XMLSchema-instance
  SupportingWebsiteUrl:
    '@xsi:nil': 'true'
    '@xmlns:xsi': http://www.w3.org/2001/XMLSchema-instance
  CustomizationPrefix: myp
  CustomizationOptionValuePrefix: '12345'
  Addresses:

Osatyypin tuki

Seuraavassa taulukossa on lueteltu, miten kutakin komponenttityyppiä käsitellään YAML-muodossa.

Usean ratkaisun säilöt

Yksittäinen säilön pääkansio voi sisältää useita ratkaisuja. Kaikilla ratkaisuilla on samat komponenttikansiot. solutioncomponents.yml ohjaa, mitkä komponenttipolut kuuluvat tähän ratkaisuun.

Esimerkkirakenne ja kaksi ratkaisua:

<repositoryRoot>/
├── solutions/
│   ├── SolutionA/
│   │   ├── solution.yml
│   │   ├── solutioncomponents.yml    ← references entities/account, entities/contact
│   │   ├── rootcomponents.yml
│   │   └── missingdependencies.yml
│   └── SolutionB/
│       ├── solution.yml
│       ├── solutioncomponents.yml    ← references entities/lead, workflows/myflow
│       ├── rootcomponents.yml
│       └── missingdependencies.yml
├── publishers/
│   └── SharedPublisher/
│       └── publisher.yml
├── entities/
│   ├── account/
│   ├── contact/
│   └── lead/
└── workflows/
    └── myflow/

Tietyn ratkaisun pakkaaminen moniratkaisukansiosta

SolutionPackager.exekäyttäminen:

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

Using pac solution pack (vain yhden ratkaisun kansiot – usean ratkaisun kanssa, käytä SolutionPackager.exe suoraan kohteen kanssa /SolutionName):

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

YAML-muotokansioiden käyttäminen

YAML-kansion pakkaaminen .zip tiedostoon

# Using pac CLI (single solution in folder)
pac solution pack --zipfile C:\output\MySolution.zip --folder C:\repos\myrepo

# Using SolutionPackager.exe directly (also works for multi-solution with /SolutionName)
SolutionPackager.exe /action:Pack /zipfile:C:\output\MySolution.zip /folder:C:\repos\myrepo

Täydellisen YAML-kansion hankkiminen Dataversesta

Suositeltu tapa hankkia täydellinen, pakattava YAML-kansio on käyttää pac solution clone:a:

pac solution clone --name MySolutionUniqueName --outputDirectory C:\repos\myrepo

Tämä purkaa ratkaisun YAML-muotoon, joka sisältää kaikki osalähdetiedostot. Vaihtoehtoisesti voit käyttää alkuperäistä Git-integrointia vahvistukseen Power Apps – vahvistetut tiedostot ovat YAML-muodossa ja täysin pakattavissa.

Tarkista kansio ennen pakkaamista

Tarkista, että solutions/<name>/ kansio on olemassa ja että kaikki polut ratkaistaan solutioncomponents.yml todellisiin tiedostoihin. Puuttuvat polut aiheuttavat varoituksia paketin aikana, ja kyseiset osat jätetään pois.

Suhde Dataverse Git -integrointiin

YAML-lähteen ohjausobjektin muoto on kanoninen muoto, jota Dataverse Git -integrointi käyttää. Kun tekijät tekevät ratkaisuja Power Apps, Azure DevOps kirjoitetut tiedostot käyttävät tätä muotoa. Koodi ensin -kehittäjät voivat käsitellä samaa säilöä tässä kuvattujen komentorivikäyttöliittymätyökalujen avulla.

Lisätietoja ympäristöjen yhdistämisestä Gitiin on kohdassa Dataverse Gatin integroinnin määritys.

Liittyvä sisältö

• SolutionPackager-työkalu
• Lähteen hallinta ratkaisutiedostoilla
• pac-ratkaisupaketti
• pac-ratkaisun pakkaaminen
• Dataverse Git -integroinnin yleiskatsaus