Sambungkan dan putuskan sambungan Dataverse daripada repositori Git dengan menggunakan kod

Gunakan ConnectToGit API dan DisconnectFromGit untuk menyepadukan persekitaran Microsoft Dataverse anda secara terprogram dengan kawalan sumber Git. Dengan menggunakan API ini, anda boleh menyambungkan penyelesaian individu atau keseluruhan persekitaran ke repositori Git yang dihoskan pada Azure DevOps dan mengurus sambungan tersebut melalui kod.

Penting

Azure DevOps pada masa ini merupakan satu-satunya pembekal Git yang disokong.

Prasyarat

Sebelum menggunakan API ini, pastikan anda mempunyai:

• Akses kepada persekitaran Microsoft Dataverse
• Kebenaran pentadbir sistem
• Baca dan tulis akses kepada repositori Git

ConnectToGit API

Mencipta sambungan antara penyelesaian atau persekitaran Dataverse dan repositori Git. Dengan menggunakan sambungan ini, anda boleh mengurus kawalan sumber untuk komponen Dataverse anda.

Parameter

ConnectToGit API menerima parameter berikut:

Parameter_	Jenis	Diperlukan	Perihalan
GitFolder	String	Ya	Nama folder yang anda mahu ikat penyelesaian atau persekitaran anda.
Branch	String	Ya	Nama cawangan yang anda mahu sambungkan.
ConnectionType	Integer	Tidak	Menentukan perkara yang hendak disambungkan. Lihat parameter ConnectionType.
GitProvider	Integer	Tidak	Pembekal Git. Lihat parameter GitProvider.
Organization	String	Tidak	Nama organisasi yang anda mahu sambungkan.
Project	String	Tidak	Nama projek yang anda mahu sambungkan.
Repository	String	Tidak	Nama repositori yang anda mahu sambungkan.
RootFolder	String	Tidak	Nama folder akar di mana semua penyelesaian anda berada dalam skop penyelesaian.
SolutionUniqueName	String	Tidak	Nama unik penyelesaian yang anda ingin sambungkan ke git.
UpstreamBranch	String	Tidak	Nama cawangan huluan yang anda mahu sambungkan. Lalai kepada cawangan lalai repositori.

Parameter ConnectionType

Parameter mengawal ConnectionType sama ada untuk menyambung ke keseluruhan persekitaran Dataverse atau penyelesaian tertentu.

Nilai	Label	Perihalan
0	Penyelesaian	Menyambungkan penyelesaian Dataverse tertentu ke Git.
1	Persekitaran	Menyambungkan keseluruhan persekitaran Dataverse ke Git.

Parameter GitProvider

Gunakan GitProvider parameter untuk menentukan jenis pembekal Git yang anda gunakan, sama ada Azure DevOps atau GitHub.

Nilai	Label	Perihalan
0	Azure DevOps	Gunakan untuk repositori yang dihoskan pada Azure DevOps
1	GitHub	Gunakan untuk repositori yang dihoskan pada GitHub

API Putuskan Sambungan DariGit

Mengalih keluar sambungan Git daripada penyelesaian atau persekitaran Dataverse dan menyahdayakan penyepaduan kawalan sumber.

Parameter_

DisconnectFromGit API hanya mempunyai satu parameter.

Parameter_	Jenis	Diperlukan	Perihalan
SolutionUniqueName	String	Tidak	Nama unik penyelesaian yang anda mahu putuskan sambungan daripada Git. Jangan putuskan sambungan semua penyelesaian atau persekitaran.

Maklumat tambahan

Berikut ialah beberapa pilihan nilai parameter untuk ditentukan semasa memanggil DisconnectFromGit.

• Putuskan sambungan penyelesaian tunggal: Sediakan SolutionUniqueName untuk memutuskan sambungan penyelesaian tertentu.
• Putuskan sambungan semua penyelesaian: Sediakan tiada parameter untuk memutuskan sambungan semua sambungan peringkat penyelesaian.
• Putuskan sambungan persekitaran: Sediakan tiada parameter untuk memutuskan sambungan peringkat persekitaran.

Contoh

Contoh berikut menerangkan senario untuk penggunaan ConnectToGit dan DisconnectFromGit API:

• Sambungkan keseluruhan persekitaran Dataverse anda ke repositori Azure DevOps
• Putuskan sambungan keseluruhan persekitaran Dataverse anda daripada kawalan sumber Git
• Sambungkan penyelesaian pertama ke repositori Git
• Sambungkan penyelesaian tambahan ke repositori Git yang sama selepas anda menyambungkan penyelesaian awal
• Putuskan sambungan penyelesaian tertentu daripada kawalan sumber Git sambil memastikan penyelesaian lain disambungkan

Sambungkan keseluruhan persekitaran Dataverse anda ke repositori Azure DevOps

Sambungan ini membolehkan kawalan sumber untuk semua konfigurasi dan komponen peringkat persekitaran.

Jangan gunakan parameter ini dengan sambungan ini:

• RootFolder
• SolutionUniqueName
• UpstreamBranch

API Web

Contoh ini menunjukkan cara menggunakan tindakan ConnectToGit untuk menyambungkan keseluruhan persekitaran Dataverse anda ke repositori Azure DevOps.

Permintaan

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

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0

Ketahui cara memanggil tindakan API Web

