Koble til og koble datavers fra et Git-repositorium ved hjelp av kode

ConnectToGit Bruk API-ene og DisconnectFromGit API-ene til å integrere Microsoft Dataverse-miljøet programmatisk med Git-kildekontrollen. Ved hjelp av disse API-ene kan du koble individuelle løsninger eller hele miljøer til Git-repositorier som driftes på Azure DevOps, og administrere disse tilkoblingene via kode.

Viktig!

Azure DevOps er for øyeblikket den eneste støttede Git-leverandøren.

Forutsetninger

Før du bruker disse API-ene, må du kontrollere at du har:

Tilgang til et Microsoft Dataverse-miljø
Systemansvarligs tillatelser
Lese og skrive tilgang til et Git-repositorium

ConnectToGit API

Oppretter en tilkobling mellom en datavers løsning eller et miljø og et Git-repositorium. Ved hjelp av denne tilkoblingen kan du administrere kildekontroll for dataverskomponentene.

Parametere

ConnectToGit API-en godtar følgende parametere:

Parameter	Type	Påkrevd	Beskrivelse
`GitFolder`	String	Ja	Navnet på mappen du vil binde løsningen eller miljøet til.
`Branch`	String	Ja	Navnet på grenen du vil koble til.
`ConnectionType`	Integer	Nei	Angir hva du skal koble til. Se ConnectionType-parameteren.
`GitProvider`	Integer	Nei	Git-leverandøren. Se GitProvider-parameteren.
`Organization`	String	Nei	Navnet på organisasjonen du vil koble til.
`Project`	String	Nei	Navnet på prosjektet du vil koble til.
`Repository`	String	Nei	Navnet på repositoriet du vil koble til.
`RootFolder`	String	Nei	Navnet på rotmappen der alle løsningene ligger i løsningsomfanget.
`SolutionUniqueName`	String	Nei	Det unike navnet på løsningen du vil koble til git.
`UpstreamBranch`	String	Nei	Navnet på oppstrømsgreningen du vil koble til. Angis til standardgrenen for repositorium.

ConnectionType-parameter

Parameteren ConnectionType kontrollerer om du vil koble til hele dataversmiljøet eller en bestemt løsning.

Verdi	Etikett	Beskrivelse
0	Løsning	Kobler en bestemt dataversløsning til Git.
1	Miljø	Kobler hele dataversmiljøet til Git.

GitProvider-parameter

Bruk parameteren GitProvider til å angi hvilken type Git-leverandør du bruker, enten Azure DevOps eller GitHub.

Verdi	Etikett	Beskrivelse
0	Azure DevOps	Bruk for repositorier som driftes på Azure DevOps
1	GitHub	Bruk for repositorier som driftes på GitHub

DisconnectFromGit API

Fjerner Git-tilkoblingen fra en datavers løsning eller et miljø, og deaktiverer kildekontrollintegrering.

Parameter

DisconnectFromGit API-en har bare én parameter.

Parameter	Type	Påkrevd	Beskrivelse
`SolutionUniqueName`	String	Nei	Det unike navnet på løsningen du vil koble fra Git. Utelate å koble fra alle løsninger eller miljøet.

Tilleggsinformasjon

Her er noen alternativer for parameterverdi du kan angi når du aktiverer DisconnectFromGit.

Koble fra én enkelt løsning: Angi SolutionUniqueName at du skal koble fra en bestemt løsning.
Koble fra alle løsninger: Gir ingen parametere for å koble fra alle tilkoblinger på løsningsnivå.
Frakoblingsmiljø: Gir ingen parametere for å koble fra tilkoblingen på miljønivå.

Eksempler

Eksemplene nedenfor beskriver scenarioer for bruk ConnectToGit og DisconnectFromGit API-er:

Koble hele dataversmiljøet til et Azure DevOps-repositorium
Koble fra hele datavers-miljøet ditt fra Git-kildekontroll
Koble den første løsningen til et Git-repositorium
Koble ekstra løsninger til samme Git-repositorium etter at du har koblet til den opprinnelige løsningen
Koble fra en bestemt løsning fra Git-kildekontrollen samtidig som andre løsninger er tilkoblet

