İş birliğini artırmak için uyarlamalı kartı bildirimle değiştirme

Bu makalede, Çalışanların Fikirleri uygulamasından gelen bildirimleri Teams'teki HTML tabanlı iletiler yerine Teams'teki uyarlamalı kartlar olarak değiştirme hakkında bilgi sağlanmaktadır. Şu anda Teams bildirimleri uygulama içinden başlatılmakta ve Teams kanalına gönderilen ileti olarak gönderilmektedir. Bu Teams kanalı bildirimi, bir Power Automate akışı kullanılarak başlatılacak uyarlamalı kart bildirimiyle değiştirilecektir.

Bildirimleri uyarlamalı kart ile değiştirme hakkında bilgi edinmek için bu videoyu izleyin:

Önkoşullar

Bu dersi tamamlamak için belirli Microsoft 365 abonelikleri kapsamında sunulacak Microsoft Teams'te oturum açma becerisine ve ayrıca Çalışanların Fikirleri örnek uygulamasına sahip olmamız gerekir.

Uyarlamalı kartı oluşturmak için Power Automate akışını oluşturma

Başlamak için geçerli bildirimi uyarlamalı kartla değiştirmek üzere bir akış oluşturalım.

1. Teams için Power Apps kişisel uygulamasını açın ve Çalışanların Fikirleri uygulamasını bulun. Kullanım kolaylığı için Teams'te Power Apps logosuna sağ tıklayıp Uygulamayı aç seçeneğini belirleyerek Power Apps Studio'nun kendi penceresinde çalışabilirsiniz.

2. Teams'te Power Apps Studio'yu açmak ve uygulamayı düzenlemeye başlamak için Fikirler uygulamasını seçin.

3. Üst menüde Ayarlar seçeneğinin sağında yer alan dikey üç noktayı seçin. Power Automate, Koleksiyonlar ve Değişkenler seçeneklerini görürsünüz.

4. Sağdaki Veri kenar çubuğu menüsünü açmak için Power Automate'i seçin. Kullanılabilir tüm akışları görebilirsiniz.

5. Yeni akış oluştur'u seçin. Power Automate Studio'yu ayrı bir tarayıcı penceresinde görürsünüz. Devam etmeden önce değiştirmeye çalıştığınız uygulamayı içeren doğru Takım ortamında olduğunuzdan emin olun.

6. Sol üst alanda Başlıksız olarak adlandırılan akışı görürsünüz. Metni seçerek adı Çalışanların Fikirleri Uyarlamalı Karttan Teams'e olarak değiştirin.

7. Power Apps tetikleyicisini ekleyerek Power Apps'ten akışı tetikleyebilir ve Power Apps'ten Power Automate'e geçirilecek değerleri ekleyebilirsiniz.

8. Yeni bir adım eklemek için +Yeni adımını seçin > Satırı kimliğe göre al eylemini seçin ve Satır Kimliği için > Dinamik içerik menüsünü görüntülemek üzere Değer alanını seçin >Power Apps'te sor'u seçin. Bu eylem, uygulamadan Power Automate'e veri aktarmaya olanak tanımak için Power Apps tetikleyicisinde bir değişken oluşturur.

   

9. Ardından iki Değişkeni Başlat eylemi ekleyin. Bu eylemler, Power Apps'teki bilgileri depolamak ve uyarlamalı kartta Fikirler uygulamasını doğrudan kayda bağlamak için kullanılacak bir bağlantı depolamak üzere kullanılır. Eylemlerden her birini aşağıdaki gibi yeniden adlandırın:

• Değişkeni başlat - Kart Başlığı

  • Ad = varCardTitle

  • Tür = Dize

• Değişkeni başlat - Kampanya

  • Ad = varCampaign

  • Tür = Dize

1. Tür değerlerinin her birini Dize olarak ayarlayın ve her biri için bir Ad ekleyin: sırasıyla varCardTitle, varCampaign ve varReviewIdeasLink.

2. Kart Başlığı ve Kampanya eylemleri için Dinamik içerik menüsünü görüntülemek üzere Değer alanını ve ardından Power Apps'te sor'u seçin. Bu yapılandırma, uygulamadan Power Automate'e veri aktarmaya olanak tanımak için Power Apps tetikleyicisinde bir değişken oluşturur.

   

