Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Why is a GEODI Workspace needed?

A project definition is necessary for Data Extraction / Query / Feed işlemleri için bir proje tanımı gerekmektedir. GEODI indexleri tamamen birbirinden soyutlamak için proje oluşturmayı destekler.

Kuruma özel terimler, taranacak kaynakların farklılığı gibi ihtiyaçlar nedeni ile yeni proje ekleme imkanı sunulmaktadır. 

Herhangi bir kurumda birden fazla GEODI projesi tanımlamak farklı kaynaklardaki içeriklere erişimi zorlaştırır. Tek bir proje hazırlamak etkin bir kullanım sağlar.  Bu yolla bir parselle ilgili uygulamanızda olmayan, projeye dahil edilmiş kaynaklara da yetkiniz ölçüsünde ulaşımınız mümkün olur. 

GEODI Workspace nasıl oluşturulur?

GEODI.exe ile açılan arayüzde sol menüde projeler ekranından yeni proje oluşturulabilir.

Enumerator/Connector nedir?

Proje hazırlama sırasında GEODI'nin tarayacağı kaynakları belirtmekte kullanılır.  Klasörler, Web Sayfası, E-Posta, Veritabanı, Dropbox gibi kaynak tipleri mevcuttur. Uygulamanızda hazırlayacağınız bir web servise erişim sağlayan İçerik Besleme Servisi kaynağını projeye ekleyerek GEODI'nin belirtilen aralıklarla uygulamanızdan güncellenen, değişen verileri istemesini sağlayabilir, içerik bazında yetkilendirmeyi yönetebilirsiniz. 

Recognizer/Tanıyıcı nedir?

Proje hazırlama sırasında tanımlanabilen içerik tanımayı sağlayan katmanlardır. Sözlükler, TCKimlik tanıyıcı, Ada/Parsel tanıyıcı, Kilometre tanıyıcı, kurallı ifade tanıyıcı gibi bir çok hazır tanıyıcı mevcuttur. Tanıyıcılar sayesinde GEODI bu verileri daha aranmadan gösterebilir. DataExtraction api  sadece projede tanımlı tanıyıcıların bulduğu içerikleri döner.

Neden Doküman yerine İçerik kelimesini tercih ediyorsunuz?

GEODI sadece dokümanlardan elde edilen metinleri değil enumaratorler tarafından sağlanan nesneleride tarama yeteneğine sahiptir. Ayrıca doküman kelimesi müşterilerimize bir twit, eposta'yı  ifade etmiyor.

GEODI aracılığı ile bir metin veya dosyadan bilgi çıkarmak istiyorum. Ne yapmalıyım?

Geodi Data Extraction API ( Formatter ) web servislerinden yararlanabilirsiniz.

GEODI indexinden nasıl sorgulama yapabilirim?

Geodi Query API ( Query ) web servislerinden yararlanabilirsiniz.

GEODI Veritabanı taraması kullanmak istiyorum. Veritabanındaki image/byte[] alanların doküman olarak indexlenmesini nasıl sağlayabilirim?

Proje hazırlamada Veritabanı enumarator ve taranacak tabloları seçtiğinizde GEODI bu içeriği bir excel tablosu gibi tarar. bilinen tip ve metinleri indexler. image/byte[] alanları taramak için dosya adı , görüntü adı ve güncellemeler için benzersiz id değerlerine ihtiyaç duyar.  Bu bilgileri sorgu sonuçlarında gösterilecek isimler için kullanır.  Bu bilgileri alacağı yeri belirtmek için GEODI uygulaması altındaki "Settings\Reader\DBMeta" klasörüne örnek yapıdaki gibi bir xml atılmalıdır.  GEODI herhangi bir veritabanı taramasında bu kalsördeki meta verileri dikkate alıroperations. GEODI supports creating projects to completely isolate the indexes.

It is possible to add new projects for needs like institution-specific terms and differences of resources that are going to be searched.

Defining multiple GEODI projects in an organization makes access to content from different sources difficult. Preparing only one project will be more effective to use. This way, it is possible to access resources that are not in your application but included in the project to the extent of your authorization.

How to create a GEODI Workspace?

A new project can be created from the projects screen in the left menu in the interface opened with GEODI.exe.

What is Enumerator/Connector?

