Emakin Formlarını Yerleştirme¶

Yerleştirilmiş formlarla Emakin formlarını HTML kullanarak diğer uygulamalara kolayca entegre edebilirsiniz <iframe>. Emakin'in duyarlı tasarımı, formun çerçeve boyutuna otomatik olarak uyum sağlamasını ve farklı cihazlar ile ekran boyutlarında sorunsuz, tutarlı bir kullanıcı deneyimi sunmasını sağlar.

Yerleştirilmiş formlara erişmek için güvenlik gereksinimlerinize bağlı olarak geçerli bir kimlik doğrulama yöntemi seçebilir veya anonim erişime izin verebilirsiniz.

Anonim Erişim¶

Anonim erişim, kullanıcıların Emakin'de oturum açmadan diğer uygulamalardaki formlarla etkileşim kurmasına veya rapor oluşturmasına olanak tanır. Bu, API anahtarları kullanılarak sağlanabilir ve kimlik doğrulaması gerektirmeyen kullanıcılara sorunsuz, engelsiz bir deneyim sunar.

Yeni Bir Süreci Anonim Olarak Başlatma¶

Yeni bir süreci başlatmak için anonim erişimi etkinleştirmek üzere şu adımları izleyin:

• Anonim Erişimi Etkinleştirin: Başlatmak veya paylaşmak istediğiniz süreç için anonim erişimin etkin olduğundan emin olun. Bu ayar, sürece kullanıcı kimlik doğrulaması gerektirmeden erişilmesini sağlar.

• API Anahtarı Oluşturun: "login" kapsamına ve gereken diğer kapsamlara sahip bir API anahtarı oluşturun. Anonim erişim sisteminiz için riski artırabileceğinden dikkatli olun ve yalnızca zorunlu kapsamları seçin.

• Süreç Bağlantısını Güncelleyin: Sürecin başlatma bağlantısını kopyalayın. URL'deki # karakterini ?ile değiştirin, ardından oluşturulan API anahtarını adresin sonuna parametre olarak ekleyin.

Güncellenen URL, "apiKey" parametresi eklenmiş olarak aşağıdaki örneğe benzemelidir:

1

https://mydomain.emakin.com/app/?/initiate/55....6b/c2...18/08...c8&apiKey=58ea0f3d.....90b984be905a 

Ekranı Anonim Erişimle Paylaşma¶

Ekran görünümünü anonim olarak paylaşmak için şu adımları izleyin:

• Anonim Erişimi Etkinleştirin: Öncelikle paylaşmak istediğiniz ekran için anonim erişimin etkin olduğundan emin olun. Bu ayar, kullanıcıların oturum açmadan ekranı görüntülemesini sağlar.

• API Anahtarı Oluşturun: "login" kapsamına ve gerekli diğer kapsamlara sahip bir API anahtarı oluşturun. Anonim erişim sağlamak sistemin güvenlik açığını artırabileceğinden yalnızca gerekli kapsamları seçmeniz önemlidir.

• Ekran Bağlantısını Güncelleyin: Ekranın URL'sini kopyalayın. Adresteki # karakterini ?ile değiştirin, ardından oluşturulan API anahtarını URL'nin sonuna parametre olarak ekleyin.

Güncellenen URL, "apiKey" parametresi eklenmiş olarak aşağıdaki örneğe benzemelidir:

1

https://mydomain.emakin.com/app/?/report/55....c8&apiKey=58ea0f3d.....90b984be905a

Kimliği Doğrulanmış Erişim¶

Erişimi güvenceye almak için belirli bir kullanıcı kimliği adına REST API hizmetindeki GetToken yöntemini kullanarak kimlik doğrulama belirteçleri oluşturabilirsiniz. Belirteç oluşturulduktan sonra URL'ye "auth" parametresi olarak ekleyin.

Bu kimlik doğrulama belirteçlerinin yalnızca yapılandırılmış bir süre boyunca geçerli olduğunu ve bu sürenin sonunda sona ereceğini unutmayın. Gerektiğinde yeni belirteçler oluşturmak ve bunları diskte saklamamak ya da uygulamanızda sabit kodlamamak önemlidir.

"auth" parametresi eklenmiş güncellenen URL aşağıdaki örneğe benzemelidir:

1

https://mydomain.emakin.com/app/?/report/55....c8&auth=41A....114

Form Yerleştirme¶

Emakin formlarını basit bir HTML <iframe> etiketiyle kolayca gömebilirsiniz; aşağıdaki örneğe bakın:

Örnek:

1
2
3
4
5
6

