"Dataverse" prijungimas ir atjungimas nuo "Git" saugyklos naudojant kodą

Naudokite ConnectToGit ir DisconnectFromGit API, kad programiškai integruotumėte "Microsoft Dataverse" aplinką su "Git" šaltinio valdikliu. Naudodami šias API galite prijungti atskirus sprendimus arba ištisas aplinkas prie "Git" saugyklų, nuomojamų "Azure DevOps", ir valdyti tuos ryšius naudodami kodą.

Svarbu

"Azure DevOps" šiuo metu yra vienintelis palaikomas "Git" teikėjas.

Būtinosios sąlygos

Prieš naudodami šias API įsitikinkite, kad turite:

Prieiga prie "Microsoft Dataverse" aplinkos
Sistemos administratoriaus teisės
Skaitymo ir rašymo prieiga prie "Git" saugyklos

ConnectToGit API

Sukuria ryšį tarp "Dataverse" sprendimo arba aplinkos ir "Git" saugyklos. Naudodami šį ryšį galite valdyti savo "Dataverse" komponentų šaltinio valdymą.

Parametrai

API ConnectToGit priima šiuos parametrus:

Parametras	Tipas	Būtina	Aprašą
`GitFolder`	Eilutė	Taip	Aplanko, su kuriuo norite susieti sprendimą arba aplinką, pavadinimas.
`Branch`	Eilutė	Taip	Šakos, prie kurios norite prisijungti, pavadinimas.
`ConnectionType`	Sveikasis skaičius	Ne	Nurodo, prie ko prisijungti. Žiūrėkite parametrą ConnectionType.
`GitProvider`	Sveikasis skaičius	Ne	Git teikėjas. Žr. parametrą GitProvider.
`Organization`	Eilutė	Ne	Organizacijos, prie kurios norite prisijungti, pavadinimas.
`Project`	Eilutė	Ne	Projekto, prie kurio norite prisijungti, pavadinimas.
`Repository`	Eilutė	Ne	Saugyklos, prie kurios norite prisijungti, pavadinimas.
`RootFolder`	Eilutė	Ne	Šakninio aplanko, kuriame yra visi jūsų sprendimai sprendimo aprėptyje, pavadinimas.
`SolutionUniqueName`	Eilutė	Ne	Unikalus sprendimo, kurį norite prijungti prie git, pavadinimas.
`UpstreamBranch`	Eilutė	Ne	Pradinės šakos, prie kurios norite prisijungti, pavadinimas. Numatytoji saugyklos šaka.

ConnectionType parametras

Parametras ConnectionType kontroliuoja, ar prisijungti prie visos "Dataverse" aplinkos, ar prie konkretaus sprendimo.

Reikšmė	Žyma	Aprašą
0	Sprendimas	Prijungia konkretų "Dataverse" sprendimą prie "Git".
1	Aplinka	Sujungia visą "Dataverse" aplinką su "Git".

GitProvider parametras

Naudokite parametrą, GitProvider kad nurodytumėte naudojamo "Git" teikėjo tipą – "Azure DevOps" arba "GitHub".

Reikšmė	Žyma	Aprašą
0	Azure DevOps	Naudokite saugykloms, nuomojamoms "Azure DevOps"
1	GitHub	Naudokite "GitHub" talpinamoms saugykloms

DisconnectFromGit API

Pašalina "Git" ryšį iš "Dataverse" sprendimo ar aplinkos ir išjungia šaltinio valdymo integravimą.

Parametras

API DisconnectFromGit turi tik vieną parametrą.

Parametras	Tipas	Būtina	Aprašą
`SolutionUniqueName`	Eilutė	Ne	Unikalus sprendimo, kurį norite atjungti nuo "Git", pavadinimas. Atjungti visus sprendimus ar aplinką.

Papildoma informacija

Štai keletas parametrų reikšmių parinkčių, kurias reikia nurodyti iškviečiant DisconnectFromGit.

Atjungti vieną sprendimą: numatyti SolutionUniqueName atjungti konkretų sprendimą.
Atjungti visus sprendimus: nepateikite parametrų, kad atjungtumėte visus sprendimo lygio ryšius.
Atjungti aplinką: nepateikite parametrų, kad atjungtumėte aplinkos lygio ryšį.

