Parametre anahtarlarını geçirmek için otomasyon sözlüğünü kullanma
Otomasyon sözlüğü, oturumlar için bağlamsal verileri saklar. Eylem içinde parametreyi geçirmek için otomasyon sözlüğünden tuşları kullanabilirsiniz.
Yönetici uygulamasında şablon ve makro oluştururken, bir oturumun başlığı, bildirim başlığı, uygulama sekme şablonu başlığı ve uygulama sekme türlerine yönelik özel parametre değerleri gibi parametre anahtarlarını geçirebilirsiniz. Bu anahtarlar, yürütme sırasında bulunan bağlamsal bilgilere göre değiştirilir.
Şablonlarda veri parametresini geçirme
Bildirimler içeren şablonlara yönelik bir senaryoyu ele alalım.
Bildirim, sırasıyla Alan başlığı ve Değer olarak adlandırılan bazı alan ve değerleri gösterir.
Kenny Smith, bir müşteri bir görüşme başlattı ve aracı bildirimi gördüğünde müşteri adınıKenny Smith olarak görüntüler.
Burada, alan başlığı, müşteri adı ve değerKenny Smith' dir.
Müşterinin adını Kenny Smitholarak belirlemek için şablonlarda sizin (yöneticinin) parametreyi anahtar olarak geçirmesi gerekir.
Benzer şekilde, oturum ve bildirim başlıkları için veri parametrelerini geçirebilirsiniz. Daha fazla bilgi: Veri parametresi anahtarlarına yönelik otomasyon sözlüğü biçimleri
Sistem, bu parametre anahtarlarını oturumun, kanal sağlayıcısının Microsoft Dataverse ve kullanıcı eylemlerinin bağlamına göre gerçek değerlerle değiştirir. Daha fazla bilgi: Bağlam veri parametrelerinin türleri
Veri parametresini makrolarda ve aracıkomut dosyalarında geçirme
Makrolar, kullanıcı tarafından talep üzerine çalıştırılan bir dizi yapılandırılan sıralı eylem kümesidir. Yönetici olarak, bir makronun gerçekleştirmesi gereken eylemleri yapılandırmanız gerekir. Eylemleri yapılandırmak için, veri parametrelerini geçirmeniz gerekir. Daha fazla bilgi: Veri parametre anahtarlarını iletmeye yönelik otomasyon sözlüğü biçimleri
Aracı makro çalıştırdığında sistem, bu parametre anahtarlarını oturumun, kanal sağlayıcısının Dataverse ve kullanıcı eylemlerinin bağlamına göre gerçek değerlerle değiştirir.
Bağlam bir oturumdan geldiği zaman, makro eylemi, bilgilerin bir bağlantı sekmesinden veya odakta bulunan geçerli sekmesinden alındığı geçerli bir oturumla ilgili bilgilere dayalı olarak çalıştırılır. Örneğin bir servis talebi oluşturmak için, olay varlığı formunu ve formun GUID'ini içeren eylemleri tanımlamanız gerekir (isteğe bağlı). Daha fazla bilgi: Bağlam veri parametresi türleri
Bağlam veri parametrelerinin türleri
Otomasyon sözlüğü, aşağıdaki kaynaklarda bulunan bağlam verileri parametrelerini kullanır:
- Kanal sağlayıcıdan toplanan bağlam verileri
- Kullanıcı eylemlerinden bağlam verileri
- Bağlam Verileri: Dataverse
- Diğer makro eylemlerinde bağlam verileri
Kanal sağlayıcıdan toplanan bağlam verileri
Bu bağlam verileri, Customer Service için Çok Yönlü Kanal gibi birinci taraf kanal sağlayıcısından veya Dynamics 365 Kanal Tümleştirme Çerçevesi tarafından kullanıma sunulan arabirimi kullanan bir üçüncü taraf kanal sağlayıcısından gelir. Customer Service için Çok Yönlü Kanal'daki bağlam verileri arasında konuşma öncesi anket, ziyaretçi portalı gezintisine ve benzeri bulunur.
Kullanıcı eylemlerinden bağlam verileri
Bu veriler ve aracılar oturumda bazı etkinlikler yaparken olarak doldurulur. Örneğin, yeni bir müşteri kaydı, servis talebi vb. açılıyor.
Bağlam Verileri: Dataverse
Organizasyon verileri Dataverse depolanır ve OData sorgularının kullanımıyla verileri getirebilirsiniz. Daha fazla bilgi: OData sorguları
Diğer makro eylemlerinde bağlam verileri
Bir makrodaki eylem, o makrodaki diğer eylemler tarafından kullanılan bağlam verilerini oluşturur.
Örneğin, aşağıdaki sırada iki eylem adımı vardır:
- Kayıt oluşturmak için yeni bir form açın.
- Önceden tanımlanmış şablonla bir e-posta formu açın.
Önceden tanımlanmış şablon eylemiyle bir e-posta formu açın eylemi oluşturulurken Kayıt oluşturmak için yeni form açın makrı eylem adımından bağlam verileri parametre tuşlarını alabilirsiniz.
İlk makro eyleminin bağlam verileri parametresi aşağıdaki gibidir:
- Varlık Mantıksal Adı
- Sayfa Türü
- Sekme Kimliği
Not
Diğer makro eylemlerinin bağlam verileri parametreleri makrolara özgüdür ve şablonlara uygulanamaz.
Veri parametre tuşlarını iletmek için Otomasyon sözlüğünü biçimleri
Otomasyon sözlüğü, oturumlar için bağlamsal verileri saklar. Otomasyın sözlüğündeki anahtarlar, makrolardaki eyleme parametreler olarak iletilebilir. Sistem, bu parametre anahtarlarını oturumun, kanal sağlayıcısının Dataverse ve kullanıcı eylemlerinin bağlamına göre gerçek değerlerle değiştirir.
Otomasyon sözlüğü aşağıdaki biçimleri destekler:
Alanlar
Dinamik veri alanı, sistemin çalışma zamanında bir bağlama dayalı olarak doldurduğu yedek parametredir. Aşağıdaki dinamik veri alanı listesini yalnızca makrolar ve aracı komut dosyaları için ve aracı komut dosyası ifade oluşturucusunu kullanarak varsayılan olarak bir aracı komut dosyası ayarlamak üzere kullanın. Daha fazla bilgi: Üretkenlik araçları
Üretkenlik araçları için dinamik veri alanları (makrolar ve aracı komut dosyaları)
Makrolar ve aracı betikleri aşağıdaki dinamik veri alanlarını destekler:
| Dinamik Veri Alanı | Açıklama |
|---|---|
${customerName} |
Konuşmayı başlatan müşterinin adı. |
${caseId} |
Servis talebinin benzersiz tanımlayıcısı. Sistem, yalnızca bir servis talebi konuşmaya bağlıysa, servis talebi kimliğini görüntüler. |
${caseTitle} |
Servis talebinin başlığı. Sistem, yalnızca servis talebi konuşmaya bağlıysa, servis talebi başlığını görüntüler. |
${LiveWorkItemId} |
Konuşmanın benzersiz kimliği. |
${queueId} |
Kuyruğun benzersiz tanımlayıcısı. Bu alfasayısal dize, kuyruk sayfası URL'sinde görüntülenir. |
${visitorLanguage} |
Konuşmayı başlatan Müşterinin dili. |
${visitorDevice} |
Konuşmayı başlatan Müşterinin cihazı. |
${entityRoutingLogicalName} |
Bildirim bir varlık kaydı için olduğunda varlığın adı. |
${customerEntityName} |
Müşterinin kimliği doğrulanmışsa, varlığın (ilgili kişi veya firma) adı. |
${customerRecordId} |
Müşterinin kimliği doğrulanmışsa, varlığın (ilgili kişi veya firma) benzersiz tanımlayıcısı. |
${<name of the pre-conversation survey questions>} |
Bir iş akışı için yapılandırılan tüm konuşma öncesi anket sorularının adı, dinamik veri alanı adı olacaktır. |
Not
Customer Service workspace'teki makrolarda ve betiklerde yalnızca ${anchor.<attribute_name>} dinamik veri alanı desteklenir.
Yeniden bağlanma bağlantısı dinamik veri alanı
Aşağıdaki dinamik veri alanı, aynı aracıya ve konuşmaya bağlanabilmek için müşterilerle paylaşılabilecek bir yeniden bağlanma bağlantısı oluştururken kullanılır. Daha fazla bilgi: Önceki sohbete yeniden bağlanmayı yapılandırma
| Dinamik Veri Alanı | Açıklama |
|---|---|
{ReconnectUrl{ReconnectID}} |
Hızlı yanıtlarda yeniden bağlanma bağlantısını üretmek için kullanılır. |
Üretkenlik araçları için dinamik veri alanları biçimi
Bağlamı kanal sağlayıcısından, geçerli kullanıcı oturumundan, diğer makro eylemlerinin çıktısından veya Dataverse'tan alan ${Slug} parametresi biçimi.
Üretkenlik otomasyonu bağlamı
Dynamics 365'te model temelli uygulamalarla ilgili işlemleri gerçekleştirmek için kullanılan üretkenlik otomasyonu bağlamında bir dinamik veri alanını yürütmek isterseniz ${</slug/>} Örneğin: ${customerName}
Oturum bağlayıcısı bağlamı
Oturum bağlamında bir dinamik veri alanı yürütmek istediğinizde, ${$session.<slug>} biçimini kullanmanız gerekir. Örneğin: ${$session.customerName}
Oturum bağlamı için kullanılabilir olan bazı dinamik veri alanları şunlardır:
${$session.visitorDevice}${$session.visitorDevice}${$session.entityRoutingLogicalName}${$session.entityRoutingRecordId}${$session.<name of the pre-chat survey questions>
Çok yönlü kanal bağlayıcısı bağlamı
Customer Service için Çok Yönlü Kanal bağlamında bir dinamik veri alanı yürütmek istediğinizde, ${$oc.<slug>} biçimini kullanmanız gerekir. Örneğin: ${$oc.customerName}
Session.CurrentTab.<Attribute> ve Session.AnchorTab.<Attribute> parametreleri, geçerli oturuma ve bağlayıcı sekme ya da odaktaki geçerli sekmeye dayalı olarak bağlam verileri sağlar. Aşağıdakiler desteklenen öznitelik türleridir:
- EntityName
- EntityId
Örnekler:
Session.CurrentTab.<EntityName>Session.CurrentTab.<EntityId>Session.AnchorTab.<EntityName>Session.AnchorTab.<EntityId>
Not
Session.CurrentTab.<Attribute> ve Session.AnchorTab.<Attribute> parametreleri, yalnızca makrolara uygulanabilir ve şablonlara uygulanamaz.
Şablonlar için dinamik veri alanları
Desteklenen alanların listesi:
| Dinamik veri alanı | Tanım |
|---|---|
{anchor.<attribute_name>} |
Dayanak sekmesinde yüklenen kaydın özniteliklerine erişmek için kullanılır. |
{customerName} |
Konuşmayı başlatan müşterinin adı. |
{caseId} |
Servis talebinin benzersiz tanımlayıcısı. Sistem, yalnızca servis talebi konuşmaya bağlıysa, servis talebi kimliğini görüntüler. |
{caseTitle} |
Servis talebinin başlığı. Sistem, yalnızca servis talebi konuşmaya bağlıysa, servis talebi başlığını görüntüler. |
{queueId} |
Kuyruğun benzersiz tanımlayıcısı. Bu alfasayısal dize, kuyruk sayfası URL'sinde görüntülenir. |
{visitorLanguage} |
Konuşmayı başlatan Müşterinin dili. |
{visitorDevice} |
Konuşmayı başlatan Müşterinin cihazı. |
{entityRoutingLogicalName} |
Bildirim bir varlık kaydı için olduğunda varlığın adı. |
{entityRoutingRecordId} |
Bildirim bir varlık kaydı için olduğunda varlığın kaydının benzersiz tanımlayıcısı. |
{customerRecordId} |
Müşterinin kimliği doğrulanmışsa, varlığın (ilgili kişi veya firma) benzersiz tanımlayıcısı. |
{<name of the pre-chat survey questions>} |
Bir iş akışı için yapılandırılan tüm sohbet öncesi anket soruları sorunun adı olarak bilgi adına sahip olacaktır. |
Şablonlar için dinamik veri alanı biçimi
Şablon bağlamını kanal sağlayıcısından, geçerli kullanıcı oturumundan veya Dataverse'tan alan {Slug} parametresi biçimi. Örneğin: {caseId}
OData sorguları
Kullanılabilir bağlamları Dataverse'tan almak için OData sorguları kullanabilirsiniz.
OData sorgu biçimi:
{$odata.<entityName>.<entityAttributeName>.<?options>}
Örnekler:
{$odata.account.name.?$filter=accountid eq '{customerRecordId}'}{$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}{$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}
Statik değerler
Bunlar, iş gereksinimlerinize bağlı olarak güncelleştirdiğiniz sabit kodlu değerlerdir. Seçtiğiniz her bir sabit kodlu öznitelik için, belirli bir özniteliğin biçim türünü izleyin.
Örnek (Makro):
Bir servis talebi başlığının her zaman Contoso - ile eklenmesini istiyorsunuz. Aşağıdaki alanları içeren Kayıt oluşturmak için yeni bir form aç eylemini kullanırsınız.
| Parametre | Değer |
|---|---|
| Varlık Mantıksal Adı | olay |
| Özellik Adı | Servis talebi başlığı |
| Öznitelik değeri | Contoso - {caseTitle} |
Burada Contoso - sabit kodlu statik değerdir.
Örnek (Şablonlar):
Gelen bir sohbet isteği için, statik başlığı oturuma ve aracıların çalışma zamanında gördükleri bir bildirim şablonuna sağlamak istiyorsunuz.
Bildirim başlığı = New chat request
Oturum başlığı = Chat conversation
Ayrıca bkz.
Oturum şablonlarını yönet
Uygulama Sekmesi Şablonlarını yönet
Bildirim Şablonlarını yönet
Şablonları iş akışlarıyla Ilişkilendirme