Povežite in odklopite Dataverse od Git repozitorija z uporabo kode

Uporabite API-je ConnectToGit in DisconnectFromGit za programsko integracijo vašega Microsoft Dataverse okolja z Git nadzorom izvorne kode. Z uporabo teh API-jev lahko povežete posamezne rešitve ali celotna okolja z Git repozitoriji, ki gostujejo na Azure DevOps, in te povezave upravljate preko kode.

Pomembno

Azure DevOps je trenutno edini podprti ponudnik Gita.

Zahteve

Pred uporabo teh API-jev se prepričajte, da imate:

Dostop do okolja Microsoft Dataverse
Dovoljenja sistemskega skrbnika
Dostop za branje in pisanje v Git repozitorij

ConnectToGit API

Vzpostavi povezavo med rešitvijo ali okoljem Dataverse in Git repozitorijem. S to povezavo lahko upravljate nadzor izvorne kode za svoje Dataverse komponente.

Parametri

API ConnectToGit sprejema naslednje parametre:

Parameter	Tip	Zahtevano	Description
`GitFolder`	Niz	Da	Ime mape, na katero želite povezati svojo rešitev ali okolje.
`Branch`	Niz	Da	Ime podružnice, na katero se želite povezati.
`ConnectionType`	Integer	Ne	Določa, na kaj se priključiti. Glej parameter ConnectionType.
`GitProvider`	Integer	Ne	Git ponudnik. Glej parameter GitProvider.
`Organization`	Niz	Ne	Ime organizacije, s katero želite vzpostaviti povezavo.
`Project`	Niz	Ne	Ime projekta, s katerim se želiš povezati.
`Repository`	Niz	Ne	Ime repozitorija, na katerega se želite povezati.
`RootFolder`	Niz	Ne	Ime korenske mape, kjer se nahajajo vse vaše rešitve v obsegu rešitve.
`SolutionUniqueName`	Niz	Ne	Edinstveno ime rešitve, ki jo želite povezati z gitom.
`UpstreamBranch`	Niz	Ne	Ime zgornje veje, na katero se želite povezati. Privzeto se nastavi na privzeto vejo repozitorija.

Parameter ConnectionType

Parameter določa, ConnectionType ali se povezati s celotnim okoljem Dataverse ali z določeno rešiljo.

Vrednost	Oznaka	Description
0	Rešitev	Poveže določeno rešitev Dataverse z Gitom.
1	Okolje	Povezuje celotno okolje Dataverse z Gitom.

Parameter GitProvider

Uporabite GitProvider parameter za določitev vrste ponudnika Gita, ki ga uporabljate, bodisi Azure DevOps ali GitHub.

Vrednost	Oznaka	Description
0	Azure DevOps	Uporaba za repozitorije, gostovane na Azure DevOps
1	GitHub	Uporaba za repozitorije, gostovane na GitHubu

DisconnectFromGit API

Odstrani Git povezavo iz rešitve ali okolja Dataverse in onemogoči integracijo upravljanja izvorne različice.

Parameter

API DisconnectFromGit ima le en parameter.

Parameter	Tip	Zahtevano	Description
`SolutionUniqueName`	Niz	Ne	Edinstveno ime rešitve, ki jo želiš odklopiti od Gita. Izpustite odklop vseh rešitev ali okolja.

Dodatne informacije

Tukaj je nekaj možnosti vrednosti parametrov, ki jih je treba določiti pri klicu DisconnectFromGit.

Odklopi eno rešitev: Omogoči SolutionUniqueName odklop določene rešitve.
Odklopite vse rešitve: Ne navedite nobenih parametrov za prekinitev vseh povezav na ravni rešitve.
Okolje za odklop: Ne navedite nobenih parametrov za prekinitev povezave na ravni okolja.

Primeri

Naslednji primeri opisujejo scenarije za uporabo ConnectToGit in DisconnectFromGit API-jev:

Povežite celotno okolje Dataverse z Azure DevOps repozitorijem
Odklopite celotno okolje Dataverse od Git nadzora izvorne kode
Prvo rešitev povežite z Git repozitorijem
Po priključitvi začetne rešitve povežite dodatne rešitve v isti Git repozitorij
Odklopite določeno rešitev od Git upravljanja izvorne kodne datoteke, medtem ko druge rešitve ohranite povezane

Povežite celotno okolje Dataverse z Azure DevOps repozitorijem

Ta povezava omogoča nadzor izvorne kode za vse konfiguracije in komponente na ravni okolja.

Ne uporabljajte teh parametrov s to povezavo:

RootFolder
SolutionUniqueName
UpstreamBranch

Spletni API
SDK za .NET

Ta primer prikazuje, kako uporabiti dejanje ConnectToGit za povezavo celotnega okolja Dataverse z Azure DevOps repozitorijem.

Zahteva

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

Odziv

HTTP/1.1 204 No Content
OData-Version: 4.0

Naučite se, kako sprožiti dejanja spletnega API-ja

Ta statična ConnectDataverseEnvironment metoda pokaže, kako uporabiti ConnectToGit sporočilo za povezavo celotnega okolja Dataverse z Azure DevOps repozitorijem.

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

Naučite se, kako klicati Dataverse sporočila z uporabo SDK za .NET

Odklopite celotno okolje Dataverse od Git nadzora izvorne kode