SDK untuk .NET

Kaedah statik ConnectDataverseEnvironment ini menunjukkan cara menggunakan ConnectToGit mesej untuk menyambungkan keseluruhan persekitaran Dataverse anda ke repositori Azure DevOps.

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

Ketahui cara memanggil mesej Dataverse menggunakan SDK untuk .NET

Putuskan sambungan keseluruhan persekitaran Dataverse anda daripada kawalan sumber Git

Tindakan ini mengalih keluar sambungan Git peringkat persekitaran. Jangan gunakan SolutionUniqueName parameter untuk operasi ini. Dataverse secara automatik mengenal pasti dan mengalih keluar sambungan Git peringkat persekitaran.

API Web

Contoh ini menunjukkan cara menggunakan tindakan DisconnectFromGit untuk memutuskan sambungan keseluruhan persekitaran Dataverse anda daripada kawalan sumber Git.

Permintaan

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

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0

Ketahui cara memanggil tindakan API Web

SDK untuk .NET

Kaedah statik DisconnectDataverseEnvironment memutuskan keseluruhan persekitaran Dataverse anda daripada kawalan sumber Git.

static void DisconnectDataverseEnvironment(IOrganizationService service) {

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

   OrganizationRequest request = new("DisconnectFromGit");

   service.Execute(request);

}

Ketahui cara memanggil mesej Dataverse menggunakan SDK untuk .NET

Sambungkan penyelesaian pertama ke repositori Git

Sambungan ini mewujudkan pautan repositori dan struktur folder untuk kawalan sumber peringkat penyelesaian kepada penyelesaian pertama dalam persekitaran.

Anda perlu memasukkan nilai untuk parameter ini untuk menentukan penyelesaian:

• RootFolder
• SolutionUniqueName

API Web

Contoh ini menunjukkan cara menggunakan tindakan ConnectToGit untuk menyambungkan penyelesaian pertama ke repositori Git.

Permintaan

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

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0

Ketahui cara memanggil tindakan API Web

SDK untuk .NET

Kaedah statik ConnectFirstSolution menunjukkan cara menyambungkan penyelesaian pertama ke repositori Git.

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

Ketahui cara memanggil mesej Dataverse menggunakan SDK untuk .NET

Sambungkan penyelesaian tambahan ke repositori Git yang sama selepas anda menyambungkan penyelesaian awal

Selepas anda menyambungkan penyelesaian pertama, anda hanya memerlukan parameter khusus penyelesaian. Anda mewarisi butiran sambungan repositori daripada sambungan awal.

Tetapkan parameter ini sahaja:

• SolutionUniqueName
• Branch
• GitFolder

Penting

Anda mesti menyambungkan penyelesaian pertama terlebih dahulu sebelum ini berfungsi. Lihat Sambungkan penyelesaian pertama ke repositori Git.

API Web

Contoh ini menunjukkan cara menggunakan tindakan ConnectToGit untuk menyambungkan penyelesaian berikutnya ke repositori Git.

Permintaan

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

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0

Ketahui cara memanggil tindakan API Web

SDK untuk .NET

Kaedah statik ConnectExtraSolution menunjukkan cara menyambungkan penyelesaian seterusnya ke repositori Git.

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

Ketahui cara memanggil mesej Dataverse menggunakan SDK untuk .NET

Putuskan sambungan penyelesaian tertentu daripada kawalan sumber Git sambil memastikan penyelesaian lain disambungkan

Gunakan pendekatan ini untuk mengalih keluar kawalan sumber bagi satu penyelesaian tanpa menjejaskan yang lain.

API Web

Contoh ini menunjukkan cara menggunakan tindakan DisconnectFromGit untuk mengalih keluar kawalan sumber untuk satu penyelesaian tanpa menjejaskan yang lain.

Permintaan

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

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0

Ketahui cara memanggil tindakan API Web

SDK untuk .NET

Kaedah statik DisconnectSolution mengalih keluar kawalan sumber untuk satu penyelesaian tanpa menjejaskan yang lain.

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

Ketahui cara memanggil mesej Dataverse menggunakan SDK untuk .NET

Pengendalian ralat

API mahupun ConnectToGitDisconnectFromGit tidak mengembalikan nilai apabila ia berjaya diselesaikan. Apabila API gagal, ia mengembalikan ralat.

Senario ralat biasa termasuk:

• Kelayakan tidak sah: Pastikan anda mempunyai pengesahan yang sah kepada pembekal Git.
• Repositori tidak dijumpai: Sahkan nama organisasi, projek dan repositori.
• Kebenaran ditolak: Pastikan akaun Dataverse anda mempunyai keizinan pengurusan kawalan sumber.
• Penyelesaian tidak dijumpai: Sahkan kewujudan SolutionUniqueName dalam persekitaran anda.
• Cawangan tidak wujud: Sahkan cawangan yang ditentukan wujud dalam repositori.

Sokongan dan sumber tambahan

Untuk maklumat lanjut tentang penyepaduan kawalan sumber dengan Dataverse, lihat:

• Gambaran Keseluruhan Penyepaduan Git dalam Power Platform
• Tindakan ConnectToGit
• Tindakan Putus Sambungan DariGit
• Tindakan CommitToGit
• Tindakan RefreshChangesFromGit
• Tindakan PullChangesFromGit