Koble hele dataversmiljøet til et Azure DevOps-repositorium

Denne tilkoblingen aktiverer kildekontroll for alle konfigurasjoner og komponenter på miljønivå.

Ikke bruk disse parameterne med denne tilkoblingen:

RootFolder
SolutionUniqueName
UpstreamBranch

Nett-API
SDK for .NET

Dette eksemplet viser hvordan du bruker Handlingen ConnectToGit til å koble hele dataversmiljøet til et Azure DevOps-repositorium.

Be om

POST [Organization URI]/api/data/v9.2/ConnectToGit HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
   "GitFolder": "yourGitfolderName",
   "Branch": "yourBranchName",
   "ConnectionType": 1,
   "GitProvider": 0,
   "Organization": "yourOrganizationName",
   "Project": "yourProjectName",
   "Repository": "yourRepositoryName"
}

Svar

HTTP/1.1 204 No Content
OData-Version: 4.0

Finn ut hvordan du aktiverer web-API-handlinger

Denne statiske ConnectDataverseEnvironment metoden viser hvordan du bruker ConnectToGit meldingen til å koble hele dataversmiljøet til et Azure DevOps-repositorium.

private const int GitProviderAzureDevOps = 0;
private const int GitProviderGitHub = 1;
private const int ConnectionTypeEnvironment = 1;

static void ConnectDataverseEnvironment(
    IOrganizationService service,
    string gitFolderName,
    string branchName,
    string organizationName,
    string projectName,
    string repositoryName,
    OptionSetValue? gitProvider = null)
{
    // Validate required parameters
    ArgumentNullException.ThrowIfNull(service);
    ArgumentException.ThrowIfNullOrWhiteSpace(gitFolderName);
    ArgumentException.ThrowIfNullOrWhiteSpace(branchName);
    ArgumentException.ThrowIfNullOrWhiteSpace(organizationName);
    ArgumentException.ThrowIfNullOrWhiteSpace(projectName);
    ArgumentException.ThrowIfNullOrWhiteSpace(repositoryName);

    // Default to Azure Dev Ops
    gitProvider ??= new OptionSetValue(GitProviderAzureDevOps);

    ParameterCollection parameters = new()
    {
        { "GitFolder", gitFolderName },
        { "Branch", branchName },
        { "ConnectionType", new OptionSetValue(ConnectionTypeEnvironment) },
        { "GitProvider", gitProvider },
        { "Organization", organizationName },
        { "Project", projectName },
        { "Repository", repositoryName }
    };

    OrganizationRequest request = new()
    {
        RequestName = "ConnectToGit",
        Parameters = parameters
    };

     service.Execute(request);
}

Lær hvordan du aktiverer Dataverse-meldinger ved hjelp av SDK for .NET

Koble fra hele Dataverse-miljøet fra Git-versjonskontroll

Denne handlingen fjerner git-tilkoblingen på miljønivå. Ikke bruk parameteren SolutionUniqueName for denne operasjonen. Datavers identifiserer og fjerner automatisk Git-tilkoblingen på miljønivå.

Nett-API
SDK for .NET

Dette eksemplet viser hvordan du bruker handlingen DisconnectFromGit til å koble hele dataversmiljøet fra Git-kildekontrollen.

Be om

POST [Organization URI]/api/data/v9.2/DisconnectFromGit HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

Svar

HTTP/1.1 204 No Content
OData-Version: 4.0

Finn ut hvordan du aktiverer web-API-handlinger

Den statiske DisconnectDataverseEnvironment metoden kobler hele dataversmiljøet fra Git-kildekontrollen.

static void DisconnectDataverseEnvironment(IOrganizationService service) {

   // Validate required parameters
    ArgumentNullException.ThrowIfNull(service);

   OrganizationRequest request = new("DisconnectFromGit");

   service.Execute(request);

}

Lær hvordan du aktiverer Dataverse-meldinger ved hjelp av SDK for .NET

Koble den første løsningen til et Git-repositorium

