Özel işlem eylemi oluşturma
Sistemde bir dizi komutu otomatik hale getirmek istediğinizde özel işlem eylemleri kullanın. Özel işlem eylemleri, geliştiricilerin iş süreçlerini ifade etmesi için kullanabileceği sözlüğü genişletir. Bir özel işlem eylemi Onayla, Yükselt, Yönlendir veya Zamanla gibi daha açıklayıcı fiiller oluşturmak için sistem tarafından sağlanan Oluştur, Güncelleştir, Sil ve Ata gibi çekirdek fiilleri kullanır. Bir iş sürecinin tanımı değişirse, geliştirici olmayan birisi, özel işlem eylemini düzenleyebilir, böylelikle kodun değiştirilmesi gerekmez.
Not
İş akışı tasarımcısı kullanmak yerine özel işlem eylemi için mantığınızı uygulamak üzere bir eklenti yazmak istiyorsanız bunun yerine özel API kullanmanız gerekir. Daha fazla bilgi: Özel İşlem Eylemi ve özel API karşılaştırması
Özel işlem eylemi oluşturma
Önemli
Dağıtılacak bir çözümün bir parçası olarak dahil etmek için bir özel işlem eylemi oluşturuyorsanız, onu çözümün bağlamında oluşturun. Ayarlar > Çözümler kısmına gidin ve bu eylemin parçası olacağı yönetilmeyen çözümü bulun. Ardından, menü çubuğunda, Yeni > İşlem öğelerini seçin. Bu, eylemin adı ile ilişkili özelleştirme önekinin, çözümdeki diğer bileşenlerle tutarlı olmasını sağlar. Eylemi oluşturduktan sonra öneki değiştiremezsiniz.
İş akışı işlemleri gibi, özel işlem eylemleri Oluşturma İşlemi iletişim kutusunda aşağıdaki özelliklere sahiptir.
İşlem adı
İşlem için bir ad girdikten sonra işlem adından boşluklar veya özel karakterler kaldırılarak benzersiz bir ad oluşturulur.
Kategori
Bu özellik, bunun bir eylem işlemi olduğunu belirler. İşlemi kaydettikten sonra bunu değiştiremezseniz.
Tablo
Eylemler işlemleri ile, diğer işlem türleri gibi, iş akışı için bağlam sağlamak amacıyla bir tablo seçebilirsiniz, ancak Yok (genel)'i seçme tercihiniz de olabilir. Bunu, eyleminiz belirli bir tablo bağlamını gerektirmiyorsa kullanın. İşlemi kaydettikten sonra bunu değiştiremezseniz.
Tür
Bu özelliği, sıfırdan yeni bir özel işlem eylemi oluşturmayı seçmek veya var olan bir şablondan başlatmak için kullanın.
İş akışı işlemlerinden farklı olarak, aşağıdaki seçenekleri ayarlamanız gerekmez:
Başlatma Zamanı: Eylemler, kod, onları için oluşturulan iletiyi çağırdığında başlar.
Kapsam: Eylemler her zaman, çağıran kullanıcı bağlamında çalışır.
Arka planda çalışan: Eylemler her zaman gerçek zamanlı iş akışlarıdır.
Özel işlem eylemi ayrıca iş akışı işlemlerinde olmayan bir şeye sahiptir: Girdi ve çıktı bağımsız değişkenlerine.
Not
özel işlem eylemi bir iş akışından, kod yazmak zorunda kalmadan etkinleştirebilirsiniz. Daha fazla bilgi: Bir iş akışından özel işlem eylemleri çağırma.
Özel işlem eylemini düzenleme
Özel işlem eylemlerini düzenleyebilmek için önce onları devre dışı bırakmanız gerekir.
Yönetilmeyen bir çözümün parçası olarak oluşturulan veya kuruluşunuzda yüklü bir çözüm içindeki bir özel işlem eylemini düzenleyebilirsiniz. Çözüm, yönetilen bir çözüm ise onu düzenlemeniz mümkün olmayabilir. Çözüm yayımcısının, yönetilen bir çözüm ile yüklü eylemin düzenlenememesi adına, yönetilen özellikleri düzenleme seçeneği vardır.
Bir eylem kaydedildiğinde, bir benzersiz ad, işlem adı temel alınarak oluşturulur. Benzersiz ad, çözüm yayımcısı tarafından eklenen özelleştirme önekine sahiptir. Bu, bir geliştiricinin, kodunda kullanacağı iletinin adıdır.
Bir eylemi düzenlerken aşağıdaki seçenekler sunulur:
İşlem adı
İşlem oluşturulduktan ve işlem adından benzersiz bir ad oluşturulduktan sonra, işlem adını düzenleyebilirsiniz. Belirli işlemleri bulmayı daha kolay hale getirmek için bir adlandırma kuralı uygulamak isteyebilirsiniz.
Benzersiz ad
Bir eylem kaydedildiğinde, bir benzersiz ad, işlem adı temel alınarak oluşturulur. Bu benzersiz adın, çözüm yayımcısından eklenen özelleştirme öneki vardır. Bu, bir geliştiricinin, kodunda kullanacağı iletinin adıdır. İşlem etkinleştirilmişse ve kod yerinde, bu adı kullanan eylemi çağırmayı bekliyorsa, bu benzersiz adı değiştirmeyin.
Önemli
Eylem etkinleştirildikten ve benzersiz bir ad kullanmak için kod yazıldıktan sonra, ona başvuran kod değiştirilmeden benzersiz adın değiştirilmemesi gerekir.
Geri almayı etkinleştir
Genel olarak, hareketleri destekleyen işlemler, herhangi bir bölümleri başarısız olursa tüm işlemi "geri alır" (ya da geri döner). Bunun bazı istisnaları vardır: Geliştiricilerin eylemle başlatılan kodda yaptığı bazı özel işlem eylemleri hareketleri desteklemiyor olabilir. Örneğin, kod, hareketin kapsamının dışındaki diğer sistemlerde eylemler gerçekleştiriyorsa. Bunlar, uygulamada çalışan eylem tarafından geri alınamaz. Platformda bazı iletiler hareketleri desteklemez. Ancak, yalnızca eylemin kullanıcı arabirimiyle yapabileceğiniz her şey, hareketleri destekleyecektir. Gerçek zamanlı bir iş akışının parçası olan tüm eylemler, hareket içinde olarak kabul edilir, ancak eylemlerle, bunun dışında kalma seçeneğiniz vardır.
Bu iletinin hareket içinde olması gerekip gerekmeyeceğini belirlemek için, bu iletiyi kullanacak geliştiriciye danışmanız gerekir. Genel olarak, iş süreci tarafından gerçekleştirilen eylemler, tümü tamamen başarıyla tamamlanmadığı sürece anlamlı olmuyorsa, bir eylem hareket içinde olmalıdır. Klasik örnek, iki banka hesabı arasında fon aktarmadır. Bir hesaptan fon çekerseniz, onları diğer hesaba yatırmanız gerekir. Herhangi biri başarısız olursa, her ikisi de başarısız olmalıdır.
Not
Özel işlem eylemi doğrudan bir iş akışı içinden çağrılırsa geri almayı etkinleştiremezsiniz. Eylem Power Apps web hizmetleri iletisi tarafından tetiklenirse geri almayı etkinleştirebilirsiniz.
Farklı etkinleştir
Tüm işlemler gibi, işlemi bir şablon olarak etkinleştirebilir ve onu, benzer bir yol izleyen işlemler için gelişmiş bir başlangıç noktası olarak kullanabilirsiniz.
İşlem bağımsız değişkenleri tanımlama
Bu alanda, eylemin başlatmayı beklediği verileri ve eylemden hangi verilerin geçirileceğini belirteceksiniz. Daha fazla bilgi: İşlem bağımsız değişkenlerini tanımlama
Aşama ve adım ekleme
Diğer işlemler gibi, hangi eylemlerin gerçekleştirileceğini ve ne zaman gerçekleştirileceklerini belirtirsiniz. Daha fazla bilgi: Aşama ve adım ekleme
İşlem bağımsız değişkenleri tanımlama
Geliştiriciler iletileri kullandığında, iletiye aktarabilecekleri bazı verilerle başlayabilirler. Örneğin, yeni bir servis talebi satırı oluşturmak için giriş değişkeni olarak aktarılacak olan servis talebi başlık değeri olabilir.
İleti tamamlandığında, geliştiricinin iletiyle değiştirilen veya oluşturulan bazı verileri, kodlarındaki başka bir işleme geçirmesi gerekebilir. Bu veri, çıktı bağımsız değişkenidir.
Her iki giriş ve çıkış bağımsız değişkenlerini bir adı, bir türü ve bağımsız değişkenin her zaman gerekli olup olmadığı hakkında bazı bilgileri olması gerekir. Ayrıca bir açıklama da sağlayabilirsiniz.
İletinin adı ve tüm işlem bağımsız değişkenleri hakkında bilgiler, ileti için imzayı temsil eder. Bir özel işlem eylemi etkinleştirildikten sonra ve kodda kullanılmakta olduğunda, imzanın değişmemesi gerekir. İmza değişirse iletiyi kullanan herhangi bir kod başarısız olur. Bunun tek istisnası, parametrelerin birinin, her zaman gerekli olmayacak şekilde değiştirilmesi olabilir.
Sıralama yapılarak veya yukarı ya da aşağı taşınarak bağımsız değişkenlerin düzenini değiştirebilirsiniz çünkü bağımsız değişkenler düzene göre değil ada göre tanımlanır. Ayrıca açıklamanın değiştirilmesi iletiyi kullanan kodu kesmez.
Eylem işlemi bağımsız değişken türleri
Aşağıdaki tabloda, eylem işlemi bağımsız değişken türleri açıklanmaktadır.
| Tür | Açıklama |
|---|---|
| Boole | Bir true veya false değeri. |
| Tarih Saat | Tarih ve saat bilgilerini depolayan bir değer. |
| Ondalık | Ondalık duyarlılığı olan bir sayı değeri. Duyarlılık son derece önemli olduğunda kullanılır. |
| Tablo | Belirtilen tablo için bir satır. Tabloyu seçtiğinizde, açılan liste etkinleşir ve tablo türünü seçmenize olanak tanır. |
| entityCollection | Tablo satırları koleksiyonu. |
| entityReference | Onu benzersiz olarak tanımlayan, bir tablo satırının adını, kimliğini ve türünü içeren bir nesne. entityReference'ı seçtiğinizde, açılan liste etkinleşir ve tablo türünü seçmenize olanak tanır. |
| Float | Ondalık duyarlılığı olan bir sayı değeri. Veriler, her zaman mutlak suretle kesin olmayan bir ölçümden geldiğinde kullanılır. |
| Tamsayı | Bir tamsayı. |
| Para | Bir para miktarı hakkında veri depolayan bir değer. |
| Seçim Listesi | Bir OptionSet özniteliği hakkında bir seçeneği temsil eden bir değer. |
| String | Bir metin değeri. |
Not
entityCollection bağımsız değişkeni değerleri, koşullar veya eylemler için kullanıcı arabiriminde ayarlanamaz. Bunlar, özel kodda geliştiriciler tarafından kullanılmak üzere sağlanmıştır. Daha fazla bilgi: Kendi iletilerinizi oluşturma
Aşama ve adım ekleme
Özel işlem eylemleri gerçek zamanlı iş akışlarına oldukça benzer bir işlem türüdür. Gerçek zamanlı iş akışlarında kullanılabilecek tüm adımlar, eylemlerde kullanılabilir. Gerçek zamanlı iş akışları ve eylemler için kullanılabilecek adımlar hakkında bilgi için bkz. İş akışı aşamaları ve adımları.
Gerçek zamanlı iş akışları için kullanılabilen adımlara ek olarak, eylemlerde ayrıca Değer Ata adımı bulunur. Eylemlerde, bunlar yalnızca çıkış bağımsız değişkenlerini ayarlamak için kullanılabilir. Çıkış değişkenlerini belirli değerlere, ya da daha olması muhtemel şekilde, eylemin ona doğru çalıştığı satırdan, çoğa bir ilişkisiyle o satırla ilişkili satırlardan önceki bir adımda oluşturulan satırlardan değerlere veya işlemin kendisinin parçası olan değerlere çıkış bağımsız değişkenleri ayarlamak için form yardımcısını kullanabilirsiniz.
Yönetilen özellikler
Özel işlem eylemleri için iki ilgili yönetilen özellik vardır.
Özelleştirilebilir
Özelleştirilebilir Mi? yönetilen özelliği, özel işlem eylemi içeren yönetilen çözümü yükleyen bir kişinin bunu düzenleme ya da silme yetkisi olup olmadığını denetler. Bir yönetilen çözüme eklendiğinde özel işlem eyleminin düzenlenebilmesini veya silinebilmesini istiyorsanız, bu özelliği doğru olarak ayarlamalısınız.
Özel İşleme Adımına Diğer Yayımcılar İçin İzin Veriliyor Mu?
Özel İşleme Adımına Diğer Yayımcılar İçin İzin Veriliyor Mu? adlı yönetilen özellik üçüncü taraf eklenti geliştiricilerinin, özel işlem eylemi tarafından oluşturulan iletiye eklenti adımları kaydedip kaydedemeyeceklerini denetler. Bu doğru olarak ayarlandığında bu iletideki herhangi biri tarafından kaydedilen eklentiler çalışır ve özel işlem eyleminin davranışını değiştirebilir. Yanlış olarak ayarlandığında yalnızca aynı çözüm yayımcısından bir çözüm içinde kayıtlı eklenti adımları çalışır.
Sonraki adımlar
Bir iş akışından özel işlem eylemleri çağırma
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).