Yhteysviittauksien ja ympäristömuuttujien esitäyttö automaattisille käyttöönotoille

Artikkeli
08/09/2023

Yhteysviitteet ja ympäristömuuttujat antavat mahdollisuuden määrittää vuorovaikutteisesti yhteyden tiedot ja määritysasetukset, jotka koskevat kohdeympäristöä, jossa sovellus tai ratkaisu otetaan käyttöön.

Lisätietoja:

Kun olet tuonut ratkaisun, joka sisältää yhteysviite- ja ympäristömuuttujatietoja, järjestelmä pyytää sinua antamaan ympäristöä koskevia tietoja käyttöliittymässä. Näiden tietojen syöttäminen ei kuitenkaan toimi hyvin täysin automatisoiduissa jatkuvan integraation / jatkuvan toimituksen (CI/CD) skenaarioissa.

Jotta käyttöönotto olisi täysin automatisoitu, voit esitäyttää kohdeympäristöä koskevat yhteysviite- ja ympäristömuuttujatiedot, jotta niitä ei tarvitse antaa vuorovaikutteisesti ratkaisun tuonnin jälkeen.

Käyttöönottoasetustiedosto

Jos haluat esitäyttää yhteysviite- ja ympäristömuuttujatiedot käyttöönottoa varten, tallenna tiedot käyttöönottoasetustiedostoa (JSON) käyttäen ja välitä ne parametrina, kun tuot ratkaisun Power Platform Build Toolsin avulla. Voit tallentaa JSON-tiedoston lähdeohjausjärjestelmään organisaatiosi tarpeiden mukaisia päivitys- ja hallintatoimia varten.

Seuraavassa on esimerkki käyttöönottoasetustiedostosta:

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": ""
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": ""
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

Yllä olevassa JSON-esimerkkitiedostossa ""-arvot puuttuvat, ja ne on täytettävä. Sen tekeminen käsitellään myöhemmin tässä artikkelissa.

Vaihe 1: Käyttöönottoasetustiedoston muodostaminen

Käyttöönottoasetustiedoston voi muodostaa käyttämällä Power Platform CLI:tä. Voit muodostaa tiedoston ratkaisun viennin tai kloonauksen yhteydessä.

Vaihtoehto 1: Käyttöönottoasetustiedoston muodostaminen luontiasetusten ominaisuuden avulla

Käytä create-settings -ominaisuutta Power Platform CLI:ssä:

C:\> pac solution create-settings --solution-zip <solution_zip_file_path> --settings-file <settings_file_name>

Tämä komento luo JSON-tiedoston alla esitetyllä tavalla.

JSON-tiedostossa on joitakin arvoja, jotka ovat tyhjiä ConnectionReferences-osassa. Nämä arvot on kerättävä sen jälkeen, kun ne on luotu kohdeympäristössä.

Vaihtoehto 2: Käyttöönottoasetustiedoston muodostaminen ratkaisun kloonaamisen avulla

Tässä vaiheessa tarvitaan projektiratkaisun klooni, koska se hahmontaa alkuperäisen ratkaisun rakennettavaan muotoon. Kun olet kloonannut ratkaisun Power Platform CLI:tä käyttäen, tietokoneellesi luodaan seuraava hakemistorakenne:

Luo asetustiedosto nykyisen kansion kontekstissa ja täytä asetustiedoston arvo alla esitetyllä tavalla.

Vaihe 2: Yhteysviite- ja ympäristömuuttujatietojen saaminen

Jotta voit täyttää käyttöönottoasetustiedoston, sinun on saatava kohderatkaisun yhteysviite- ja ympäristömuuttujatiedot.

Yhteysviitetietojen saaminen

Saat kohdeympäristön yhteystunnuksen seuraavilla tavoilla:

Kirjaudu sisään Power Appsiin ja valitse kohdeympäristö. Valitse vasemmanpuoleisesta siirtymisruudusta Tiedot>Yhteydet, valitse yhteys, jonka yhteystunnuksen haluat, ja katso sitten URL-osoitteesta yhteystunnus.
Luo pohjaan perustuva sovellus yhteyden viite-entiteetissä. Vaiheet ovat seuraavat:
1. Kirjaudu sisään Power Appsiin ja valitse kohdeympäristö.
2. Valitse vasemmanpuoleisesta siirtymisruudusta Sovellukset ja valitse sitten Uusi sovellus>Pohjaan perustuva.
3. Valitse Dataverse tietolähteeksi.
4. Valitse Yhteysviitteet-taulukko ja valitse Yhdistä.
5. Tämä luo valikoimasovelluksen, jossa on luettelo ympäristön kaikista yhteyksistä ja niiden yhteystunnuksista.

Ympäristömuuttujatietojen saaminen

Saadaksesi kohdeympäristön ympäristömuuttuja-arvot kirjaudu sisään Power Appsiin, valitse kohdeympäristö, napsauta hiiren kakkospainikkeella kolmea pistettä ja valitse muokattavaksi. Tämä antaa käyttöönottoasetustiedoston täyttämiseen tarvittavat tiedot (alleviivatut arvot ovat tiedostoon tarvittavat arvot):

Ympäristömuuttujien arvot kohdeympäristössä

Muussa tapauksessa voit antaa kohdeympäristölle asianmukaisen arvon perustuen tietoihisi kohdeympäristöstä.

Vaihe 3: Käyttöönottoasetustiedoston arvojen päivittäminen

Muokkaa käyttöönottoasetustiedostoa (JSON) manuaalisesti ja lisää yhteys- ja ympäristömuuttujatiedot vastaavasti. Alla on esimerkki asetustiedostosta, johon aiemmin puuttuneet arvot on lisätty.

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": "Test"
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": "UAT"
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "4445162937b84457a3465d2f0c2cab7e",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "ef3d1cbb2c3b4e7987e02486584689d3",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "74e578ccc24846729f32fcee83b630de",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "d8beb0fb533442c6aee5c18ae164f13d",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

Vaihe 4: Käyttöönottoasetustiedoston käyttäminen Build Tools -tehtäviin

Siirrä käyttöönottoasetustiedosto parametrina, kun tuot ratkaisua kohdeympäristöön. Tämä luo pakolliset yhteysviitteet ja ympäristöt, joissa on tuotaessa asianmukaiset arvot. Käyttäjän ei tarvitse vuorovaikutteisesti määrittää arvoa.

Kun käytät Tuo ratkaisu -tehtävää Power Platform Build Toolsissa, valitse Käytä käyttöönottoasetustiedostoa ja anna polku käyttöönottoasetustiedostoon. Alusta seuraavaksi putki.

Vahvistus

Ratkaisun tuonnin aikana yhteysviitteet tarkistetaan, jotta varmistetaan, että niiden sisällä olevat yhteydet ovat yhteysviitteen omistajan käytettävissä. Varmista, että yhteyksien omistaja on yhteysviitteiden omistaja tai että yhteydet on jaettu.

Katso myös

Mikä on Microsoft Power Platform CLI?
Microsoft Power Platform Build Tools -tehtävät

Jaa