Denne tilkoblingen etablerer repositoriumkoblingen og mappestrukturen for kildekontroll på løsningsnivå til den første løsningen i et miljø.

Du må inkludere verdier for disse parameterne for å angi løsningen:

RootFolder
SolutionUniqueName

Nett-API
SDK for .NET

Dette eksemplet viser hvordan du bruker handlingen ConnectToGit til å koble den første løsningen til et Git-repositorium.

Be om

POST [Organization URI]/api/data/v9.2/ConnectToGit HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
   "GitFolder": "yourGitfolderName",
   "Branch": "yourBranchName",
   "ConnectionType": 1,
   "GitProvider": 0,
   "Organization": "yourOrganizationName",
   "Project": "yourProjectName",
   "Repository": "yourRepositoryName",
   "RootFolder": "yourRootFolderName",
   "SolutionUniqueName": "yourSolutionUniqueName"
}

Svar

HTTP/1.1 204 No Content
OData-Version: 4.0

Finn ut hvordan du aktiverer web-API-handlinger

Den statiske ConnectFirstSolution metoden viser hvordan du kobler den første løsningen til et Git-repositorium.

private const int ConnectionTypeSolution = 0;

static void ConnectFirstSolution(
    IOrganizationService service,
    string gitFolderName,
    string branchName,
    string organizationName,
    string projectName,
    string repositoryName,
    string rootFolderName,
    string solutionUniqueName,
    OptionSetValue? gitProvider = null)
{
    // Validate required parameters
    ArgumentNullException.ThrowIfNull(service);
    ArgumentException.ThrowIfNullOrWhiteSpace(gitFolderName);
    ArgumentException.ThrowIfNullOrWhiteSpace(branchName);
    ArgumentException.ThrowIfNullOrWhiteSpace(organizationName);
    ArgumentException.ThrowIfNullOrWhiteSpace(projectName);
    ArgumentException.ThrowIfNullOrWhiteSpace(repositoryName);
    ArgumentException.ThrowIfNullOrWhiteSpace(rootFolderName);
    ArgumentException.ThrowIfNullOrWhiteSpace(solutionUniqueName);

    // Default to Azure Dev Ops
    gitProvider ??= new OptionSetValue(GitProviderAzureDevOps);

    ParameterCollection parameters = new()
    {
        { "GitFolder", gitFolderName },
        { "Branch", branchName },
        { "ConnectionType", new OptionSetValue(ConnectionTypeSolution) },
        { "GitProvider", gitProvider },
        { "Organization", organizationName },
        { "Project", projectName },
        { "Repository", repositoryName },
        { "RootFolder", rootFolderName },
        { "SolutionUniqueName", solutionUniqueName }
    };

    OrganizationRequest request = new()
    {
        RequestName = "ConnectToGit",
        Parameters = parameters
    };

    service.Execute(request);
}

Lær hvordan du aktiverer Dataverse-meldinger ved hjelp av SDK for .NET

Koble ekstra løsninger til samme Git-repositorium etter at du har koblet til den opprinnelige løsningen

Når du har koblet til den første løsningen, trenger du bare de løsningsspesifikke parameterne. Du arver tilkoblingsdetaljene for repositoriet fra den første tilkoblingen.

Angi bare disse parameterne:

SolutionUniqueName
Branch
GitFolder

Viktig!

Du må først koble til den første løsningen før dette fungerer. Se Koble den første løsningen til et Git-repositorium.

Nett-API
SDK for .NET

Dette eksemplet viser hvordan du bruker handlingen ConnectToGit til å koble etterfølgende løsninger til et Git-repositorium.

Be om

POST [Organization URI]/api/data/v9.2/ConnectToGit HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
   "GitFolder": "yourGitfolderName",
   "Branch": "yourBranchName",
   "SolutionUniqueName": "yourSolutionUniqueName"
}

Svar

HTTP/1.1 204 No Content
OData-Version: 4.0

Finn ut hvordan du aktiverer web-API-handlinger

Den statiske ConnectExtraSolution metoden viser hvordan du kobler etterfølgende løsninger til et Git-repositorium.

