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 Çevrimiçi site 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 sırları, kullandıkları bileşenlerden ayrı tutarak paketleyin ve taşıyın.
• 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. Ortam değişkenleri, tuval uygulamaları, Power Automate akışları, eklentiler oluştururken ve model güdümlü uygulamaları Power BI panolarıyla güçlendirirken 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) giriş yapın ve sol bölmede Çözümler öğesini 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.

   • Name. 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 doğru sunucuya ve tabloya bağlamak için gereken bağlantıda olmayan 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.
     • Seçilen tür Secret ise Power Platform'un gizli anahtara erişmesine izin vermek için Azure Key Vault'u ayarlayıp yapılandırmak amacıyla ek bilgi gereklidir.

   • Geçerli Değer. 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ımın ve varsayılan değerin, değerden ayrı olarak bakımını yapmanızı sağlar. Örneğin, bir uygulama yayımcısı Market'te teklifini varsayılan değerle 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ımladığında, müşteri tarafından ayarlanan değer ü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 General 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. Hedef ortamda tablo adı yapısı, özgün ortamda olduğu gibi kaldığı sürece çalışır.

Farklı bir ortamdan dış tablo kullanıyorsanız (Ortamı Değiştir aracılığıyla) Power Apps her zaman tam olarak aynı tabloya başvurmak istediğinizi varsayar. Geliştirmeden teste veya üretim ortamına geçiş yaparken bu dış tablonun farklı bir dış tablo olması gerekiyorsa bir ortam değişkenine ihtiyacınız vardır. Power Apps ortam değişkenini sizin için otomatik olarak oluşturmasına izin vermek en kolayıdır. (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ı destekler. Bu nedenle, SharePoint için geçerli bir bağlantıya ek olarak Site ve Liste için ayrı bir ortam değişkeni gerekir.

ortam değişkenlerini SharePoint listeleriyle 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.
• SharePoint ortam değişkenlerinde eşleşen meta veriler olmalıdır. SharePoint, hedef ortamlar arasında eşleşmeyebilecek iç 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 SharePoint sitesini çoğaltıp hedef ortamınıza kopyalarsanız meta veriler her zaman eşleşir.

SQL Server

SQL Server birçok farklı kimlik doğrulama türünü ve bağlantıyı 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ü connection string 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ına sahip bağlayıcılar için kullanılır. Bu tür bağlantılarda, Power Apps yalnızca tanımlanmış bir kullanıcı vardır. Power Apps, hangi hizmet veya tabloyla çalışmak istediğinizi bağlantıdan 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.

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 engellemeyen 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ü dışarı aktarmadan önce, değeri çözümünüzden kaldırabilirsiniz. Bu, mevcut değerin geliştirme ortamınızda kalmasını ancak çözümde dışarı aktarılmamasını sağlar. 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. 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 Her ne kadar bağlantılarla ilişkili olsalar da, bir bağlantı, bağlayıcıyla etkileşim kurmak için gereken bir kimlik bilgisi veya kimlik doğrulaması anlamına gelir. 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ı hakkında 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?

Güncellenmiş ortam değişkenlerinin tam olarak yayımlanması, değerlerin uygulamalara ve akışlara zaman uyumsuz olarak gönderilmesi nedeniyle bir saat kadar sürebilir.

Premium lisanslar gerekli midir?

Hayır ALM için Dataverse (veya Dynamics 365 uygulamaları) gerekirken premium bağlayıcıların kullanılması 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üntülenen 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 taşınır ve bu nedenle yönetimleri daha kolaydır ve içeri aktarım sırasında daha performanslıdır.

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 listelerin kullanıcı dostu 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 site 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 ortama aktarılırken yeni bir değerin sağlanmasına olanak tanır.

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 kullanın
EnvironmentVariableDefinition tablosu/varlık başvurusuWeb API örnekleriTuval uygulamalarında veri kaynağı ortam değişkenlerini kullanma Power Automate çözüm bulut akışlarında ortam değişkenlerini kullanma Azure Key Vault sırlarını kullanma Özel bağlayıcılarda ortam değişkeni desteğiPower Apps Blogu: Önizlemede kullanılabilen ortam değişkenleri!