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 yaklaşımda, özellikle ALM işlemleri sırasında değerlerin değiştirilmesi gerektiğinde genellikle sorun yaşanır. 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.

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 sitesi ve liste parametreleri ortam değişkenleri olarak depolanabilir. Bu yaklaşım, uygulamaları ve akışları değiştirmenize gerek kalmadan farklı ortamlardaki farklı sitelere ve listelere bağlanmanıza olanak tanır.
• Ö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 arabirimi içinde oluşturulabilir ve değiştirilebilir. Tuval uygulamalarında veya kod ile belirli veri kaynaklarına bağlanırken de otomatik olarak oluşturulabilir. Bunlar, çözümler aracılığıyla bir ortama da aktarılabilir. Tuval uygulamaları, Power Automate akışları, eklentiler yazarken ve model temelli uygulamalara Power BI panoları eklerken ortam değişkenleri giriş olarak kullanılabilir. Ortam değişkenlerini kullandığınızda değerler ortam değişkenlerinden türetilir ve çözümler diğer ortamlara aktarılırken değiştirilebilir.

Bir çözümde el ile 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ü seçmeniz gerekir. Bağlantı, ortam değişkeninin bir parçası olarak depolanmaz. Ortam değişkeni, Power Apps'i doğru sunucuya ve tabloya bağlamak için gereken ağlantıda bulunmayan bilgileri depolar. 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.

     • 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. Varsayılan bir değer bulunsa bile tanımlanmış 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.

Power Apps, ortam değişkenlerini otomatik olarak oluşturabilir

Power Apps ayarlarının Genel sekmesinde:

• Veri kaynakları eklenirken ortam değişkenlerini otomatik olarak oluştur seçeneğini etkinleştirin. Artık uygulamanıza yeni bir veri kaynağı eklediğinizde bu kaynak sizin için bir ortam değişkeni ekler.

  

Farklı veri kaynakları

Farklı veri kaynakları, farklı türde ortam değişkenlerine olanak tanır.

Microsoft Dataverse

Power Apps, Dataverse'e yerel olarak bağlanır. Geçerli ortamınızdaki tablolar için bir ortam değişkenine ihtiyacınız yoktur. Dataverse'e bağlandığınızda, uygulamanız otomatik olarak taşıdığınız herhangi bir ortamda tam olarak aynı tablo adını arar. Tablo adı yapınız hedef ortamda, özgün ortamda olduğu gibi çalıştığı sürece çalışır.

Farklı bir ortamdan harici bir tablo kullanırsanız (Ortamı Değiştir aracılığıyla) Power Apps, her zaman aynı tabloya başvurmak istediğinizi varsayar. Geliştirme aşamasından test aşamasına veya üretim aşamasına geçtiğinizde bu harici tablonun farklı bir harici tablo olması gerekiyorsa bir ortam değişkeni gerekir. Power Apps'in sizin için ortam değişkenini otomatik olarak oluşturmasına izin vermek en kolay yoldur. (Tabloyu daha önce uygulamanıza eklediyseniz ayarlar anahtarını açın, harici tabloyu bırakın ve ardından yeniden ekleyin.)

Uygulamanıza harici tablo eklediğinizde ortam değişkenini belirlemek için Gelişmiş sekmesini seçin.

SharePoint

SharePoint yalnızca Microsoft Entra bağlantılarını destekler. Bu nedenle SharePoint için geçerli bir bağlantının yanı sıra Site ve Liste için ayrı bir ortam değişkeni gereklidir.

SharePoint listeleri ile ortam değişkenlerini başarılı bir şekilde 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.
• SharePoint için ortam değişkenleri eşleşen meta verilere sahip olmalıdır. SharePoint hedef ortamlar arasında eşleşmeyebilecek dahili tanımlayıcılara sahiptir. Örneğin, hedef ortamda aynı ada ve sütunlara sahip bir liste oluşturursanız, dahili adlar eşleşmez. Bir siteyi çoğaltıp SharePoint hedef ortamınıza kopyaladığınızda meta veriler her zaman eşleşir.