static void ConnectExtraSolution(
   IOrganizationService service,
   string gitFolderName,
   string branchName,
   string solutionUniqueName)
{
   // Validate required parameters
   ArgumentNullException.ThrowIfNull(service);
   ArgumentException.ThrowIfNullOrWhiteSpace(gitFolderName);
   ArgumentException.ThrowIfNullOrWhiteSpace(branchName);
   ArgumentException.ThrowIfNullOrWhiteSpace(solutionUniqueName);

   ParameterCollection parameters = new()
   {
         { "GitFolder", gitFolderName },
         { "Branch", branchName },
         { "SolutionUniqueName", solutionUniqueName }
   };

   OrganizationRequest request = new()
   {
         RequestName = "ConnectToGit",
         Parameters = parameters
   };

   service.Execute(request);
}

Lær hvordan du aktiverer Dataverse-meldinger ved hjelp av SDK for .NET

Koble fra en bestemt løsning fra Git-kildekontrollen samtidig som andre løsninger er tilkoblet

Bruk denne fremgangsmåten til å fjerne kildekontroll for én løsning uten å påvirke andre.

Nett-API
SDK for .NET

Dette eksemplet viser hvordan du bruker handlingen DisconnectFromGit til å fjerne kildekontroll for én løsning uten å påvirke andre.

Be om

POST [Organization URI]/api/data/v9.2/DisconnectFromGit HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
   "SolutionUniqueName": "yourSolutionUniqueName"
}

Svar

HTTP/1.1 204 No Content
OData-Version: 4.0

Finn ut hvordan du aktiverer web-API-handlinger

Den statiske DisconnectSolution metoden fjerner kildekontroll for én løsning uten å påvirke andre.

static void DisconnectSolution(IOrganizationService service,
    string solutionUniqueName)
{

   // Validate required parameters
    ArgumentNullException.ThrowIfNull(service);
    ArgumentException.ThrowIfNullOrWhiteSpace(solutionUniqueName);

    ParameterCollection parameters = new()
    {
        { "SolutionUniqueName", solutionUniqueName }
    };

    OrganizationRequest request = new()
    {
        RequestName = "DisconnectFromGit",
        Parameters = parameters
    };

    service.Execute(request);
}

Lær hvordan du aktiverer Dataverse-meldinger ved hjelp av SDK for .NET

Feilbehandling

Verken ConnectToGit eller DisconnectFromGit API-en returnerer en verdi når de er fullført. Når en API mislykkes, returnerer den en feil.

Vanlige feilscenarioer inkluderer:

Ugyldig legitimasjon: Kontroller at du har gyldig godkjenning til Git-leverandøren.
Finner ikke repositorium: Kontroller organisasjonen, prosjektet og repositoriumnavnene.
Ingen tillatelse: Kontroller at Dataverse-kontoen har tillatelser for kildekontrolladministrasjon.
Finner ikke løsningen: Kontroller at det SolutionUniqueName finnes i miljøet.
Grenen finnes ikke: Bekreft at den angitte grenen finnes i repositoriet.

Støtte og tilleggsressurser

Hvis du vil ha mer informasjon om kildekontrollintegrering med Datavers, kan du se:

Tilbakemeldinger

Var denne siden nyttig?

Last updated on 2026-03-27

Del via

Koble til og koble datavers fra et Git-repositorium ved hjelp av kode

Forutsetninger

ConnectToGit API

Parametere

ConnectionType-parameter

GitProvider-parameter

DisconnectFromGit API

Parameter

Tilleggsinformasjon

Eksempler

Koble hele dataversmiljøet til et Azure DevOps-repositorium

Koble fra hele Dataverse-miljøet fra Git-versjonskontroll

Koble den første løsningen til et Git-repositorium

Koble ekstra løsninger til samme Git-repositorium etter at du har koblet til den opprinnelige løsningen

Koble fra en bestemt løsning fra Git-kildekontrollen samtidig som andre løsninger er tilkoblet

Feilbehandling

Støtte og tilleggsressurser

Tilbakemeldinger

Flere ressurser