Pavyzdžiai

Toliau pateiktuose pavyzdžiuose aprašomi API naudojimo ConnectToGitDisconnectFromGit scenarijai:

Visos "Dataverse" aplinkos prijungimas prie "Azure DevOps" saugyklos
Visos "Dataverse" aplinkos atjungimas nuo "Git" šaltinio valdiklio
Prijunkite pirmąjį sprendimą prie "Git" saugyklos
Prijungę pradinį sprendimą prijunkite papildomus sprendimus prie tos pačios "Git" saugyklos
Konkretaus sprendimo atjungimas nuo "Git" šaltinio valdiklio, išlaikant prijungtus kitus sprendimus

Visos "Dataverse" aplinkos prijungimas prie "Azure DevOps" saugyklos

Šis ryšys įgalina visų aplinkos lygio konfigūracijų ir komponentų šaltinio valdymą.

Nenaudokite šių parametrų su šiuo ryšiu:

RootFolder
SolutionUniqueName
UpstreamBranch

Žiniatinklio API
.NET skirtas SDK

Šiame pavyzdyje parodyta, kaip naudoti veiksmą "ConnectToGit ", kad visa "Dataverse" aplinka būtų prijungta prie "Azure DevOps" saugyklos.

Užklausa

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"
}

Response

HTTP/1.1 204 No Content
OData-Version: 4.0

Sužinokite, kaip iškviesti žiniatinklio API veiksmus

Šis statinis ConnectDataverseEnvironment metodas parodo, kaip naudoti ConnectToGit pranešimą norint prijungti visą "Dataverse" aplinką prie "Azure DevOps" saugyklos.

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);
}

Sužinokite, kaip iškviesti "Dataverse" pranešimus naudojant .NET skirtą SDK

Visos "Dataverse" aplinkos atjungimas nuo "Git" šaltinio valdiklio

Šis veiksmas pašalina aplinkos lygio Git ryšį. Nenaudokite parametro SolutionUniqueName šiai operacijai. "Dataverse" automatiškai identifikuoja ir pašalina aplinkos lygio "Git" ryšį.

Žiniatinklio API
.NET skirtas SDK

Šiame pavyzdyje parodyta, kaip naudoti veiksmą DisconnectFromGit , kad atjungtumėte visą "Dataverse" aplinką nuo "Git" šaltinio valdiklio.

Užklausa

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

Response

HTTP/1.1 204 No Content
OData-Version: 4.0

Sužinokite, kaip iškviesti žiniatinklio API veiksmus

Statinis DisconnectDataverseEnvironment metodas atjungia visą "Dataverse" aplinką nuo "Git" šaltinio valdiklio.

static void DisconnectDataverseEnvironment(IOrganizationService service) {

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

   OrganizationRequest request = new("DisconnectFromGit");

   service.Execute(request);

}

Sužinokite, kaip iškviesti "Dataverse" pranešimus naudojant .NET skirtą SDK

Prijunkite pirmąjį sprendimą prie "Git" saugyklos

Šis ryšys sukuria saugyklos saitą ir aplanko struktūrą, skirtą sprendimo lygio šaltinio valdymui su pirmuoju sprendimu aplinkoje.

Norėdami nurodyti sprendimą, turite įtraukti šių parametrų reikšmes:

RootFolder
SolutionUniqueName

Žiniatinklio API
.NET skirtas SDK

Šiame pavyzdyje parodyta, kaip naudoti veiksmą "ConnectToGit ", kad pirmasis sprendimas būtų prijungtas prie "Git" saugyklos.

Užklausa

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"
}

Response

HTTP/1.1 204 No Content
OData-Version: 4.0

Sužinokite, kaip iškviesti žiniatinklio API veiksmus

Statinis ConnectFirstSolution metodas parodo, kaip prijungti pirmąjį sprendimą prie "Git" saugyklos.

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);
}

Sužinokite, kaip iškviesti "Dataverse" pranešimus naudojant .NET skirtą SDK

