Power Platform ortam değişkenlerine genel bakış

Ortam değişkenleri, uygulamaları Power Platform ortamları arasında taşıyarak temel uygulama yaşam döngüsü yönetimi (ALM) senaryosunu etkinleştirir. Bu senaryoda, kaynak ortam ve hedef ortam arasında farklı olan birkaç anahtar dış uygulama başvurusu (tablolar, bağlantılar ve anahtarlar gibi) hariç olmak üzere uygulama tam olarak aynı kalır. Uygulama, bazı farklılıklarla birlikte, tabloların veya bağlantıların yapısının kaynak ve hedef ortamları arasında tam olarak aynı olmasını gerektirir. Ortam değişkenleri, uygulama ortamlara taşınırken bu farklı harici başvurulardan hangisinin güncelleştirileceğini belirtmenize olanak verir.

Ortam değişkenleri, daha sonra diğer çeşitli uygulama nesnelerinde giriş olarak kullanılan parametre anahtarlarını ve değerleri depolar. Tüketen nesnelerden parametreleri ayırmak aynı ortamdaki değerleri değiştirmenize veya diğer ortamlara çözümler geçirmenize olanak sağlar. Bunun alternatifi, sabit kodlanmış parametre değerlerini onları kullanan bileşenler içinde bırakmaktır. Bu durum, özellikle değerlerin ALM işlemleri sırasında değiştirilmesi gerektiği zamanlarda sorunlara neden olur. Ortam değişkenleri çözüm bileşenleri olduğundan çözümler diğer ortamlara geçirildiğinde başvuruları (anahtarlar) ve değerleri değiştirebilirsiniz.

Not

Veri kaynaklarının yeni özellikleri şu anda dağıtılmaktadır ve bölgenizde henüz kullanılabilir olmayabilir.

Ortam değişkenlerini kullanmanın yararları:

• Diğer ortamlara çözümler aktarırken yeni parametre değerleri sağlayın.
• Tuval uygulamalarında ve akışlarda kullanılan veri kaynakları için yapılandırmayı depolayın. Örneğin, SharePoint Online site ve liste parametreleri ortam değişkenleri olarak depolanabilir; böylece uygulamaları ve akışları değiştirmenize gerek kalmadan farklı ortamlardaki farklı sitelere ve listelere bağlanabilirsiniz.
• Özelleştirmenizi ve yapılandırmanızı birlikte paketleyip taşıyın ve bunları tek bir konumda yönetin.
• Farklı bileşenler tarafından kullanılan kimlik bilgileri gibi, bunları kullanan bileşenlerden ayrı paketleme ve taşıma gizli dizileri.
• Bir ortam değişkeni birçok farklı çözüm bileşeninde kullanılabilir; bileşen türü aynı veya farklı olabilir. Örneğin, bir tuval uygulaması ve bir akış aynı ortam değişkenini kullanabilir. Ortam değişkeninin değerinin değiştirilmesi gerektiğinde, yalnızca bir değeri değiştirmeniz gerekir.
• Ayrıca, üretim ortamlarında bir veri kaynağını devre dışı bırakmanız gerekirse, ortam değişkeni değerlerini yeni veri kaynağı bilgileriyle güncelleştirebilirsiniz. Uygulamalar ve akışlar üzerinde değişiklik yapılmasını gerektirmez ve yeni veri kaynağı kullanılmaya başlanır.
• Çözüm Paketleyici ve DevOps araçları tarafından desteklenerek sürekli tümleştirme ve sürekli teslimat (CI/CD) sağlar.
• Ortam değişkenleri, kaynak denetiminde paketten çıkarılabilir ve depolanabilir. Farklı ortamlarda ihtiyaç duyulan ayrı yapılandırma için farklı ortam değişkenleri değer dosyalarını da saklayabilirsiniz. Ardından, Çözüm Paketi Oluşturucu çözümün aktarılacağı ortama karşılık gelen dosyayı kabul edebilir.

Ortam değişkenleri nasıl çalışır?

