Emakin Formlarını Yerleştirme¶

Yerleştirilmiş formlarla, Emakin formlarını bir HTML kullanarak diğer uygulamalara kolayca tümleştirebilirsiniz <iframe>. Emakin’in uyarlanabilir tasarımı, formun çerçeve boyutuna otomatik olarak uyum sağlamasını ve farklı cihaz ve 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 kullanabilir veya anonim erişime izin verebilirsiniz.

Anonim Erişim¶

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

Info

Anonim erişimin yalnızca "Etkin" durumundaki süreçlerde kullanılabildiğini unutmayın. Bir süreç "Test" modundayken anonim erişimi kullanmaya çalışırsanız Emakin işlemi sessizce yok sayar; böylece test süreçlerinin yanlışlıkla dışarıya açılması önlenir.

Anonim Olarak Yeni Süreç 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.

Başlatma için anonim erişimi etkinleştiren süreç ayarı.

API Anahtarı Oluşturun: "login" kapsamına ve gereken diğer kapsamlara sahip bir API anahtarı oluşturun. Anonim erişime izin vermek 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üncellenmiş URL, "apiKey" parametresi eklenmiş olarak aşağıdaki örneğe benzer görünmelidir:

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

Bir 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çmaları gerekmeden ekranı görüntülemesini sağlar.

Paylaşılan ekran bağlantıları için anonim erişimi etkinleştiren ekran ayarı.

API Anahtarı Oluşturun: "login" kapsamına ve gereken diğer kapsamlara sahip bir API anahtarı oluşturun. Anonim erişim vermek sistemin güvenlik açıkları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üncellenmiş URL, "apiKey" parametresi eklenmiş olarak aşağıdaki örneğe benzer görünmelidir:

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

Kimlik Doğrulamalı Erişim¶

Erişimi güvenli hale getirmek 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ıza sabit kodlamamak önemlidir.

"auth" parametresini içeren güncellenmiş URL, aşağıdaki örneğe benzer görünmelidir:

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

Form Yerleştirme¶

Aşağıdaki örnekte gösterildiği gibi, Emakin formlarını temel bir HTML <iframe> etiketi kullanarak kolayca yerleştirebilirsiniz:

Örnek:

<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 tamamladıktan sonra kullanıcıyı başka bir adrese yönlendirmek için sorgu dizesinde bir returnUrl parametresi belirtebilirsiniz.

Örnek:

<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.

<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>

Warning

Diğer örneklerden farklı olarak, boyutunu izlemek istediğiniz IFrame öğesine bir ID atadığınızdan emin olun. Bu, öğenin boyutunu izlemek ve dinamik olarak ayarlamak için gereklidir.

Parametre Gönderme¶

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

Parametre Gönderme Yöntemi¶

Bir parametre göndermek için URL’ye sorgu dizesi parametresi olarak ekleyin; örneğin: parameterName=value.

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

Son 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ümlemekullanabilirsiniz. Belirli bir hiyerarşi alanını hedeflemek için parametre adını nodeName/nestedNode/nestedNestedNode biçiminde düzenleyin.

Örnek¶

Bir CompanyId parametresini (GUID) ve Customer/Namegibi iç içe bir alanı göndermek istediğinizi varsayalım. Her iki parametreyi de URL’ye ekleyebilirsiniz:

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

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

Info

En iyi uygulama olarak, URL üzerinden gönderilen parametre sayısını en aza indirmenizi öneririz. Bunun yerine, tek bir tanımlayıcı (örneğin bir Id parametresi) göndermeyi ve ek verileri süreçteki ön işleme bölümündealmanızı değerlendirin. Örneğin yalnızca bir Idgöndererek gerekli ayrıntıları sorgulamak için bu tanımlayıcıyı ön işlemede kullanabilir, böylece sürecin verimli ve güvenli olmasını sağlayabilirsiniz.

Kültür Parametresi Gönderme¶

Formları yerleştirirken bazen dil, tarih biçimleri ve bölgeye özgü diğer ayarları belirleyen belirli bir kültür veya yerel ayarda görüntülenmeleri gerekebilir. Bu, özellikle küresel kitleye hizmet veren uygulamalarda veya kullanıcının kültürünün bilindiği ve sorunsuz bir deneyim sunmak istediğiniz durumlarda yararlı olabilir.

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

Formu yerleştirirken bir kültür belirtmek için yerleştirme URL’sine culture parametresini 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.

<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.