Lösningsreferens för YAML-källkontrollformat

Den här artikeln är en referens för det YAML-baserade källkontrollformatet som används när du:

• Genomför lösningar med inbyggd Dataverse Git-integrering i Power Apps.
• Extrahera lösningar med eller pac solution clonepac solution sync.
• Kör SolutionPackager manuellt mot en mapp som innehåller YAML-manifestfiler.

YAML-formatet skiljer sig från den klassiska XML-layouten. Det är viktigt att förstå strukturen när du vill packa en YAML-mapp manuellt tillbaka till en .zip fil som Dataverse kan importera.

Översikt över mappstruktur

En YAML-format lagringsplatsrot innehåller följande kataloger på den översta nivån:

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

Katalogerna solutions/ och publishers/ krävs. Alla komponentmappar i roten är valfria och beror på vad lösningen innehåller.

Formatera automatisk identifiering

SolutionPackager (och pac solution pack) identifierar formatet automatiskt enligt följande:

Manifestfiler

solution.yml

Finns på solutions/<SolutionUniqueName>/solution.yml. Innehåller lösningsmetadata på den översta nivån – YAML-motsvarigheten solution.xml till i XML-format.

Nyckelfälten innehåller lösningens unika namn, version, eget namn, beskrivning och en referens till utgivaren.

solutioncomponents.yml

Finns på solutions/<SolutionUniqueName>/solutioncomponents.yml. Visar relativa sökvägar till alla komponentfiler som ingår i den här lösningen. SolutionPackager läser den här filen under paketet för att hitta komponentkällor.

Exempelutdrag:

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

rootcomponents.yml

Finns på solutions/<SolutionUniqueName>/rootcomponents.yml. Visar de rotnivåkomponenter (vanligtvis tabeller och andra objekt på den översta nivån) som tillhör den här lösningen.

missingdependencies.yml

Finns på solutions/<SolutionUniqueName>/missingdependencies.yml. Registrerar eventuella lösningsberoenden som inte fanns när lösningen senast exporterades. Används i informationssyfte och för att verifiera fullständighet vid import.

publisher.yml

Finns på publishers/<PublisherUniqueName>/publisher.yml. Innehåller utgivarens definition – unikt namn, visningsnamn, anpassningsprefix och alternativvärdeprefix.

Minimal struktur som krävs:

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öd för komponenttyp

I följande tabell visas hur varje komponenttyp hanteras i YAML-format.

Lagringsplatser för flera lösningar

En enskild lagringsplatsrot kan innehålla flera lösningar. Alla lösningar delar samma komponentmappar. solutioncomponents.yml i varje lösning styr vilka komponentsökvägar som tillhör den lösningen.

Exempelstruktur med två lösningar:

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

Packa en specifik lösning från en mapp med flera lösningar

Använda SolutionPackager.exe:

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

Använd pac solution pack (endast mappar med en lösning – för flera lösningar använder du SolutionPackager.exe direkt med /SolutionName):

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

Arbeta med YAML-formatmappar

Packa en YAML-mapp 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

Hämta en fullständig YAML-mapp från Dataverse

Det rekommenderade sättet att få en fullständig, packbar YAML-mapp är att använda pac solution clone:

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

Detta extraherar lösningen i YAML-format, inklusive alla komponentkällfiler. Du kan också använda inbyggd Git-integrering för att checka in från Power Apps – de incheckade filerna är i YAML-format och helt packbara.

Kontrollera mappen innan du packar

Kontrollera att solutions/<name>/ mappen finns och att alla sökvägar i solutioncomponents.yml matchar faktiska filer. Eventuella sökvägar som saknas resulterar i varningar under paketet och dessa komponenter utelämnas.

Relation till Dataverse Git-integrering

YAML-källkontrollformatet är det kanoniska format som används av Dataverse Git-integrering. När skaparna genomför lösningar från Power Apps använder filerna som skrivits till Azure DevOps det här formatet. Kodutvecklare kan arbeta med samma lagringsplats med hjälp av CLI-verktygen som beskrivs här.

Information om hur du ansluter miljöer till Git finns i Konfiguration av Git-integrering i Dataverse.

Relaterat innehåll

• SolutionPackager-verktyget
• Källkontroll med lösningsfiler
• pac solution pack
• pac-lösning packa upp
• Översikt över Git-integrering i Dataverse