It is used to specify the resources that GEODI will scan during project preparation. Resource types like Folders, Web Pages, E-mail, Database, Dropbox are available. By preparing and adding a Content Feed Service resource that provides access to a web service in your application, you can enable GEODI to request updated, changed data from your application at specified intervals and manage authorization based on content.

What is Recognizer?

Recognizers are layers that allow content recognition that can be defined during project preparation. There are many ready recognizers such as dictionaries, Turkish National ID identifier, Plot/Parcel of the land recognizer, Kilometer recognizer, canonical expression recognizer. Thanks to the recognizers, GEODI can display this data even before it is searched. The DataExtraction API returns only the contents found by the identifiers defined in the project.

Why do you prefer the word "Content" instead of "Document"?

GEODI is capable of scanning not only text from documents but also objects provided by enumarators. Moreover, we believe that in our customers’ views the word “document” is not enough to cover stuff like tweets and E-mails for our customers.

I want to extract information from a text or file with GEODI. What should I do?

You can make use of Geodi Data Extraction API ( Formatter ) web services.

How do I query from the GEODI index?

You can make use of Geodi Query API ( Query ) web services.

I want to use GEODI Database scan. How can I index image / byte [] fields in the database as documents?

When you select Database enumarator and the tables to be scanned in project preparation, GEODI scans this content like an excel table and indexes known types and texts. It requires filename, image name and a unique id for updates values to scan image / byte [] fields. Uses this information for names to be shown in query results. To specify where to get this information, an XML as in the example structure should be located in the "Settings \ Reader \ DBMeta" folder inside the GEODI application. In any database scan GEODI uses the metadata in this folder.
 

Expand
titleÖrnek XML Meta içeriğini görmek için tıklayınız Sample XML Click to see meta content


Code Block
languagexml
<Complex name="Root" type="Geodi.Database.Meta.DBMetaBaseCollection, Geodi.Database">
  <Properties>
    <Collection name="Defines">
      <Items>
        <Complex type="Geodi.Database.Meta.DBSubContent, Geodi.Database">
          <Properties>
			<!-- TableFilter: Ayar Hangi tablo için geçerli The table that will be affected by the setting -->
            <Simple name="TableFilter" value="BELGE.BELGETEST" />
			<!-- ColumnFilter:  TablodaWhich hangicolumns kolonlarwill varsabe buaffected ayarby geçerlithis olacaksetting -->
            <Simple name="ColumnFilter" value="BelgeAdi,BelgeIcerik,BelgeBelgeIcerikID" />
			<!-- DisplayNameColumnMacro: İçerikContent Görüntüdisplay adıname makrosumacro -->
			<!-- ÖrnekExample : [BELGEADIDOCUMENTNAME] DokümanıDocument  -->
			<!-- Boş bırakılırsa dosya adı kullanılır. If left blank file name will be used  -->
            <Simple name="DisplayNameColumnMacro" value="" />
			<!-- IDColumnMacro:İçeriğe aitColumn benzersizthat IDinclude değerininunique alınacağıID kolon/kolonlardırrelated to content-->
			<!-- ÖrnekExample : [BELGEBELGEICERIKIDDOCUMENTCONTENTID] DokümanıDocument  -->
            <Simple name="IDColumnMacro" value="[BELGEBELGEICERIKIDDOCUMENTCONTENTID]" />
			<!-- FileNameColumnMacro:DosyaFile adıname makrosumacro. DosyaShould uzantısıinclude bilgisinidefiletype içermelidir.too -->
			<!-- Örnek : [BELGEADIFILENAME]   -->
			<!-- Örnek : [BELGEADIFILENAME].pdf   -->
			<!-- Örnek : [BELGEADIFILENAME].[BELGEUZANTIFILETYPE]   -->
            <Simple name="FileNameColumnMacro" value="[BELGEADIFILENAME]" />


			<!-- FileMemoColumn : Dosya içeriğinin yazdığı byte[] kolon adıbyte[] column name that include file memo  -->
            <Simple name="FileMemoColumn" value="BelgeIcerik" />
			<!-- FileFullPathColumnMacro: Dosya disk üzerinde ise dosya yolu. FileMemoColumn boş bırakılmışsa kullanılabilir File path, if the file is on the disk.Can be usedFileMemoColumn is blank -->
            <Simple name="FileFullPathColumnMacro" value="" />



          </Properties>
        </Complex>
      </Items>
    </Collection>
  </Properties>
</Complex>

