4.3.6. Web istemcisi


<< Prev   Next >>

4.3.6.1. Genel bilgiler

Web istemcisini çalıştırmak için tarayıcıyı başlatın ve bir Infobase URL'si yazın. Tarayıcının düzgün bir şekilde ayarlandığından emin olun. Bir Infobase'i aynı anda bir web tarayıcısının birkaç sekmesinde açabilirsiniz.

4.3.6.2. Dil ayarları ve bölgesel ayarlar

Web istemcisinin arayüz dilini aşağıdaki yöntemlerden birini kullanarak seçebilirsiniz (artan öncelik sırasıyla):

  • Web tarayıcınızın tercih edilen dil ayarları
  • Komut satırı parametresi L

Bir arayüz dili seçtiğinizde:

  • Infobase'e karşılık gelen bir kaynağa (örneğin, http://localhost/demo) sorgu işlenirken yerel dil seçilir:
    • URL L parametresini içeriyorsa bu parametrenin değeri okunur. Örneğin: Yerelleştirmek üzere İngilizceyi belirtmek için http://localhost/demo?l=en. Parametre okunduktan sonra dil seçilmemişse Accept-Language başlığı okunur.
    • URL'nin hiç parametresi yoksa tarayıcıda ayarlanmış tercih edilen diller hakkında bilgi içeren standart HTTP üst bilgisi Accept-Language okunur.
  • Dil, sunucuda bulunan yerel ayarlara göre seçilir:
    • Tam bir eşleşme bulunamazsa (örneğin, seçenek kullanılabilir olmayan en_US dilini belirtirse), dil adı kırpılır ve yeni bir arama gerçekleştirilir (en aranır).
  • Eşleşen dil bulunamazsa varsayılan İngilizce (en) kullanılır.
    • Seçilen dil ana uygulama URL'sine eklenir (örnekteki gibi sonuç http://localhost/demo/en olur) ve web tarayıcısı otomatik olarak bu yeni URL'ye yönlendirilir.

Bir web istemcisi oturumunun belirli değerlerin (örneğin, Day ve Date) nasıl görüntüleneceğini etkileyen bölgesel ayarları aşağıdaki yöntemler (artan öncelik sırasıyla) kullanılarak belirtilebilir:

  • Web tarayıcınızın tercih edilen dil ayarları
  • Komut satırı parametresi VL

Bir oturumun bölgesel ayarları aşağıdaki yöntemle yapılandırılır:

  • URL, VL parametresini içeriyorsa bu parametredeki yerel ayar koduyla eşleşen bölgesel ayarlar kullanılır. Örneğin: İngilizceye göre bölgesel oturum ayarlarını belirtmek için http://localhost/demo?vl=en. Parametre geçersiz bir yerel ayar kodu içeriyorsa web istemci kapanır ve bir hata mesajı görüntülenir.
  • URL'nin hiç parametresi yoksa tarayıcıda ayarlanmış tercih edilen diller hakkında bilgi içeren standart HTTP üst bilgisi Accept-Language okunur.

4.3.6.3. POST isteği ile kimlik doğrulama

Bazı durumlarda, 1C:Enterprise'ı standart kullanıcı kimlik doğrulama penceresi olmadan çalıştırmanız gerekebilir. Bu seçenek, 1C:Enterprise'da özel bir form kullanarak kimlik doğrulaması yapmanız gerekiyorsa (örneğin, bir web sitesine entegre edilmişse) veya Infobase kullanıcı kimlik bilgileri ayrı bir veritabanında saklanıyorsa gerekli olabilir.