3. Fikirler Bağlantısını İncele eylemi için uygulamanın bağlantısını kullanacağız. Bu bağlantıyı bulmak için Fikirler uygulamasının bulunduğu Takıma gidin ve uygulamanın yüklü olduğu sekmenin bağlantısını kopyalayın. Sekmeyi açıp sağ üst köşedeki üç noktayı (...) seçerek bağlantıyı sekmeye kopyalayabilirsiniz.

   

   URL'niz aşağıdaki örnektekine benzer olmalıdır.

   https://teams.microsoft.com/l/entity/GUID/_djb2_msteams_prefix_1434832750?context=%7B%22subEntityId%22%3Anull%2C%22channelIdGUIDthread.tacv2%22%7D&groupId=GUID&tenantId=GUID

4. Devam etmek için, URL'nin context= öğesinden sonra gelen kısmını kopyalayın ve metni çözmek için https://www.urldecoder.org/ gibi bir URL kod çözücüsü kullanın.

   

5. Kodu çözülmüş metni kopyalayın ve Power Automate akışına geri dönün.

6. Değişkeni başlatmak için akışa yeni bir adım ekleyin.

   • Fikirler Bağlantısını İncele değişkenini başlatma adımını yeniden adlandırma

   • Küme Adı = varReviewIdeasLink

   • Tür Seç = Dize

   • Değer Girin = {yukarıdaki url'den kopyalanan metni yapıştırın}

   

7. Oluştur eylemi ile yeni bir adım ekleyin ve Girişler alanına aşağıdaki kodu yapıştırın:

   replace(replace(replace(variables('varReviewIdeasLink'),'{','%7B'),'"','%22'),'}','%7D')
   

   

8. Uyarlamalı kartı sohbet veya kanalda gönder eylemini ekleyin. Farklı gönder değerini Kullanıcı ve Şuraya gönder değerini Kanal olarak ayarlayın. Takım ve Kanal alanlarında, uyarlamalı kartı göndermek istediğiniz Takımı ve Kanalı seçin.

9. Aşağıdaki örnek kod yalnızca örnek verme amacıyla kullanılmıştır ancak kendi kartlarınızı tasarlayabilirsiniz.

   İpucu

   Uyarlamalı kartlar hakkında daha fazla bilgiyi https://adaptivecards.io/ adresinden ve görsel bir düzenleyicide kendi kartlarınızı tasarlama hakkında daha fazla bilgiyi https://adaptivecards.io/designer/ adresinden edinebilirsiniz.

   Uyarlamalı Kart alanına aşağıdakileri kopyalayıp yapıştırın:

   {
   
   "type": "AdaptiveCard",
   
   "body": [
   
   {
   
   "type": "TextBlock",
   
   "size": "large",
   
   "weight": "Bolder",
   
   "text": "@{variables('varCardTitle')}",
   
   "wrap": true
   
   },
   
   {
   
   "type": "TextBlock",
   
   "text": "A new idea has been submitted!",
   
   "wrap": true
   
   },
   
   {
   
   "type": "TextBlock",
   
   "text": "For the campaign: @{variables('varCampaign')}",
   
   "wrap": true
   
   }
   
   ],
   
   "actions": [
   
   {
   
   "type": "Action.OpenUrl",
   
   "title": "View @{variables('varCardTitle')}",
   
   "url":
   "https://teams.microsoft.com/l/entity/b7fad6ce-2e23-4aba-b209-859a59ca230e/_djb2_msteams_prefix_1434832750?context=@{outputs('Compose')}"
   
   }
   
   ],
   
   "\$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
   
   "version": "1.2"
   
   }
   

10. Konu alanına aşağıdaki kodu kopyalayıp yapıştırın:

    New idea submitted for @{variables('varCampaign')} Campaign
    

    

Bu eylem, uyarlamalı kartın özelliklerini ayarlar ve uyarlamalı karttaki Power Apps değişkenlerini kullanır.

Düzgün çalıştığından emin olmak için akışı kaydedip test edin. Test akışı kenar çubuğundan el ile seçim yaparak Kart Başlığı, Kampanya ve Fikirler Bağlantısını İncele değişkenlerini girebilirsiniz.

Fikirler uygulamasına akış ekleme

Düzgün çalıştığını doğruladıktan sonra akışı Fikirler uygulamasına ekleyebilirsiniz.

1. Fikirler uygulamasının düzenlendiği Power Apps Studio'ya geri dönün.

2. Sol taraftaki Ağaç Görünümünde, Kampanya Ayrıntısı Ekranını seçin.

3. Ardından Fikir gönder düğmesini seçin (Ağaç Görünümünde btnCampaignIdeaControls_Submit olarak adlandırılır). Oluşturduğumuz Power Automate akışını bu düğmeye ekleriz.

   

4. İlk olarak, şu anda düğmenin OnSelect özelliğinde bulunan kodu kopyalarız. Power Apps'teki denetimlere Power Automate akışlarının eklemeyle ilgili bir sorun, denetimdeki mevcut tüm kodların kaldırılmasıdır. Bu sorunu çözmek için kopyalanan kodu Not Defteri gibi bir metin düzenleyiciye yapıştırın ve işlem tamamlandığında OnSelect özelliğine geri yapıştırılabilecek şekilde düzenleyin. Kodu yapıştırdıktan sonra kodun tamamının eklendiğinden emin olun.

5. Düğme seçili durumdayken üst menü çubuğunda Ayarlar'ın sağındaki dikey üç noktayı seçin. Power Automate seçildiğinde Veri kenar çubuğu görüntülenir. Artık Kullanılabilir akışlar bölümünde Çalışanların Fikirleri Uyarlamalı Karttan Teams'e akışını görebilirsiniz. Bunu, düğmeye eklemek için seçin.

   Artık yapıştırılan kodu düzenlemeniz gerekir. Aşağıdaki metni bulup kaldırın:

   Notify(
   
   If(tglIdeaDetailControls_PostToTeams.Value,
   
   If(
   
   IsError(
   
   MicrosoftTeams.PostMessageToChannelV3(
   
   gblSettingTeamId,
   
   gblSettingNotificationChannelId,
   
   {
   
   content: Concatenate(
   
   "A new employee idea has been created!",
   
   "\<br\>\<br\>",
   
   "\<b\>Description\</b\>",
   
   "\<br\>",
   
   locFormRecordIdea.Description
   
   ),
   
   contentType: "html"
   
   },
   
   {subject: locFormRecordIdea.Title}
   
   )
   
   ),
   
   "Message was not posted. You may not have access to the Team and/or Channel.
   Contact the app administrator.",
   
   NotificationType.Warning
   
   )
   
   )
   
   );
   

6. Kaldırılan metnin olduğu yere aşağıdaki kodu yapıştırın:

   If(tglIdeaDetailControls_PostToTeams.Value,
   EmployeeIdeasAdaptiveCardToTeams.Run(locFormRecordIdea.Title,gblSelectedRecordCampaign.Title,locFormRecordIdea.'Employee
   Idea',locFormRecordIdea.'Employee Idea'));
   

   Bu kod, yeni eklediğimiz akışa başvuruyu ve Power Automate'e geçirilecek değişkenleri içerir.

7. Düzenlenen metnin tamamını kopyalayın ve Gönder denetleme düğmesinin OnSelect özelliğine geri yapıştırın. Düğmede hata olmadığını doğrulayın.

Gerçek kaydı Uyarlamalı Kart Bağlantısını kullanarak açmak için uygulamayı güncelleştirin

Şimdi uygulamayı köprü parametresini kabul edecek ve kayıtlara derin bağlantıyı destekleyecek şekilde güncelleştireceğiz.

Uyarlamalı kartta bizi oluşturulan Fikir kaydına geri götürmesi gereken bir bağlantı bulunur. Uygun verileri yüklemek için uygulamanın Yükleme sayfasında bazı değişiklikler yapmamız gerekiyor.

1. Ağaç görünümünden, Yükleme ekranını seçin. Ardından conLoading_HiddenHelper kapsayıcısını seçin ve bunun altından tmrLoadingDelay öğesini seçin.

2. Timer denetiminin OnTimerEnd özelliğini seçin ve If(gblAppLoaded,----------) adında bir IF koşulu olduğuna dikkat edin.

3. Bu IF koşulunun tamamını aşağıdaki IF koşuluyla değiştirin (orijinal denetimlerle birlikte birkaç denetim daha ekleyin).

   Not

   Bu kod, uygulamanın uyarlamalı karttan açılması durumunda belirli bir fikir kaydına derin bağlantı içerecek şekilde düzenlenir. Doğrudan belirli bir fikir kaydına derin bağlantı sağlamak istiyorsak ekran yüklenmeden önce tanımlanması gereken birkaç koleksiyon/değer vardır

   If(
   
   gblAppLoaded,
   
   If(
   
   !IsBlank(Param("subEntityId")), //check if the parameter is blank or not, if
   not, populate the relevant variables and collections to make deep linking work
   
   Set(
   
   gblRecordCampaignIdea,
   
   LookUp(
   
   'Employee Ideas',
   
   'Employee Idea' = GUID(Param("subEntityId"))
   
   )
   
   );
   
   ClearCollect(
   
   colResponses,
   
   Filter(
   
   'Employee Idea Responses',
   
   Idea.msft_employeeideaid = gblRecordCampaignIdea.msft_employeeideaid
   
   )
   
   );
   
   ClearCollect(
   
   colFiles,
   
   Filter(
   
   'Employee Idea Files',
   
   'Employee Idea Files'[@Idea].'Employee Idea' = gblRecordCampaignIdea.'Employee
   Idea'
   
   )
   
   );
   
   Set(
   
   gblSelectedRecordCampaign,
   
   LookUp(
   
   'Employee Idea Campaigns',
   
   'Employee Idea Campaign' = gblRecordCampaignIdea.Campaign.'Employee Idea
   Campaign'
   
   )
   
   );
   
   ClearCollect(
   
   colIdeas,
   
   Filter(
   
   'Employee Ideas',
   
   'Employee Ideas'[@Campaign].'Employee Idea Campaign' =
   gblSelectedRecordCampaign.'Employee Idea Campaign'
   
   )
   
   );
   
   If( //check if the user is on a mobile device or desktop/web and redirect the
   user accordingly to deep link into the specific idea
   
   Or(
   
   Param("hostClientType") = "android",
   
   (Param("hostClientType") = "ios" And Parent.Width \< 800)
   
   ),
   
   Navigate(
   
   'Campaign Detail Screen',
   
   ScreenTransition.None,
   
   {
   
   locVisibleCampaignIdea: true,
   
   locVisibleCampaignView: false,
   
   locCreateNewIdea: false
   
   }
   
   ),
   
   Navigate(
   
   'Mobile Idea Screen',
   
   ScreenTransition.None,
   
   {
   
   locVisibleCampaignIdea: true,
   
   locVisibleCampaignView: false,
   
   locCreateNewIdea: false
   
   }
   
   )
   
   ),
   
   If( //if the parameter is blank, check if the user is on a mobile device or
   desktop/web and redirect the user accordingly
   
   Or(
   
   Param("hostClientType") = "android",
   
   (Param("hostClientType") = "ios" And Parent.Width \< 800),
   
   tglAdmin_Mobile.Value// Studio Testing
   
   ),
   
   Navigate(
   
   'Mobile Landing Screen',
   
   ScreenTransition.None,
   
   {locShowSetup: false}
   
   ),
   
   Navigate(
   
   'Campaign Summary Screen',
   
   ScreenTransition.None,
   
   {
   
   locShowModal: (gblRecordUserSettings.'Display Splash (Power Apps)?' = 'Display
   Splash (Power Apps)? (Employee Ideas User Settings)'.Yes),
   
   locShowPowerAppsPrompt: gblRecordUserSettings.'Display Splash (Power Apps)?' =
   'Display Splash (Power Apps)? (Employee Ideas User Settings)'.Yes
   
   }
   
   )
   
   )
   
   )
   
   )
   
   
   

Bu eylem, uygulama açıldıktan sonra gerekli tüm verileri uygun şekilde yüklemelidir. Uyarlamalı karttaki kaydı seçen kullanıcı uygun fikre yönlendirilir.

Fikirler Uygulamasını yayımlama

1. Fikirler uygulamasında yapılan tüm değişiklikler tamamlanmıştır.

2. Uygulama artık sağ üst kısımdaki Teams'de yayımla seçeneği kullanılarak yayımlanabilir.

Uygulamayı test etme

1. Teams'te oturum açın ve Fikirler uygulamasının yüklü olduğu Takıma gidin.

2. En üstteki Fikirler sekmesini seçin.

3. Fikirler uygulaması açılır.

4. Kampanyalardan birini seçin (örneğin, İş Yeri Güvenliği).

   

5. Fikir gönder düğmesini seçin.

   

6. Başlığı ve Açıklamayı girin.

7. Listelenen sorular için derecelendirmeleri seçin.

8. Gereken diğer bilgileri ekleyin.

9. Tüm ayrıntılar doldurulduktan sonra Fikri gönder düğmesine basın.

10. Fikir gönderilir.

11. Uygulamanın yüklü olduğu Takıma bir bildirim gönderilir.

12. Bildirimdeki bağlantıyı seçin ve fikir kaydının açıldığını doğrulayın.

    

Ayrıca bkz.

• Çalışanların fikirleri uygulama mimarisini anlama
• Örnek uygulama şablonlarını özelleştirme
• Örnek uygulama şablonları hakkında SSS
• Microsoft Teams'de örnek uygulama şablonlarını kullanma