SQL Server

SQL Server birçok farklı kimlik doğrulama ve bağlantı türünü destekler. Microsoft Entra bağlantıları için ortam değişkenlerini kullanın. Sunucu ve veritabanı için ayrı bir ortam değişkeni gereklidir. Uygulama belirli tablo adlarına bağlıdır, bu nedenle ortamlar arasında aynı oldukları varsayılır.

SQL Server ile temel SQL kimlik doğrulaması gibi paylaşılan bağlantılar için ortam değişkenlerini kullanmayın. Geleneksel olarak bağlantı dizesinin bir parçası olarak geçirilen bilgiler için bağlantı başvurularını kullanın. Temel SQL kimlik doğrulama parametrelerinin tümü bağlantı dizesinin bir parçasıdır. Ö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, Microsoft Entra gibi kimlik doğrulaması olan bağlayıcılar için kullanılır. Bu tür bağlantılarda, Power Apps yalnızca tanımlanmış bir kullanıcıya sahiptir. Power Apps, bağlantıdan hangi hizmet veya tablo ile çalışmak istediğinizi türetemez.

Çö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.

Ortam değişkeni değerleri, çözümler içeri aktarılırken veya dağıtım için İşlem Hatları kullanılırken görüntülenebilir. Varsayılan değeri veya değeri olmayan ortam değişkenleri bir değer ister, ancak aksi durumlar 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.

Bildirimler

Ortam değişkenlerinin herhangi bir değeri olmadığında bir bildirim görüntülenir. Ortam değişkenlerine bağımlı bileşenlerin başarısız olmaması için değerleri ayarlayın.

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.
• 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.

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.

Değeri çözümüme dahil etmeli miyim?

Hayır Ortam değişkenleri, çözümün dağıtıldığı farklı ortamlarda farklı değerlere sahip olması gereken uygulamalar tarafından kullanılmak üzere tasarlanmıştır. Ortam değişkeni tanımları çözümünüze dahil edilmelidir, ancak dağıtım sırasında hedef ortam için değerler sağlanmalıdır. Bu davranış, ortam değişkeni yönetilmeyen bir kayıt iken ortam değişkeni tanımının hedef ortamda yönetilen bir çözüm nesnesi olmasına neden olur.

Neden ortamımda bir değeri silemiyorum?

Değer yönetilen bir çözüme dahil edilmişse, değeri silmenin tek yolu, değeri dışlamak için kaynak ortamdaki çözümü güncelleştirmek ve ardından çözümün yeni bir sürümünü dışarı aktarmaktır. Bu yeni sürüm daha sonra bir yükseltme işlemi (güncelleştirme değil) kullanılarak ortama aktarılabilir ve bu da değer kaydının silinmesine neden olur.

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 uygulamaları) 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 maksimum boyutu 95 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.

Bağlantım neden veri kaynağı ortam değişkenleri için saklanamıyor?

Bağlantılar yalnızca kullanıcı arabirimini oluşturmak için kullanılır. Örneğin, bir siteyle ilişkilendirilmiş SharePoint listelerinin kolay adlarını almak için. Bir veri kaynağı ortam değişkenini düzenlerken, veri kaynağına erişimi olan bir bağlantı seçtiğinizden emin olun. Bağlantıya artık erişiminiz yoksa, el ile bir değer girebilirsiniz. Örneğin, bir listenin SharePoint sitesi URL'sini veya benzersiz tanımlayıcısını (GUID) girin.

Tek bir (veri kaynağı türü) ortam değişkeni için birden çok bağlantı olduğunda, bağlantı listesindeki ilk bağlantıyı seçmek için tasarım gereği 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 tablosu/varlık başvurusu
Web API'si örnekleri
Tuval uygulamalarında veri kaynağı ortam değişkenleri kullanma
Power Automate çözümü bulut akışlarında çevre değişkenleri kullanma
Azure Key Vault gizli dizilerini kullanma
Özel bağlayıcılarda çevre değişkeni desteği
Power Apps Blog: Önizlemedeki ortam değişkenleri!