Ortam değişkenleri, modern çözüm arabiriminde oluşturulabilir ve değiştirilebilir, tuval uygulamalarında belirli veri kaynaklarına bağlanırken otomatik olarak veya kod kullanılarak oluşturulur. Bunlar, çözümler aracılığıyla bir ortama da aktarılabilir. Ortam değişkenleri bir ortamda yer aldıktan sonra; tuval uygulamaları, Power Automate akışları yazılırken, eklentiler geliştirilirken ve model temelli uygulamaya Power BI panosu eklemek gibi çok farklı yerlerde giriş olarak kullanılabilir. Bu tür nesneler ortam değişkenlerini kullandığında değerler, daha sonra ortam değişkenlerinden türetilir ve çözümler diğer ortamlara aktarılırken değiştirilebilir.

Bir çözümde ortam değişkeni oluşturma

1. Power Apps 'te (make.powerapps.com) oturum açın ve ardından sol bölmede Çözümler' seçin. Öğe yan panel bölmesinde yoksa ...Diğer'i ve ardından istediğiniz öğeyi seçin.
2. İstediğiniz çözümü açın veya yeni bir çözüm oluşturun.
3. Komut çubuğunda Yeni > Daha Fazla ve ardından Ortam değişkeni'ni seçin.
4. Sağ bölmede, aşağıdaki sütunları doldurun ve ardından Kaydet'i seçin.

   • Görünen ad. Ortam değişkeni için bir ad girin.

   • Adı. Benzersiz ad, Görünen ad'dan otomatik olarak oluşturulur ancak bunu değiştiremezsiniz.

   • Veri Türü. Ondalık sayı, Metin, JSON, İki seçenek, Veri kaynağı veya Gizli Dizi arasından seçim yapın.

     Not

     • Veri kaynağı seçilen tür ise bağlayıcıyı, seçili bağlayıcı için geçerli bağlantıyı ve parametre türünü de seçmeniz gerekir. Ancak, bağlantı ortam değişkeninin parçası olarak depolanmaz. Bağlantı yalnızca, erişiminiz olan SharePoint siteleri veya bir siteyle ilişkilendirilmiş listeler gibi kullanılabilir parametre değerlerini almak için kullanılır. SharePoint listeleri gibi belirli parametreler için SharePoint sitesi gibi bir üst veri kaynağı ortam değişkeni seçmeniz de gerekir. Kaydedildikten sonra bunlar veritabanında ilişkilendirilir.
     • Gizli Dizi seçilen tür ise Azure Key Vault'u Power Platform'un gizli anahtara erişmesine izin verecek şekilde ayarlayıp yapılandırmak için ek bilgiler gerekir.

   • Current Value. Değer olarak da bilinir. Bu özellik isteğe bağlıdır ve ortam değişkeni değer tablosunun bir parçasıdır. Bir değer bulunduğunda, varsayılan bir değer de olsa, bu değer kullanılır. Sonraki ortamda kullanmak istemiyorsanız değeri çözümünüzden kaldırın. Değerler aynı zamanda dışarı aktarılan solution.zip dosyası içinde ayrı JSON dosyalarına ayrılmıştır ve çevrimdışı olarak düzenlenebilir. Daha fazla bilgi: Ortam değişkeninden bir değeri nasıl kaldırabilirim?

   • Varsayılan Değer. Bu sütun, ortam değişkeni tanımı tablosunun parçasıdır ve gerekli değildir. Geçerli değer yoksa varsayılan değer kullanılır.

     Varsayılan değer ve geçerli değerin ayrılması, tanıma ve varsaylan değere değerden ayrı olarak bakım yapmanızı sağlar. Örneğin, bir uygulama yayımcısı AppSource ile ilgili teklifini varsayılan değer ile listeleyebilir. Ardından, isteğe bağlı olarak müşteri yeni bir değer sağlayabilir. Uygulama yayımcısı uygulamaya güncelleştirme yayımlandığında müşteri tarafından ayarlanan değerin üzerine yazılmaz.

     

     Not

     Bir değer tanımsız olarak var olamaz. Arabirim, her tanım için yalnızca bir değer oluşturulmasını sağlar.

