Referanse for løsnings-YAML-kildekontrollformat

Denne artikkelen er en referanse for det YAML-baserte kildekontrollformatet som brukes når du:

• Utfør løsninger ved hjelp av opprinnelig Dataverse Git-integrasjon i Power Apps.
• Trekk ut løsninger ved hjelp av pac solution clone eller pac solution sync.
• Kjør SolutionPackager manuelt mot en mappe som inneholder YAML-manifestfiler.

YAML-formatet er forskjellig fra det klassiske XML-oppsettet. Det er viktig å forstå strukturen når du vil pakke en YAML-mappe manuelt tilbake til en .zip fil som Dataverse kan importere.

Oversikt over mappestruktur

En repositoriumrot i YAML-format inneholder følgende kataloger på øverste nivå:

<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]/

publishers/ Og solutions/ kataloger kreves. Alle komponentmapper ved roten er valgfrie og avhenger av hva løsningen inneholder.

Formater automatisk gjenkjenning

SolutionPackager (og pac solution pack) gjenkjenner formatet automatisk på følgende måte:

Manifestfiler

solution.yml

Plassert på solutions/<SolutionUniqueName>/solution.yml. Inneholder løsningsmetadata på øverste nivå – YAML-ekvivalenten solution.xml i XML-formatet.

Nøkkelfelt inkluderer løsningens unike navn, versjon, egendefinert navn, beskrivelse og en referanse til utgiveren.

solutioncomponents.yml

Plassert på solutions/<SolutionUniqueName>/solutioncomponents.yml. Viser relative baner til alle komponentfiler som er inkludert i denne løsningen. SolutionPackager leser denne filen under pakken for å finne komponentkilder.

Eksempelutdrag:

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

rootcomponents.yml

Plassert på solutions/<SolutionUniqueName>/rootcomponents.yml. Viser komponentene på rotnivå (vanligvis tabeller og andre objekter på øverste nivå) som tilhører denne løsningen.

missingdependencies.yml

Plassert på solutions/<SolutionUniqueName>/missingdependencies.yml. Registrerer eventuelle løsningsavhengigheter som ikke var til stede da løsningen sist ble eksportert. Brukes til informasjonsformål og for å validere fullstendighet ved import.

publisher.yml

Plassert på publishers/<PublisherUniqueName>/publisher.yml. Inneholder utgiverdefinisjonen – unikt navn, visningsnavn, tilpassingsprefiks og prefiks for alternativverdi.

Minimal nødvendig struktur:

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:

Støtte for komponenttype

Tabellen nedenfor viser hvordan hver komponenttype håndteres i YAML-format.

Repositorier med flere løsninger

En enkelt repositoriumrot kan inneholde flere løsninger. Alle løsninger deler de samme komponentmappene. solutioncomponents.yml i hver løsning kontrollerer hvilke komponentbaner som tilhører den løsningen.

Eksempelstruktur med to løsninger:

<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/

Pakke en bestemt løsning fra en flerløsningsmappe

Bruke SolutionPackager.exe:

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

Bruk pac solution pack (bare enkeltløsningsmapper – for flerløsning, bruk SolutionPackager.exe direkte med /SolutionName):

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

Arbeide med YAML-formatmapper

Pakke en YAML-mappe inn i en .zip fil

# 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

Få en fullstendig YAML-mappe fra Dataverse

Den anbefalte måten å få en komplett, pakkebar YAML-mappe på, er å bruke pac solution clone:

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

Dette trekker ut løsningen i YAML-formatet, inkludert alle komponentkildefiler. Alternativt kan du bruke opprinnelig Git-integrasjon til å utføre fra Power Apps – de forpliktede filene er i YAML-format og kan pakkes fullstendig.

Bekreft mappen før pakking

Kontroller at solutions/<name>/ mappen finnes, og at alle banene i solutioncomponents.yml løses til faktiske filer. Eventuelle manglende baner resulterer i advarsler under pakken, og disse komponentene utelates.

Relasjon til Git-integrasjon for datavers

YAML-kildekontrollformatet er det kanoniske formatet som brukes av Datavers Git-integrasjon. Når beslutningstakere utfører løsninger fra Power Apps, bruker filene som er skrevet til Azure DevOps dette formatet. Kode-først-utviklere kan arbeide med samme repositorium ved hjelp av CLI-verktøyene som er beskrevet her.

Hvis du vil ha informasjon om hvordan du kobler miljøer til Git, kan du se Konfigurasjon av Git-integrering for Dataverse.

Relatert innhold

• SolutionPackager-verktøy
• Kildekontroll med løsningsfiler
• pac-løsningspakke
• pac løsning pakke ut
• Oversikt over Datavers Git-integrasjon