<html>
<body>
Hello!
<iframe src="https://mydomain.emakin.com/app/?/initiate/55..c8&apiKey=58ea0f3d.....90b984be905a" width="100%" height="300" frameborder="0"></iframe>
</body>
</html>

Dönüş Adresi¶

Formu returnUrl tamamladıktan sonra kullanıcıyı başka bir adrese yönlendirmek için sorgu dizgesinde bir parametre belirtebilirsiniz.

Örnek:

1
2
3
4
5
6

<html>
<body>
Hello!
<iframe src="https://mydomain.emakin.com/app/?/initiate/55..c8&apiKey=58ea0f3d.....90b984be905a&returnUrl=http://localhost" width="100%" height="300" frameborder="0"></iframe>
</body>
</html>

IFrame Boyutu¶

Bazı formlarda arayüzün yüksekliği dinamik olarak değişebilir. IFrame boyutunun form içeriğine göre otomatik ayarlanmasını istiyorsanız bu boyut değişikliklerini dinamik olarak uygulamak için ek bir JavaScript kitaplığı kullanabilirsiniz.

1
2
3
4
5
6

<html>
<body>
<iframe id="frame" src="https://mydomain.emakin.com/app/?/initiate/55..c8&apiKey=58ea0f3d.....90b984be905a&returnUrl=http://localhost" width="100%" height="300" frameborder="0"></iframe>
<script src="https://static.emakin.com/r/IFrameResizer/JS?c=en-US"></script>
<script>iFrameResize({ minHeight:300 }, '#frame')</script>
</body>

Parametre Gönderme¶

Emakin formlarını yerleştirirken Emakin form verilerine ek değerler göndermeniz gerekebilir. Emakin, sorgu dizgeleri aracılığıyla parametre alınmasını destekler ve böylece değerleri doğrudan süreç iş akışı örneğinde ayarlamanıza olanak tanır.

Parametreler Nasıl Gönderilir¶

Bir parametre göndermek için bunu örneğin URL'ye sorgu dizgesi parametresi olarak ekleyin: parameterName=value.

Birden fazla parametre göndermeniz gerekiyorsa bunları ve işaretiyle (&).

Nihai URL şu biçimde olmalıdır:

http://mydomain.emakin.com/app/?/initiate/55..c&parameterName=value&parameterName2=value2

Not: İç içe düğümlerde tam yolu belirtmek için yol bölümlendirmesinikullanabilirsiniz. Parametre adını şu şekilde yapılandırın: nodeName/nestedNode/nestedNestedNode böylece hiyerarşi içindeki belirli bir alan hedeflenir.

Örnek¶

Bir CompanyId parametresini (GUID) ve şu türde iç içe bir alanı göndermek istediğinizi varsayalım: Customer/Name. Her iki parametreyi de URL'ye ekleyebilirsiniz:

1

https://mydomain.emakin.com/app/?/initiate/55..c8CompanyId=123e4567-e89b-12d3-a456-426614174000&Customer/Name=Acme%20Inc

Bu örnekte CompanyId bir GUID değeri olarak ayarlanır ve Customer/Name iç içe bir alanı hedefler. Acme%20Inc URL kodlamalıdır ve form yüklendiğinde Acme Inc olarak yorumlanır.

Kültür Parametresini Gönderme¶

Formları yerleştirirken bazen belirli bir kültür veya yerel ayarda görüntülenmelerini isteyebilirsiniz; bu ayar dili, tarih biçimlerini ve bölgeye özgü diğer tercihleri belirler. Bu, özellikle küresel kitleye hizmet veren uygulamalarda veya kullanıcının kültürünün bilindiği ve sorunsuz bir deneyim sunulmasının istendiği durumlarda yararlı olabilir.

Kültür Parametresi Nasıl Gönderilir¶

Form yerleştirirken kültür belirtmek için culture parametresini yerleştirme URL'sine ekleyebilirsiniz. Kültür parametresi geçerli bir IETF dil etiketiolmalıdır; örneğin en-US İngilizce (Amerika Birleşik Devletleri) için veya fr-FR Fransızca (Fransa) için.

1

<iframe src="https://mydomain.emakin.com/app/?/initiate/55..c8&apiKey=58ea0f3d.....90b984be905a&culture=en-US" width="100%" height="600px"></iframe>

Bu örnekte form, İngilizce (Amerika Birleşik Devletleri) kültüründe görüntülenir.

İlgili Sayfalar¶

• Entegrasyon Hizmetleri
• REST Hizmetleri
• Erişim Kapsamları