Çözümleri alırken yeni değerler girme

Modern çözüm alma arabirimi, ortam değişkenleri için değer girebilme olanağını içerir. Bu, environmentvariablevalue tablosundaki değer özelliğini ayarlar.

7 Aralık 2023'teki bir güncelleştirmeden itibaren, çözümler içeri aktarılırken (veya dağıtmak için İşlem Hatları kullanılırken) tüm ortam değişkeni değerleri görünür. Varsayılan değeri veya değeri olmayan ortam değişkenlerinden bir değer istenir, ancak aksi takdirde değerler, metin alanının altında değerin kaynağını belirten bir etiketle önceden doldurulur: çözüm değeri, hedef ortam değeri veya varsayılan değer.

Not

• Bazı durumlarda, belirli veri kaynağı ortam değişkeni değerleri için, içeri aktaran oluşturucunun ortam değişkeni için kullanılan bağlantıya veya kaynağa erişimi yoksa Erişim reddedildi uyarısı görüntülenebilir. Bu engelleyici olmayan bir uyarıdır ancak ortam değişkenini hedef ortamda nasıl kullanmayı planladığınıza bağlı olarak dikkat edilmesi gereken bir şeydir.
• Çözümü vermeden önce, değeri çözümünüzden kaldırabilirsiniz. Bu, mevcut değerin geliştirme ortamınızda kalmasını sağlar ancak çözümde dışarı aktarılmaz. Bu yaklaşım, çözümü diğer ortamlara aktarırken yeni bir değerin sağlanmasına olanak tanır. Daha fazla bilgi: Ortam değişkeninden bir değeri nasıl kaldırabilirim?

Bildirimler

Ortam değişkenlerinin herhangi bir değeri olmadığında bir bildirim görüntülenir. Bu, ortam değişkenlerine bağımlı olan bileşenlerin başarısız olmaması için değerlerin ayarlanmasıyla ilgili bir anımsatıcıdır.

Güvenlik

environmentvariabledefinition tablosu, kullanıcıya veya takıma aittir. Ortam değişkenleri kullanan bir uygulama oluşturduğunuzda, kullanıcılara bu tablo için uygun ayrıcalık düzeyini atadığınızdan emin olun. environmentvariablevalue tablosu izni, üst environmentvariabledefinition tablosundan devralınır ve bu nedenle ayrı ayrıcalıklar gerektirmez. environmentvariabledefinition tablolarının ayrıcalıkları, varsayılan olarak Ortam Oluşturucu ve Temel Kullanıcı güvenlik rollerine eklenir. Daha fazla bilgi: Dataverse 'te güvenlik.

Adlandırma

Doğru şekilde başvurulabilmeleri için ortam değişkeni adlarının benzersiz olduğundan emin olun. Yinelenen ortam değişkeni görünen adları, ortam değişkenlerinin ayırt edilmesini ve kullanılmasını zorlaştırır. Doğru şekilde başvurulabilmeleri için ortam değişkeni adlarının benzersiz olduğundan emin olun. $authentication ve $connection adları, akışlar için özel olarak ayrılmış parametrelerdir ve kullanılmamaları gerekir. Bu adlara sahip ortam değişkenleri kullanılırsa akış kaydetme işlemi engellenir. Akışta bir ortam değişkeni kullanılırsa ve ortam değişkeninin görünen adı değiştirilirse tasarımcı tanımlamaya yardımcı olması için hem eski hem de yeni görünen ad belirteçlerini gösterir. Akışı güncelleştirirken ortam değişkeni başvurusunu kaldırıp yeniden eklemenizi öneririz.

Geçerli sınırlamalar