Prijungę pradinį sprendimą prijunkite papildomus sprendimus prie tos pačios "Git" saugyklos

Prijungus pirmąjį sprendimą, jums reikia tik konkretaus sprendimo parametrų. Saugyklos ryšio informaciją paveldėsite iš pradinio ryšio.

Nustatykite tik šiuos parametrus:

SolutionUniqueName
Branch
GitFolder

Svarbu

Pirmiausia turite prijungti pirmąjį sprendimą, kad tai veiktų. Žr. Pirmojo sprendimo prijungimas prie "Git" saugyklos.

Žiniatinklio API
.NET skirtas SDK

Šiame pavyzdyje parodyta, kaip naudoti veiksmą ConnectToGit , kad vėlesni sprendimai būtų prijungti prie "Git" saugyklos.

Užklausa

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"
}

Response

HTTP/1.1 204 No Content
OData-Version: 4.0

Sužinokite, kaip iškviesti žiniatinklio API veiksmus

Statinis ConnectExtraSolution metodas parodo, kaip prijungti vėlesnius sprendimus prie Git saugyklos.

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);
}

Sužinokite, kaip iškviesti "Dataverse" pranešimus naudojant .NET skirtą SDK

Konkretaus sprendimo atjungimas nuo "Git" šaltinio valdiklio, išlaikant prijungtus kitus sprendimus

Naudokite šį metodą, jei norite pašalinti vieno sprendimo šaltinio kontrolę, nepaveikdami kitų.

Žiniatinklio API
.NET skirtas SDK

Šiame pavyzdyje parodyta, kaip naudoti veiksmą DisconnectFromGit , kad pašalintumėte vieno sprendimo šaltinio valdiklį nepaveikdami kitų.

Užklausa

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"
}

Response

HTTP/1.1 204 No Content
OData-Version: 4.0

Sužinokite, kaip iškviesti žiniatinklio API veiksmus

Statinis DisconnectSolution metodas pašalina vieno sprendimo šaltinio kontrolę, nepaveikdamas kitų.

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);
}

Sužinokite, kaip iškviesti "Dataverse" pranešimus naudojant .NET skirtą SDK

Klaidų tvarkymas

Nei nei ConnectToGitDisconnectFromGit API negrąžina reikšmės, kai ji sėkmingai baigiama. Kai API nepavyksta, ji pateikia klaidą.

Dažniausi klaidų scenarijai:

Netinkami kredencialai: įsitikinkite, kad turite galiojantį "Git" teikėjo autentifikavimą.
Saugykla nerasta: patikrinkite organizacijos, projekto ir saugyklos pavadinimus.
Leidimas uždraustas: įsitikinkite, kad jūsų "Dataverse" paskyra turi šaltinio valdymo teises.
Sprendimas nerastas: patikrinkite, ar SolutionUniqueName jūsų aplinkoje yra.
Šakos nėra: patvirtinkite, kad saugykloje yra nurodyta šaka.

Palaikymas ir papildomi ištekliai

Daugiau informacijos apie šaltinio valdiklio integravimą su "Dataverse" žr.:

Atsiliepimai

Ar šis puslapis buvo naudingas?

Last updated on 2026-05-01

"Dataverse" prijungimas ir atjungimas nuo "Git" saugyklos naudojant kodą

Būtinosios sąlygos

ConnectToGit API

Parametrai

ConnectionType parametras

GitProvider parametras

DisconnectFromGit API

Parametras

Papildoma informacija

Pavyzdžiai

Visos "Dataverse" aplinkos prijungimas prie "Azure DevOps" saugyklos

Visos "Dataverse" aplinkos atjungimas nuo "Git" šaltinio valdiklio

Prijunkite pirmąjį sprendimą prie "Git" saugyklos

Prijungę pradinį sprendimą prijunkite papildomus sprendimus prie tos pačios "Git" saugyklos

Konkretaus sprendimo atjungimas nuo "Git" šaltinio valdiklio, išlaikant prijungtus kitus sprendimus

Klaidų tvarkymas

Palaikymas ir papildomi ištekliai

Atsiliepimai

Papildomi ištekliai