Ta ukrep odstrani povezavo z Git na ravni okolja. Za to operacijo ne uporabljajte parametra SolutionUniqueName . Dataverse samodejno prepozna in odstrani Git povezavo na ravni okolja.

Spletni API
SDK za .NET

Ta primer prikazuje, kako uporabiti dejanje DisconnectFromGit za odklop celotnega okolja Dataverse od nadzora izvorne kode Gita.

Zahteva

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

Odziv

HTTP/1.1 204 No Content
OData-Version: 4.0

Naučite se, kako sprožiti dejanja spletnega API-ja

Statična DisconnectDataverseEnvironment metoda odklopi celotno okolje Dataverse od nadzora izvorne kode na Gitu.

static void DisconnectDataverseEnvironment(IOrganizationService service) {

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

   OrganizationRequest request = new("DisconnectFromGit");

   service.Execute(request);

}

Naučite se, kako klicati Dataverse sporočila z uporabo SDK za .NET

Prvo rešitev povežite z Git repozitorijem

Ta povezava vzpostavi povezavo repozitorija in strukturo map za nadzor izvorne kode na ravni rešitve do prve rešitve v okolju.

Za določitev rešitve morate vključiti vrednosti za te parametre:

RootFolder
SolutionUniqueName

Spletni API
SDK za .NET

Ta primer prikazuje, kako uporabiti dejanje ConnectToGit za povezavo prve rešitve z Git repozitorijem.

Zahteva

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

Odziv

HTTP/1.1 204 No Content
OData-Version: 4.0

Naučite se, kako sprožiti dejanja spletnega API-ja

Statična ConnectFirstSolution metoda pokaže, kako povezati prvo rešitev z Git repozitorijem.

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

Naučite se, kako klicati Dataverse sporočila z uporabo SDK za .NET

Po priključitvi začetne rešitve povežite dodatne rešitve v isti Git repozitorij

Ko povežete prvo rešitev, potrebujete le parametre, specifične za rešitev. Podatke o povezavi repozitorija podedujete iz začetne povezave.

Nastavite le te parametre:

SolutionUniqueName
Branch
GitFolder

Pomembno

Najprej morate povezati prvo rešitev, preden deluje. Glej Poveži prvo rešitev z Git repozitorijem.

Spletni API
SDK za .NET

Ta primer prikazuje, kako uporabiti dejanje ConnectToGit za povezavo naslednjih rešitev z Git repozitorijem.

Zahteva

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

Odziv

HTTP/1.1 204 No Content
OData-Version: 4.0

Naučite se, kako sprožiti dejanja spletnega API-ja

Statična ConnectExtraSolution metoda pokaže, kako povezati naslednje rešitve z Git repozitorijem.

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

Naučite se, kako klicati Dataverse sporočila z uporabo SDK za .NET

Odklopite določeno rešitev od Git upravljanja izvorne kodne datoteke, medtem ko druge rešitve ohranite povezane

Uporabite ta pristop za odstranitev nadzora izvorne kode za eno rešitev, ne da bi vplivali na druge.

Spletni API
SDK za .NET

Ta primer prikazuje, kako uporabiti dejanje DisconnectFromGit za odstranitev nadzora izvorne kode za eno rešitev, ne da bi vplival na druge.

Zahteva

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

Odziv

HTTP/1.1 204 No Content
OData-Version: 4.0

Naučite se, kako sprožiti dejanja spletnega API-ja

Statična DisconnectSolution metoda odstrani nadzor izvorne kode za eno rešitev, ne da bi vplivala na druge.

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

Naučite se, kako klicati Dataverse sporočila z uporabo SDK za .NET

Obravnavanje napak

Niti the ConnectToGit niti API ne vrneta DisconnectFromGit vrednosti, ko se uspešno zaključi. Ko API odpove, vrne napako.

Pogosti primeri napak vključujejo:

Neveljavne poverilnice: Preverite, ali imate veljavno avtentikacijo pri ponudniku Gita.
Repozitorij ni najden: Preverite imena organizacije, projektov in repozitorijev.
Dovoljenje zavrnjeno: Poskrbite, da ima vaš račun Dataverse dovoljenja za upravljanje nadzora izvorne kode.
Rešitev ni našla: Preverite, ali obstaja SolutionUniqueName v vašem okolju.
Veja ne obstaja: Potrdite, da določena veja obstaja v repozitoriju.

Podpora in dodatni viri

Za več informacij o integraciji upravljanja kodo z Dataverse glejte:

Povratne informacije

Ali je bila ta stran uporabna?

Last updated on 2026-05-01

Povežite in odklopite Dataverse od Git repozitorija z uporabo kode

Zahteve

ConnectToGit API

Parametri

Parameter ConnectionType

Parameter GitProvider

DisconnectFromGit API

Parameter

Dodatne informacije

Primeri

Povežite celotno okolje Dataverse z Azure DevOps repozitorijem

Odklopite celotno okolje Dataverse od Git nadzora izvorne kode

Prvo rešitev povežite z Git repozitorijem

Po priključitvi začetne rešitve povežite dodatne rešitve v isti Git repozitorij

Odklopite določeno rešitev od Git upravljanja izvorne kodne datoteke, medtem ko druge rešitve ohranite povezane

Obravnavanje napak

Podpora in dodatni viri

Povratne informacije

Dodatni viri