• Ortam değişkeni değerlerinin doğrulanması kullanıcı arabirimlerinde ve bunları kullanan bileşenler içinde olur, ancak Dataverse içinde olmaz. Bu nedenle, kod aracılığıyla değiştirilmeleri durumunda doğru değerlerin ayarlandığından emin olun.
• Power Platform Build Tools görevleri, henüz veri kaynağı ortam değişkenlerini yönetmek için kullanılamaz. Ancak bu, Microsoft tarafından sağlanan araçlarda ve kaynak denetimi sistemlerinde kullanımını engellemez.
• Özel kod aracılığıyla ortam değişkenleriyle etkileşim kurmak için değerleri getirmek üzere bir API çağrısı gerekir; Microsoft'a ait olmayan kodun kullanabileceği gösterilen bir önbellek yoktur.
• SharePoint listeleriyle ortam değişkenlerini başarıyla kullanmak için kaynak ve hedef ortamlarda karşılık gelen her sütunun görünen adı ve mantıksal adı eşleşmelidir.
• Ortam değişkenleri en fazla 2.000 karakterle sınırlıdır.

Sık sorulan sorular

Ortam değişkenimin değerini neden göremiyorum?

Ortam değişkeni yönetilen bir çözümdeyse Varsayılan çözümün içine bakmadığınız sürece değeri göremezsiniz. Ortam değişkeni değeri yönetilmeyen bir özelleştirme olduğundan bu davranış tasarım gereğidir.

Ortam değişkenlerinin nerede kullanıldığını nasıl görüntüleyebilirim?

Çözüm arabiriminde Bağımlılıkları göster'i seçerek, bileşenleri yazarken veya uygulama ya da akış meta verilerini görüntüleyerek kaynak denetiminde ve çözüm dosyasında.

Veri kaynağı ortam değişkenleri bağlantılarla aynı mıdır?

Hayır Ancak bağlantıyla ilişkililerse bağlayıcıyla etkileşim kurmak için gereken bir kimlik bilgisini veya kimlik doğrulamasını temsil eder. Veri kaynağı ortam değişkenleri, bağlayıcıdaki bir veya daha fazla eylem için gerekli olan parametreleri depolar ve bu parametreler eyleme göre farklılık gösterir. Örneğin, SharePoint Online bağlantısı siteler, listeler veya belge kitaplıklarıyla ilgili hiçbir bilgi depolamaz. Bu nedenle bağlayıcıyı çağırmak için hem geçerli bir bağlantı hem de bazı ek parametreler gerekir.

Veri kaynağı ortam değişkenleri, SQL kimlik doğrulamasıyla SQL Server gibi paylaşılan bağlantılarla kullanılabilir mi?

Genel olarak kullanılamaz. SQL Server ile paylaşılan bağlantılar, bağlantı içindeki verilere bağlanmak için gerekli olan parametreleri depolar. Örneğin, Sunucu ve Veritabanı adı, bağlantı oluşturulurken sağlanır ve bu nedenle her zaman bağlantıdan türetilir.

Veri kaynağı ortam değişkenleri, parametreler bağlantıdan türetilemediğinden Microsoft Entra ID gibi kullanıcı tabanlı kimlik doğrulamasına dayanan bağlayıcılar için kullanılır. Bu nedenlerden dolayı, paylaşılan bir bağlantı olan SQL Server ile kimlik doğrulaması yaparken veri kaynağı ortam değişkenleri kullanılmaz.

Otomatik ALM ardışık düzenim farklı ortamlar için farklı değer dosyaları kullanabilir mi?

Evet. Çözüm paketi oluşturucusu dosya adını giriş parametreleri olarak kabul eder; bu nedenle, ardışık düzeniniz yürütüldüğü ortamın türüne bağlı olarak farklı bir değerler dosyasını çözümde paketleyebilir.

Birisi istemeden bir değeri silerse ne olur?

Bağımlılık sistemi tarafından önceden engellenmediyse çalışma zamanı, geri dönüş olarak bilinen son değeri kullanır.

Bir değer değiştirilirse yeni değer, tuval uygulamalarında ve bulut akışlarında ne zaman kullanılır?

