3.19.3. <ws>

3.19.3.1. Genel açıklama ve öğe öznitelikleri

Öğe, Web servisleri yayınlama ayarlarını içerir ve <point> öğesine bağlıdır. Birden fazla <ws> öğesine izin verilmez. Bu öğe, herhangi bir sayıda <point> öğesi içerebilir.

HTTP servisine erişmek için JWT kimlik doğrulamasını kullanmanız gerekiyorsa <ws> öğesine bağlı <accessTokenAuthentication> öğesini (daha fazla bilgi için bkz. sayfa 3.19.14. <accessTokenAuthentication>) oluşturun. <accessTokenAuthentication> öğesi, JWT kimlik doğrulamasına izin verir.

Öğe aşağıdaki öznitelikleri içerebilir.

enable

Infobase'de web servislerine izin verir veya yasaklar. Öznitelik true olarak ayarlanmışsa (veya öznitelik yoksa) web servislerine izin verilir. Aksi takdirde (özellik false olarak ayarlandıysa) web servislerine izin verilmez.

Varsayılan değer: true (web servisi çalıştırmaya izin verilir).

pointEnableCommon

Açık kullanım izni olmadan yayınlanan web servislerine izin verir veya yasaklar (point öğesinin enableözniteliği). Öznitelik true olarak ayarlanırsa point öğesinin enable özniteliğinin açıkça belirtilen değeri olmayan tüm web servislerine izin verilir. Aksi takdirde, bu tür web servisleri yasaktır.

Varsayılan değer: true (web servisi çalıştırmaya izin verilir).

publishExtensionsByDefault

Uzantılardan gelen web servislerine izin verir veya yasaklar.

Öznitelik true olarak ayarlanırsa ekli uzantılarda bulunan tüm web servislerine izin verilir. Öznitelik false olarak ayarlanırsa uzantılardaki web servislerine izin verilmez.

Varsayılan değer: false (web servisi uzantısı çalıştırma yasaktır).

3.19.3.2. <point>

Öğe, yayınlanan web servisinin bir açıklamasını içerir. Öğe, <ws> öğesine bağlıdır. Birden fazla <point> öğesi olabilir. Bu listede, uzantılardaki web servisleri için parametreleri manuel olarak da belirleyebilirsiniz.

Bir web servisi default.vrd dosyasında açıkça belirtilmemişse ve uygulama web servislerinin kullanımına izin veriliyorsa web servisine yalnızca adla (name web servisi özelliği) erişilebilir. Eş anlamlı sözcük (diğer ad) ile erişim, eş anlamlı sözcük Publication file name web servisi özelliğinde belirtilmiş olsa bile kullanılamaz. Web servisine hem ad hem de eş anlamlı sözcük (diğer ad) ile erişmek için default.vrd dosyasında (eş anlamlı sözcük dahil) gerekli web servislerini açıkça belirtin.

Öğe aşağıdaki öznitelikleri içerebilir.

name

Yayınlanan web servisinin adı. Servise hem web servisinin adını içeren bir bağlantıyla hem de web servisinin eş anlamlısını içeren bir bağlantıyla erişilebilir.

Dize tarafından açıklanan web servisi için:

…
base="/demo"
…
<point name="OperationalData" alias="OperData"/>

Aşağıdaki erişim yöntemleri kullanılabilir:

http://host/demo/ws/OperationalData
http://host/demo/ws/OperData

İPUCU. Web servisi adını yalnızca US ASCII karakterlerini kullanarak belirtmeniz önerilir.

alias

Yayınlanan web servisinin eş anlamlısıdır. Servise hem web servisinin adını içeren bir bağlantıyla hem de web servisinin eş anlamlısını içeren bir bağlantıyla (eş anlamlısı default.vrd dosyasında belirtilmişse) erişilebilir.

Aşağıdaki şekilde yayınlanan bir web servisi için:

…
base="/demo"
…
<point name="OperationalData" alias="OperData"/>

Aşağıdaki erişim yöntemleri kullanılabilir:

http://host/demo/ws/OperationalData
http://host/demo/ws/OperData

İPUCU. Web servisi eş anlamlısını yalnızca US ASCII karakterlerini kullanarak belirtmeniz önerilir.

enable

Bir web servisinin kullanımına izin verir veya bunu yasaklar.

Varsayılan değer: true (yayına izin verilir).

reuseSessions

Oturum yeniden kullanım modu:

dontuse. Oturumlar yeniden kullanılmaz.
use. Oturum yeniden kullanımı, istemci tarafından tanımlanır ve web servisine yönelik bir HTTP isteğinin parametrelerine bağlıdır.
autouse. Oturumlar otomatik olarak yeniden kullanılır.

Varsayılan değer: autouse.

sessionMaxAge

Oturumun bu sürenin sonunda sona ereceği oturum boşta kalma süresi (saniye).

Varsayılan değer: 20 (oturum ömrü 20 saniyedir).

NOT. reuseSessions ve sessionMaxAge özniteliklerinin değiştirilen değerleri yalnızca 1C:Enterprise sunucusu yeniden başlatıldığında geçerli olacaktır.

<< Prev Next >>