Bu gereksinimleri karşılamak için, Infobase kaynağına POST isteği göndererek bir web istemci oturumunun kimliğini doğrulayabilirsiniz: e1cib/start. Bu durumda, başlatma işlemi aşağıdaki prosedürü uygular:

  1. İstemcinin kimliğini doğrulamak için POST isteği gönderilir.
  2. Kimlik doğrulaması başarılıysa oturum POST isteğinde belirtilen kullanıcı adına oluşturulur.
  3. Web istemcisi oluşturulur ve POST isteğindeki şu parametreler web istemcisi komut satırına iletilir: LowClientConnectionSpeed, LaunchParameter, LocaleCode ve Zone.
  4. Web istemcisi 2. adımda kimliği doğrulanan oturuma bağlanır.

İstek aşağıdaki parametreleri içerir:

Usr gerekli

Kullanıcı Adı.

Pwd isteğe bağlı

Kullanıcı parolası.

Varsayılan değer: Boş dize.

LowClientConnectionSpeed isteğe bağlı

Bağlantı hızı.

Değerler:

  • on. Düşük bağlantı hızı.
  • off. Normal bağlantı hızı (varsayılan).
LaunchParameter isteğe bağlı

Uygulamaya aktarılacak parametreler. Web istemci komut satırının C parametresine benzerdir.

Varsayılan değer: Boş dize.

SystemLanguage isteğe bağlı

Arayüz dili. Ayarlanmamışsa arayüz dilinin ve bölgesel ayarların yapılandırılmasıyla ilgili ayrıntılar için bkz. Dil ayarları ve bölgesel ayarlar.

LocaleCode isteğe bağlı

Arayüz dili. Ayarlanmamışsa arayüz dilinin ve bölgesel ayarların yapılandırılmasıyla ilgili ayrıntılar için bkz. Dil ayarları ve bölgesel ayarlar.

Zone isteğe bağlı

Ayırıcı değerler.

AuthFailHandling isteğe bağlı

Kimlik doğrulama hatası durumunda sistem davranışını belirler. Değerler:

  • error. Hata kodu 402 ve hata mesajı döndürür.
  • start. Web istemcisini 1C:Enterprise kimlik doğrulama isteği ile çalıştırır.
  • redirect. AuthFailRedirectURL parametresinde aktarılan URL'ye yönlendirir.

Varsayılan değer error'dur.

AuthFailRedirectURL isteğe bağlı

AuthFailHandling parametresi redirect olarak ayarlanmışsa kimlik doğrulama hatası durumunda izlenecek URL'yi içerir. Bu URL mutlak olmalıdır.

Örnek:

Bu HTML sayfası, http://localhost/demoapp adresinde bulunan bir Infobase'in yerel kimlik doğrulama formunu göstermektedir.

<HTML xmlns="http://www.w3.org/1999/xhtml"><HEAD>
<META http-equiv="Content-Type" content="text/html; charset=utf-8" />
<BODY>
<FORM action="http://localhost/demoapp/e1cib/start" method="post">
User: <INPUT id="usr" name="usr" /><BR />
Password: <INPUT id="pwd" type="password" value="" name="pwd" />
<BR />Low connection speed: <INPUT id="lowclientconnectionspeed" type="checkbox" name="lowclientconnectionspeed" /><BR />
Launch parameter: <INPUT id="launchparameter" name="launchparameter" /><BR />
System language: <SELECT id="systemlanguage" name="systemlanguage">
<OPTION value="ru" selected="">Russian</OPTION>
<OPTION value="en">English</OPTION>
</SELECT><BR />
Session locale code: <SELECT id="localecode" name="localecode">
<OPTION value="ru" selected="">Russian</OPTION>
<OPTION value="en">English</OPTION>
</SELECT><BR />
Data area: <INPUT id="zone" name="zone" />
<INPUT id="authfailhandling" type="hidden" value="error" name="authfailhandling" />
<P><INPUT type="submit" value="OK" /> </P>
</FORM>
</BODY>
</HTML>

Aşağıdaki kimlik doğrulama formu görüntülenir:

Şekil 17. POST istek formu

<< Prev   Next >>

Icon/Social/001 Icon/Social/006 Icon/Social/005 Icon/Social/004 Icon/Social/002