Uyarı Geçişi (Önizleme)
Uyarı Geçişi, SharePoint Uyarılarının devre dışı bırakılmasını daha zengin ve modern bildirimlerle değiştirmenize yardımcı olur. Genel değiştirilmiş bildirimler yerine tam olarak nelerin değiştiğini gösterebilmeniz için ayrıntılı alan düzeyinde değişiklikler ve kullanıma hazır uyarı HTML'i döndürür.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Government bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri: - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| Name | independNET Desteği |
| URL | https://independnet.com.au/alert-relay/support |
| E-posta | support@alertbridge.com.au |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | independNET Ürünleri |
| Web Sitesi | https://independnet.com.au/alert-relay/ |
| Gizlilik ilkesi | https://independnet.com.au/alert-relay/privacy |
| Kategoriler | Işbirliği; Verimli -lik |
Uyarı Geçişi
Uyarı Geçişi, SharePoint Uyarılarının devre dışı bırakılmasını Microsoft 365 ortamları için daha zengin ve modern bildirimlerle değiştirmenize yardımcı olur. Biçimlendirilmiş alan düzeyi karşılaştırmaları ve kullanıma hazır HTML uyarı çıkışı dahil olmak üzere ayrıntılı SharePoint öğesi ve belge değişikliği bilgileri sağlar.
Genel bakış
Uyarı Geçişi, varsayılan "öğe değiştirildi" deneyiminden daha kullanışlı SharePoint bildirimleri isteyen oluşturucular için tasarlanmıştır.
Şu desteği destekler:
- ayrıntılı alan düzeyinde değişiklik denetimi
- uyarı e-postaları için kullanıma hazır HTML çıkışı
- temel ve ilk çalıştırma kararları için tetikleyici belirteci ayrıştırma
- SharePoint listeleri
- belge kitaplıkları
- Site Sayfaları / sayfa kitaplıkları
Önemli Özellikler
1. Ayrıntılı değişiklik izleme
Bağlayıcı, SharePoint öğesinin veya belgesinin geçerli sürümünü önceki bir sürümle karşılaştırabilir ve yapılandırılmış değişiklik ayrıntılarını döndürebilir.
2. Kullanıma hazır HTML uyarı çıkışı
Bağlayıcı, akışların karmaşık HTML ifadelerini el ile oluşturmadan yararlı uyarı e-postaları gönderebilmesi için biçimlendirilmiş HTML oluşturabilir.
3. Belirteç ayrıştırma tetikleme
Eylem Parse Compare From , gibi TriggerWindowStartToken SharePoint değişiklik belirteçlerinin kodunu çözer ve akışlarda karar verme için eklenmiş zaman damgasını ve belirteç ayrıntılarını döndürür.
4. Dinamik açılan menüler
Bağlayıcı aşağıdakiler için dinamik açılan menü desteği içerir:
- sites
- listeler ve kitaplıklar
- tarih biçimleri
- zaman biçimleri
- saat dilimleri
5. Esnek karşılaştırma temeli
Bağlayıcı aşağıdakilerden karşılaştırmayı destekler:
- SharePoint tetikleyici belirteçleri
- ham SharePoint değişiklik belirteçleri
- sürüm etiketleri
- ISO 8601 tarih/tarih-saat temelleri
Desteklenen Eylemler
Ayrıntılı Değişiklikleri Al
Önceki ve geçerli biçimlendirilmiş değerler de dahil olmak üzere değiştirilmiş alanları açıklayan yapılandırılmış JSON döndürür.
Uyarı HTML'i Olarak Ayrıntılı Değişiklikleri Alma
E-posta veya diğer HTML özellikli hedefler için kullanıma hazır HTML çıktısı ve ilgili uyarı meta verilerini döndürür.
Ayrıştırma KarşılaştırmaSı
SharePoint tetikleyicisinin/değişiklik belirtecinin kodunu çözer ve eklenmiş zaman damgasını ve belirteç ayrıntılarını döndürür.
Tipik Kullanım Örnekleri
- Liste öğesi değiştiğinde daha iyi SharePoint uyarı e-postaları gönderme
- Önemli iş alanları için önceki ve geçerli değerleri göster
- Belge kitaplığı meta veri değişikliklerini izleme
- Derleme onayı, uyumluluk veya denetim bildirimi akışları
- Tetikleyici belirteci tarihlerini seçilen taban çizgisine göre değerlendirerek gürültülü ilk çalıştırma uyarılarını gizleme
Authentication
Uyarı Geçişi, API abonelik anahtarıyla birlikte Microsoft Entra ID kimlik doğrulamayı kullanır.
Bağlayıcıyı kullanmak için kullanıcının şunları yapması gerekir:
- ilgili SharePoint sitesine, listesine veya kitaplığına erişim
- geçerli bir Uyarı Geçişi bağlantısı
- geçerli bir Uyarı Geçişi API'si abonelik anahtarı
Kiracı uyarı geçişini ilk kullandığında, otomatik olarak deneme moduna alınır. Deneme modundan çıkmak için ile iletişime geçin support@alertbridge.com.au.
Başlangıç Yapmak
Tipik bir doğrulama akışı aşağıdakini kullanır:
- Gibi bir SharePoint tetikleyicisi
When an item is created or modified - Uyarı Geçişi eylemi
Get Detailed Changes as Alert HTML - Döndürülen konuyu ve HTML çıkışını kullanmak için bir e-posta veya Oluşturma adımı
Yapılandırılmış aşağı akış işleme için, döndürülen changedFields diziyi kullanın Get Detailed Changes ve yineler.
Bilinen Sorunlar ve Sınırlamalar
- SharePoint Online desteklenir; Şirket içi SharePoint Server desteklenmez.
- Tetikleyici belirteçleri öğe başına uyarı geçmişi yerine SharePoint tetikleyici penceresini yansıttığı için SharePoint tetikleyici zamanlaması ilk çalıştırma karşılaştırmalarını etkileyebilir.
Support
Web sitesi:
Gizlilik İlkesi:
Destek:
Destek e-postası:
- support@alertbridge.com.au
Ek Notlar
Uyarı Geçişi, özellikle HTML e-posta biçimlendirmesi ve alan düzeyinde değişiklik denetimi için akışlarda gereken özel ifade çalışma miktarını azaltarak SharePoint tabanlı bildirim senaryolarında kullanılabilirliği artırmayı amaçlar.
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Varsayılan | Bağlantı oluşturmak için parametreler. | Tüm bölgeler | Paylaşılamaz |
Temerrüt
Geçerli: Tüm bölgeler
Bağlantı oluşturmak için parametreler.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Ayrıntılı Öğe Değişikliklerini Alma |
SharePoint liste öğesi veya belgesi için geçerli sürümü önceki sürümle karşılaştırarak ayrıntılı, biçimlendirilmiş alan düzeyi değişiklikleri alır. Yerleşik SharePoint stili true/false alan bayrakları yerine zengin değişiklik verileri istediğinizde bunu kullanın. |
| Ayrıntılı Öğe Uyarısı HTML'sini Alma |
SharePoint öğe değişiklikleri için kullanıma hazır Uyarı Geçişi HTML'sini döndürür; öncelikle SharePoint stili uyarı e-postaları için tasarlanmıştır, ancak belgelerde veya diğer HTML özellikli hedeflerde de kullanılabilir. |
| Ayrıştırma KarşılaştırmaSı |
TriggerWindowStartToken veya ham SharePoint değişiklik belirtecinin kodunu çözer ve akış koşulları ve temel kararlar için eklenmiş zaman damgasını döndürür. Bu eylem SharePoint'i çağırmaz. |
Ayrıntılı Öğe Değişikliklerini Alma
SharePoint liste öğesi veya belgesi için geçerli sürümü önceki sürümle karşılaştırarak ayrıntılı, biçimlendirilmiş alan düzeyi değişiklikleri alır. Yerleşik SharePoint stili true/false alan bayrakları yerine zengin değişiklik verileri istediğinizde bunu kullanın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Site URL’si
|
siteUrl | True | string |
Liste veya kitaplığı içeren SharePoint sitesinin tam URL'si (örneğin, |
|
Liste veya Kitaplık
|
listId | True | string |
SharePoint listesinin veya kitaplığının GUID veya tam başlığı. Açılan liste GUID değerlerini döndürür, ancak el ile giriş guid veya tam liste başlığı kullanabilir. |
|
Madde Kodu
|
itemId | True | integer |
Değişiklikleri analiz etmek için SharePoint öğesinin veya dosyasının kimliği (tetikleyici çıkışlarından kimlik olarak kullanılabilir). |
|
Karşılaştır:
|
triggerWindowStartToken | string |
Değişiklik karşılaştırması için başlangıç noktasını tanımlar. SharePoint tetikleyicisinin {TriggerWindowStartToken} (önerilir), '5.0' gibi bir sürüm etiketi, ham bir SharePoint değişiklik belirteci veya '2026-03-30' veya '2026-03-30T14:15:00Z' gibi bir ISO 8601 temel tarihi/tarihi kabul eder. Yalnızca tarih değerleri seçilen Saat Diliminde gece yarısı veya Saat dilimi boşsa UTC olarak yorumlanır. Hemen önceki sürümle karşılaştırmak için atla. |
|
|
İkincil Sürümleri Dahil Et
|
includeMinorVersions | boolean |
Küçük veya taslak sürümlerin karşılaştırmaya katılması gerekip gerekmediği. Varsayılan olarak false kullanılır; bu da yalnızca ana sürümlerin kullanıldığı anlamına gelir. |
|
|
Değişmemiş Alanları Dahil Et
|
includeUnchangedFields | boolean |
Yanıta değişmemiş alanların dahil edilip edilmeyeceği. Varsayılan değer true'dır. |
|
|
Tarih Biçimi
|
dateFormat | string |
DateTime alanları için özel tarih biçimi (örneğin, 'yyyy-AA-gg', 'dd/AA/yyyy', 'AA/gg/yyyy'). Belirtilmezse varsayılan olarak 'yyyy-MM-dd' olur. |
|
|
Saat Biçimi
|
timeFormat | string |
DateTime alanları için tarihe saat eklenmiş saat biçimi (örneğin, 'SS:mm:ss', 'SS:mm', 'ss:mm tt'). Belirtilmezse varsayılan olarak 'HH:mm:ss' olur. |
|
|
Timezone
|
timezone | string |
Tarih/saat dönüştürmesi için IANA saat dilimi kimliği (örneğin, 'Amerika/New_York', 'Avrupa/Londra', 'Avustralya/Sidney'). Belirtilmezse varsayılan olarak UTC olur. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Success
|
success | boolean |
İşlemin başarıyla tamamlanıp tamamlanmadığını gösterir |
|
Message
|
message | string |
Sonucu açıklayan insan tarafından okunabilir ileti |
|
Değiştirilen Alanlar
|
changedFields | array of object |
Dizi olarak izlenen alanlar. |
|
Sütun Değeri Değişti
|
changedFields.hasChanged | boolean |
Bu alanın değeri önceki ve geçerli sürüm arasında değiştiyse True |
|
Önceki Sütun Değeri (Metin)
|
changedFields.previousAsString | string |
İnsan tarafından okunabilir bir dize olarak biçimlendirilmiş önceki değer |
|
Alan İç Adı
|
changedFields.internalName | string |
İç SharePoint alan adı |
|
Alan Adı
|
changedFields.displayName | string |
Alan için kolay görünen ad |
|
Önceki Sütun Değeri (Ayrıntılı)
|
changedFields.previous |
Ham önceki değer. Bu özellik dinamiktir ve SharePoint alan türüne bağlı olarak dize, sayı, boole, nesne, dizi veya null olabilir. |
|
|
Geçerli Sütun Değeri (Metin)
|
changedFields.currentAsString | string |
İnsan tarafından okunabilir bir dize olarak biçimlendirilmiş geçerli değer |
|
Geçerli Sütun Değeri (Ayrıntılı)
|
changedFields.current |
Ham geçerli değer. Bu özellik dinamiktir ve SharePoint alan türüne bağlı olarak dize, sayı, boole, nesne, dizi veya null olabilir. |
|
|
Karşılaştırma Temeli Var
|
hasComparisonBaseline | boolean |
Geçerli sürümle karşılaştırma için ayrı bir temel sürüm çözümlendiyse True. |
|
Temel İlk Sürümdür
|
isBaselineFirstVersion | boolean |
Çözümlenen temel sürüm, öğe veya dosya için kaydedilen ilk sürümse True. |
|
Geçerli Sürüm Etiketi
|
currentVersionLabel | string |
Geçerli sürümün sürüm etiketi (örneğin, '2.0', '5.0') |
|
Önceki Sürüm Etiketi
|
previousVersionLabel | string |
Karşılaştırma için kullanılan sürüm etiketi (örneğin, '1.0', '4.0') |
|
Öğe Başlığı
|
itemTitle | string |
Değiştirilen öğenin başlığı |
|
Öğe URL'si
|
itemUrl | string |
Değiştirilen SharePoint öğesine doğrudan bağlantı |
|
Değiştirme Tarihi
|
modifiedDate | date-time |
En son değişikliğin zaman damgası |
|
Tarafından Değiştirildi
|
modifiedBy | string |
Öğeyi son değiştiren kullanıcının görünen adı |
|
Error
|
error | string |
Başarı yanlışsa hata ayrıntıları |
Ayrıntılı Öğe Uyarısı HTML'sini Alma
SharePoint öğe değişiklikleri için kullanıma hazır Uyarı Geçişi HTML'sini döndürür; öncelikle SharePoint stili uyarı e-postaları için tasarlanmıştır, ancak belgelerde veya diğer HTML özellikli hedeflerde de kullanılabilir.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Site URL’si
|
siteUrl | True | string |
Liste veya kitaplığı içeren SharePoint sitesinin tam URL'si. |
|
Liste veya Kitaplık
|
listId | True | string |
SharePoint listesinin veya kitaplığının GUID veya tam başlığı. Açılan liste GUID değerlerini döndürür, ancak el ile giriş guid veya tam liste başlığı kullanabilir. |
|
Madde Kodu
|
itemId | True | integer |
Değişiklikleri analiz etmek için SharePoint öğesinin veya dosyasının kimliği. |
|
Karşılaştır:
|
triggerWindowStartToken | string |
Değişiklik karşılaştırması için başlangıç noktasını tanımlar. SharePoint tetikleyicisinin {TriggerWindowStartToken} (önerilir), '5.0' gibi bir sürüm etiketi, ham bir SharePoint değişiklik belirteci veya '2026-03-30' veya '2026-03-30T14:15:00Z' gibi bir ISO 8601 temel tarihi/tarihi kabul eder. Yalnızca tarih değerleri seçilen Saat Diliminde gece yarısı veya Saat dilimi boşsa UTC olarak yorumlanır. Hemen önceki sürümle karşılaştırmak için atla. |
|
|
İkincil Sürümleri Dahil Et
|
includeMinorVersions | boolean |
Küçük veya taslak sürümlerin karşılaştırmaya katılması gerekip gerekmediği. Varsayılan olarak false kullanılır; bu da yalnızca ana sürümlerin kullanıldığı anlamına gelir. |
|
|
Değişmemiş Alanları Dahil Et
|
includeUnchangedFields | boolean |
Değiştirilmemiş alanların oluşturulan HTML'ye eklenip eklenmeyeceği. Varsayılan değer true'dır. |
|
|
Tarih Biçimi
|
dateFormat | string |
DateTime alanları için özel tarih biçimi (örneğin, 'yyyy-AA-gg', 'dd/AA/yyyy'). Belirtilmezse varsayılan olarak 'yyyy-MM-dd' olur. |
|
|
Saat Biçimi
|
timeFormat | string |
DateTime alanları için tarihe saat eklenmiş saat biçimi (örneğin, 'SS:mm:ss', 'SS:mm', 'ss:mm tt'). |
|
|
Timezone
|
timezone | string |
Tarih/saat dönüştürmesi için IANA saat dilimi kimliği (örneğin, 'Amerika/New_York', 'Avrupa/Londra', 'Avustralya/Sidney'). |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Success
|
success | boolean |
İşlemin başarıyla tamamlanıp tamamlanmadığını gösterir |
|
Message
|
message | string |
Sonucu açıklayan insan tarafından okunabilir ileti |
|
HTML Gövdesi
|
htmlBody | string |
Uyarı e-postalarında veya html özellikli diğer hedeflerde kullanıma hazır TAM HTML gövdesi |
|
Önerilen Konu
|
subject | string |
Uyarı için önerilen konu satırı |
|
Öğe Başlığı
|
itemTitle | string |
Değiştirilen öğenin başlığı |
|
Öğe URL'si
|
itemUrl | string |
Değiştirilen SharePoint öğesine doğrudan bağlantı |
|
Yeni Öğe
|
isNewItem | boolean |
Uyarı, var olan bir öğeye güncelleştirme yerine yeni bir SharePoint öğesine veya dosyasına yönelikse true. |
|
Error
|
error | string |
Başarı yanlışsa hata ayrıntıları |
Ayrıştırma KarşılaştırmaSı
TriggerWindowStartToken veya ham SharePoint değişiklik belirtecinin kodunu çözer ve akış koşulları ve temel kararlar için eklenmiş zaman damgasını döndürür. Bu eylem SharePoint'i çağırmaz.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Karşılaştır:
|
compareFrom | True | string |
TriggerWindowStartToken veya ham SharePoint belirtecini kod çözme olarak değiştirir. Sürüm etiketleri ve ISO tarih/tarih-saat değerleri bu eylem tarafından desteklenmez. |
|
Timezone
|
timezone | string |
Yerel karşılaştırma değeri için isteğe bağlı IANA saat dilimi kimliği (örneğin, 'Amerika/New_York', 'Avrupa/Londra', 'Avustralya/Sidney'). Atlanırsa, yalnızca UTC değeri döndürülür. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Belirteç Tarih Saati UTC
|
tokenDateTimeUTC | date-time |
UTC'de belirteç zaman damgası. |
|
Belirteç Tarih Saati Yerel
|
tokenDateTimeLocal | date-time |
Belirteç zaman damgası istenen saat dilimine dönüştürüldü. |
|
Kodu Çözülen Belirteç
|
decodedToken | string |
Kodu çözülen ham belirteç metni. Ham belirteç girişi için bu, özgün değerle eşleşir. |
|
Base64 Belirtecidir
|
isBase64Token | boolean |
Gelen belirteç base64 kodlandığında true. |
|
Sequence
|
sequence | integer |
SharePoint, belirteçte katıştırılmış sıra değerini değiştirir. |
|
Liste GUID'i
|
listGuid | uuid |
Belirteçte katıştırılmış liste veya kitaplık GUID'i. |
|
Belirteç Sürümü
|
tokenVersion | integer |
Belirteç sürüm numarası. |
|
Belirteç Türü
|
tokenType | integer |
SharePoint belirteç türü numarası. |
|
Error
|
error | string |
Ayrıştırma başarısız olduğunda hata ayrıntıları. |