GEODI ye indexleyeceği içerikleri uygulamamdan nasıl sağlayabilirim?


How can I get content to be indexed to GEODI from my application?

You can make use of Geodi Feed Api (FeedHandler) web servislerinden yararlanabilirsinizservices.

Neden Token kullanıyorum, Token nasıl elde edilir?

Token GEODI üzerinde hangi servislere erişilebileceği, Hangi kullanıcı tarafından ne zaman verildiği, ne kadar süre geçerli olduğu, hangi istemcilere izin verildiği gibi bilgileri içerir. Servislerden alınan Token kullanıcı aktif olduğu sürece 10 yıl geçerlidir. Kullanıcı adı ve şifrenin dağıtılmasından daha güvenli olduğunu düşünüyoruz.

Elinizde yetkili kullanıcı adı ve şifre mevcut ise Geodi REST API sayfasında yönlendirilen arayüz ile  Token elde edebilirsiniz. Eğer kullanıcı adı ve şifreye sahip değilseniz sistem yöneticisinden GEODI üzerindne Token alıp size iletmesini veya uygulamanızdaki config dosyasına eklemesini veya size iletmesini istemelisiniz. Sistem yöneticisi yine Geodi REST API sayfasındaki yönlendirmelerden yararlanabilir.

Apileri kullanmak için uygulamamda hangi bilgilere sahip olmalıyım?

Uygulamanızda GEODI Url, WorkspacaName, Token bilgisini saklamanız genellikle yeterlidir. 

Besleme servisi ile ilettiğim içeriği veya yetkileri güncelleyebilmek için dikkat edilmesi gereken kurallar var mı? 

Servise gelen içeriğin benzersiz bir id'ye ihtiyacı var. Feed servisi içerik id olarak ContentObject.Content.ContentId değerini kullanır. Bu değer gerekiyorsa kendi uygulama adınızı da içeren benzersiz bir değer olmalıdır.

Eğer ContentId  verilmezse besleme sırasında verilen ContentURL id olarak kullanılır. ContentId  verilmemişse bir sonraki istekte ContentURL  aynı olmalıdır. aksi durumda GEODI yeni bir içerik geldiğini kabul edecektir.

Biliniyorsa içerik tarihi ( ContentObject.ContentDate ) ve/veya içerik hash bilgisi ( ContentObject.ForcedContentHash ) iletilmelidir. ContentDate  iletilen içeriğe bağlı bir tarih olmalıdır.  Aynı içerik her feed olduğunda değişmediği halde bu değerleri değiştirmek GEODI'nin içeriği yeniden taramasına neden olacak  her iki sistemede yük getirecektir. 

Besleme servisi ile İlettiğim içerik için belirlenen yetkiler değiştiğinde özel bir işlem yapmam gerekli mi?

Hayır. Aynı servis ve yeni yetkiler ile besleme yapılması yeterlidir.

Besleme servisi ile İlettiğim içerik için versiyonlamayı nasıl kapatabilirim ?

ContentObject.Mode değerini DisableVersions ( int 8) olarak ayarlamak yeterlidir. Eski versiyon silindi olarak işaretlenir.

Besleme servislerinde kullanılan ContentObject nesne yapısına nasıl ulaşabilirim?

...

Why do I use Tokens, how can I get one?

A Token contains information like which services can be accessed on GEODI, when it was given, by which user it was given, how long will it be valid, which clients are allowed. Token got from the services is valid as long as the user is active up to 10 years. We think that it is more secure than distributing username and password.

If you have an authorized user name and password, you can get a Token with the interface that can be reached from the link in the  Geodi REST API pageIf you do not have a user name and password, you should ask the system administrator to get a Token on GEODI and forward it to you or insert it to your config file in your application. The system administrator can also use the interface that can be reached from the link in the Geodi REST API page.

What information should I have in my application to use the APIs?

It is usually sufficient to store GEODI Url, WorkspacaName, Token information in your application.

Are there any rules that need to be considered to update the content or privileges I submit with the feed service?

A unique id is needed for the content sent to the service. The feed service uses ContentObject.Content.ContentId as the content id. If required, this value must be a unique value, including your own application name.


If ContentId is not given, the ContentURL id given during feed operation is used. If ContentId is not given, ContentURL must be the same in the next request, otherwise GEODI will accept as a new content.


