It is an integration model based on receiving data by GEODI from the application. ECM, CMS, DMS applications and all applications that can provide content via web service or rest api can use this model. Different standards are supported for the service to be provided.
- GEODI Service model
Enterprise Content Managment (ECM)
Content Managment System (CMS)
- Document Content Managment (DMS)
- Sitemap xml, News Sitemap xml
If you have a web application and if your application is not standing all the time, you can use this method to trigger your application by GEODI.
GEODI Service Connection Standard
For feedback, the application must be able to return document information through a service that is authorized.
- Rest Api Service Path (URL)
- User Name, Password (LDAP or Kerberos User) for calling application services
- ( If the application supports openid standards, a valid token can be retrieved and used from the application for a long time. )
information will be recieved from the application and entered into GEODI interfaces, the system will make requests on the service from the application at specified times.
* If you have a question you can check the Frequently Asked Questions .
Expected Service Methods
| GetContents | |
|---|---|
| Definition | Uygulamadaki değişikleri takip etmek, içerikleri almak için kullanılan metoddur. Ayarlanan zamanlarda bu servis çağrılarak değişen, eklenen içerkiler ile ilgili bilgi alınır. Aynı parametreleri alan ve aynı nesneyi dönen bir .net soap api hazırlanmışsa metod üzerine |
| Reguest | [ServiceURL]?m=GetContents |
| HttpMethod | GET, POST |
| Expected Errors | 401 Unauthorized access / Access denied 403 Forbidden 511 Network Authentication Required |
| Ek Bilgiler | Api Credential (NTLM,Digest,Basic Authentication) : GEODI için ayarlanmış api kullanıcısı. Uygulama bu kullanıcını yetkisi dahilindeki tüm içerikleri dönmelidir. ChangeKey: İlk istekte tüm veriyi almak için iletilmez. İletilmesi halinde GEODI bu değerden sonra değişen içeriklerin dönmesini bekler. GEODI bu değeri son işlediği GetContents sonucundaki ChangeKey değerinden alır. Sonraki zamanlanmış taramada iletir. Uygulama geri döndüğünde değişimi takip için kullanabileceği herhangi bir değer gönderebilir. Page : GetContents servisinden bir PageCount dönmüşse şu an hangi sayfanın istendiğini gösterir. Bu parametre ile CurrentKey parametreside iletilir |
| Return Value | Çoklu ContentObject JSON dönülmesi beklenir. Geodi ContentObject - İçerik Tanım Nesnesi#İçerikTanımNesnesi-Çokluİçerik adresinden nesne detaylarına ulaşılabilir |
| Examples | //Request : [ServiceURL]?m=GetContents + Credential
{
ChangeKey:'2015-05-07 12:10:00',
PageCount:5,
Contents : [
{
ContentURL : '~/MyApplication/Content.php?id=1465',
DisplayName:'Kontrol Listesi Dokümanı',
ContentDate:'Mon, 04 May 2015 07:38:28 GMT',
ViewURL : '~/MyApplication/ContentView.php?id=1465',
Permission : { Permit : ['S-151...'] }
},
{
ContentURL : '~/MyApplication/Content.php?id=1496',
DisplayName:'Örnek Çalışmalar Notu',
Content: {
Extension:'.txt',
Content: 'Kızılay civarında yapılan çalışmalar eklenmemiş.'
}
Permission : { Permit : ['S-151...'] }
}
]
}
//Request : [ServiceURL]?m=GetContents + Credential&CurrentKey=2015-05-07 12:10:00&Page=1
{
ChangeKey:'2015-05-07 12:10:00',
PageCount:5,
Contents : [
{
ContentURL : '~/MyApplication/Content.php?id=1469',
DisplayName:'Kontrol Listesi Dokümanı',
ContentDate:'Mon, 04 May 2015 07:38:28 GMT',
ViewURL : '~/MyApplication/ContentView.php?id=1469',
Permission : { Permit : ['S-151...'] }
}
]
}
//Request : [ServiceURL]?m=GetContents&ChangeKey=2015-05-07%2012%3A10%3A00 + Credential
{
ChangeKey:'2015-05-08 12:10:00',
}
//Değişen yok
//Request : [ServiceURL]?m=GetContents&ChangeKey=2015-05-08%2012%3A10%3A00 + Credential
{
ChangeKey:'2015-05-09 12:10:00',
Contents : [
{
ContentURL : '~/MyApplication/Content.php?id=1811',
DisplayName:'Yeni Doküman',
ContentDate:'Mon, 06 May 2015 10:15:20 GMT',
ViewURL : '~/MyApplication/ContentView.php?id=1811',
Permission : { Permit : ['S-151...','Koordinator'] }
}
]
}
|
| Example applications | |
Enterprise Content Managment (ECM) , Content Managment System (CMS) , Document Content Managment (DMS) Entegresyonları
WebDAV desteği bulunmakla birlikte bu destek entegre olunacak uygulamanın yetkilerinin dikkate alınması için yeterli değildir. WebDAV standardı bir ECM için yeterli ön bilgiyi sunmaz.
Entegre olunan uygulamaya ait özel yetki olmaksızın verilerinin GEODI tarafından alınıp GEODI güvenlik politikası dahilinde yayınlanmasının yeterli olduğu durumlarda WebDAV, FTP, WebSite, Standart Sitemap xml kullanılabilir.
CMIS 1.1 ( Content Management Interoperability Services ) gerçekleyen sistemler servisleri varsayılanda pasif getirmekte, veya eklenti yükleme gerektirmekteler.( http://docs.oasis-open.org/cmis/CMIS/v1.1/errata01/os/CMIS-v1.1-errata01-os-complete.html#x1-5540003 ) Ayrıca bu yazılımlar kendi apileri ile daha yüksek performans ve daha fazla özellik sağlayabiliyorlar. CMIS entegrasyonu kısa vadeli hedeflerimiz arasında yer almamaktadır.
Sitemap xml, News Sitemap xml
Urlset içeriğinde url loc, lastmod değerleri bulunmalıdır. bu değerlere göre son değişim kontrol edilerek tarama yapılır. Gösterim ve tarama için loc üzerinde belirtilen yol kullanılır. Credential ile istek desteklenir.
Bu yöntemde loc ve lastmod yanında Sistem(LDAP,Kerberos) kullanıcı gurubu ve kullanıcı bilgileri verilebilir. Özel Rol tabanlı/detay yetkiler desteklenmektedir.
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> <url> <loc>http://mysite/mydoc?id=125</loc> <lastmod>2016-06-15T14:10:00Z</lastmod> <!--Opsiyonel--> <permission> <permit>S-1515...,</permit> <deny/> </permission> </url> </urlset>