Değer uygulamalara gönderildiğinden ve zaman uyumsuz olarak aktığından, güncelleştirilen ortam değişkenlerinin tam olarak yayımlanması bir saat kadar sürebilir.

Premium lisanslar gerekli midir?

Hayır ALM, Dataverse (veya Dynamics 365 for Customer Engagement) gerektirse de premium bağlayıcıların kullanımı gerekmez. Ancak hesaplar veya ilgili kişiler gibi diğer veri kayıtlarında olduğu gibi ortam değişkenleriyle etkileşim kurmak için Dataverse bağlayıcısını kullanıyorsanız dikkat etmeniz gerekir. Daha önce bu, tuval uygulamalarında ve akışlarda ortam değişkenleri kullanmanın tek yoluydu.

Sahip olabileceğim ortam değişkenlerinin sayısıyla ilgili belirli bir sınır var mıdır?

Hayır Ancak, bir çözümün en fazla boyutu 120 MB'dir. Daha fazla bilgi: Çözüm oluşturma

Ortam değişkeni görünen adları ve açıklamaları yerelleştirilebilir mi?

Evet.

Yapılandırma verilerini özel tablolarda depolamak yerine ortam değişkenlerini mi kullanmalıyım?

Yapılandırma veriniz ilişkisel değilse evet. Ortam değişkenleri, anahtar değer çiftleri için ve değerin başka ortamlarda farklı olması gerektiği zamanlarda kullanılmalıdır. Yapılandırma geçişi yardımcı programı gibi diğer araçlar, özel tablolar içinde depolanan ilişkisel yapılandırma verilerinin geçişi için daha uygundur. Diğer yapılandırma verilerinden farklı olarak, ortam değişkenleri çözüm içinde geçirilir ve bu nedenle yönetimleri daha kolaydır ve içeri aktarma için daha iyi performans sağlar.

İçe aktarırken neden istediğimden farklı bir bağlantı değeri atanır?

Tek (veri kaynağı türü) ortam değişkeni için birden fazla bağlantı bulunan bazı durumlarda, ortam değişkeni için kullanılabilir olan bağlantılar listesinde ilk bağlantıyı seçmek için tasarıma göre bir uygulama vardır. Ortam değişkeniyle ilişkilendirilmiş genellikle yalnızca bir bağlantı olduğundan, bu genelde doğrulanması gereken bir şey değil. Ayrıca, ortam değişken değeri görünürlüğündeki son değişikliklerle birlikte, içe aktarma işlemi sırasında bu daha kolay doğrulanır.

Ortam değişkeninden bir değeri nasıl kaldırabilirim?

Çözümü dışarı aktarmadan önce bir ortam değişkeninin değerini çözümünüzden kaldırmak isteyebilirsiniz. Daha sonra, mevcut değer geliştirme ortamınızda kalır, ancak çözüme aktarılmaz. Bu yaklaşım, çözümü başka bir aktarırken yeni bir değerin sağlanmasını sağlar.

Değeri kaldırmak için aşağıdaki adımları uygulayın:

1. Ortam değişkeninin bulunduğu çözümde, özellikleri görüntülemek için ortam değişkenini seçin.

2. Geçerli Değer altında ... > Bu çözümden kaldır'ı seçin.

   

Özel bağlayıcılarda ortam değişkenlerini kullanabilir miyim?

Evet. Özel bağlayıcılarda ortam değişkenleri desteği

Ayrıca bkz.

Tuval uygulamalarında veri kaynağı ortam değişkenleri kullanma
Power Automate çözümü bulut akışlarında ortam değişkenlerini kullanma
EnvironmentVariableDefinition tablo/varlık başvurusu
Web API'sı örnekleri
Tuval uygulamalarında veri kaynağı ortam değişkenleri kullanma
Power Automate çözümü bulut akışlarında ortam değişkenlerini kullanma
Azure Key Vault gizli dizilerini kullanma
Özel bağlayıcılarda ortam değişkenleri desteği
Power Apps Blogu: Ortam değişkenleri önizlemede kullanılabilir!

Not

Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)

Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).