If known, the content date (ContentObject.ContentDate) and / or content hash information (ContentObject.ForcedContentHash) must be passed. ContentDate must have a date linked to the transmitted content. Changing these values, even if the content does not change each time it feeds, will make GEODI rescan the content and will result in extra load on both systems.

Do I need to perform a special action when the privileges specified for the content I transmit with the feed service change?

No. Feeding with the same service and new authorizations is sufficient.

How do I turn off versioning for the content I've communicated with the feed service?

It is enough to set ContentObject.Mode to DisableVersions (int 8). The old version will be marked as deleted.

How do I access the ContentObject object structure used in feed services?

You can reach the up-to-date properties of objects over Geodi using http://127.0.0.1:3323/DeceSystemInfoWebHandler?op=ObjectInfo&Name=Geodi.Integration.ContentObject,Geodi.Integrationhttp://127.0.0.1:3323/DeceSystemInfoWebHandler?op=ObjectInfo&Name=Geodi.Integration.IntegrationObject,Geodi.Integration  adresleri kullanılarak Geodi üzerinden ulaşılabilir.  Nesne dokümantasyonuna   addresses.

You can reach object documentation from Geodi ContentObject - İçerik Tanım Nesnesi#İçerikTanımNesnesi-Çokluİçerik dokümanından ulaşılabilir

...

document.

I am developing my application with .net framework

...

.

...

Are there api classes available for use?

You can make use of the Geodi.Integration.dll RestApi sınıflarından yararlanabilirsinizclasses. Doküman sayfalarındaki .net örnekleri bu dlli kullanmaktadır. Güncel dll The .net examples in the document pages also use this language. The current dll is located next to Geodi.exe yanında bulunmaktadır. Servis detay sayfalarındaki örneklerin yanında da yer almaktadır.

GEODI.exe'yi uygulamayı kurduğum sunucuda çalıştırmam, ayakta tutmam mümkün değil. IIS veya başka bir web server kullanarak apilere erişebilir miyim?

GEODI IIS altında asp.net uygulaması gibi çalıştırılabilir. Bunun için aşağıdaki adımlar izlenmelidir.

...

. It is also located next to the examples on the service detail pages.

I cannot run GEODI.exe on the server on which I have installed the application. Can I access api using IIS or another web server?

GEODI can be run as an asp.net application under IIS. To do this, the following steps must be followed.

  • A virtual folder is created under IIS for GEODI.  
  • Asp.net 4.0 Tümleşik modda pool ayarlanıris set to pool in integrated mode.
    • Hazırlanan pool tarama işlemleri ve Prepared pool scanning operations and GEODI.exe ile aynı proje meta konumuna ulaşabilmesi için standart IIS uygulamalarından daha fazla yetkiye ihtiyaç duyabilir. 
    Geodi.exe ile aynı konuma bir .SystemSettings.json  dosyası oluşturulur. dosya içeriğinde json formatında AppDataFolder ayarı eklenir.. Bu konum GEODI'nin projeleri oluşturacağı, meta verileri saklayacağı path'dir. 
    • GEODI.exe ile uyumlu olması için Windows gezgini adres çubuğuna %appdata%  yazılarak gidilen klasör  adı alınıp kullanılmalıdır.
    • Yapılandırma ile ilgili daha fazla bilgi için Sistem Yapılandırma - Güvenlik Ayarları sayfasını inceleyebilirsinizmay require more privileges than standard IIS applications to achieve the same project meta location.
  • A .SystemSettings.json file is created in the same location as Geodi.exe. The AppDataFolder setting is inserted to file content in json format. This location is the path for GEODI to create projects and store metadata.
    • To be compatible with GEODI.exe, the folder name should be retrieved by typing% appdata% in the address bar of Windows Explorer.
    • For more information on configuration, see the System Configuration - Security Settings page.

      Code Block
      languagejs
      titleÖrnek Example SystemSettings.json ayar dosyasısetting file
      {
        "AppDataFolder":"C:\\GeodiMetaFolder"
      }


  • ardından httpThen the GEODI interfaces can be accessed from http: // [host] / [virtualfolder] /  veya  or http: // [host] / [virtualfolder] / gui   linkinden GEODI arayüzlerine ulaşılabilir. ( Mevcut sürümler IIS altında  http. (Available versions cannot open the interface correctly without the last "/" at http: // [host] / [virtualfolder] / adresindeki son "/" olmadan arayüzü doğru açamamaktadır under IIS)