Genel Nesne¶
- Kaynak bağlantısı: https://github.com/pluginsGLPI/genericobject
- İndirin: https://github.com/pluginsGLPI/genericobject/releases
This user manual applies to version 2.14 of the GLPI Generic Object Plugin.
Gereksinimler¶
Lütfen uygulama eki sayfasına bakın <https://plugins.glpi-project.org/#/plugin/genericobject>.
Özellikler¶
Bu uygulama eki GLPI çatısına bütünleşik yeni stok ögeleri eklenebilmesini sağlar.
Şu GLPI özelliklerini destekler:
- varlık ve alt varlık yönetimi:
- arama;
- kalıplar;
- geçmiş;
- destek merkezi bütünleştirmesi:
- CSV dosya ekleme uygulama eki bütünleştirmesi:
- Öge kaldırma uygulama eki bütünleştirmesi:
- sipariş yönetimi uygulama eki bütünleştirmesi.
Kullanım örneği¶
Nesnel: Araç filonuzu BT varlıklarınız gibi yönetebilirsiniz.
- Yeni araçlar stok türünü ekleyin.
- Araçlar için kullanılacak alanları ekleyin: ad, seri numarası, stok kodu, tür, model, renk, durum, gibi.
- Bir aracın davranışını belirtin: Alt varlıkta görüntülensin, geçmişi kaydedilsin gibi.
- Araçlar üzerindeki izinleri ayarlayın.
- Araçlar nesnesini etkinleştirin.
- Araç filonuzu GLPI üzerinden yönetin.
Uygulama Ekini Kur¶
- Arşivi ayıkla.
genericobject
klasörünü<GLPI_ROOT>/plugins
klasörüne taşıyın- Yapılandırma > Uygulama Ekleri bölümüne gidin
- Uygulama ekini kurup etkinleştir
Kullanım¶
Yeni bir nesne türü ekleyin¶
Bu ilk adımdır.
- Uygulama eki yapılandırması formunda + düğmesine tıklayın.
- Yeni stok nesnesi türü oluşturun:
- ad: zorunludur, küçük harflerle ve yalnız şu karakterler kullanılarak yazılmalıdır:
- etiket: varsayılan olarak ad ile aynıdır.
- Doğrulayın.
- Kullanabilmek için yeni öge türünü etkinleştirin.
Örnek: Yeni araç stok nesnesini oluşturun.
Etiketleri düzenleyin¶
Her tür için <GLPI_ROOT>/files/_plugins/genericobject/locales/itemtype/
altında bir dil dosyası bulunur
Bu uygulama eki şunları oluşturur:
- geçerli dil için bir dil dosyası
- varsayılan GLPI dili için bir dil dosyası
Not
Geçerli ve varsayılan dil aynı ise yalnız bir dosya oluşturulur.
İngilizce dilinde öge türünün etiketini değiştirmek için şu dosyayı düzenleyin:
<?php
// <GLPI_ROOT>/files/_plugins/genericobject/locales/<itemtype>/<itemtype>.en_GB.php
$LANG['genericobject']['<itemtype>'][1] = "<type's label>";
You can also define labels globally in <GLPI_ROOT>/files/_plugins/genericobject/locales/fields.<lang>.php
files:
<?php
// <GLPI_ROOT>/files/_plugins/genericobject/locales/<itemtype>/<itemtype>.en_GB.php
$LANG['genericobject']['fields']['<itemtype>'] = "<type's label>";
Kurulum davranışı¶
Örnek: Bir aracın davranışını belirtin: Alt varlıkta görüntülensin, geçmişi kaydedilsin gibi.
Yeni tür normal GLPI türleri (bilgisayar, ekran, ağ aygıtı vb) ile aynı şekilde yönetilir
Not
Tüm nesneler için atanmış en az bir varlık olmalıdır
Davranış sekmesinde şunlar tanımlanabilir:
- alt kayıtlar: türün alta doğru genişletilmesini sağlar;
- Destek masası: Bir nesnenin bir çağrı kaydı ile ilişkilendirilmesini sağlar:
- Çöp: GLPI Çöp Kutusu özelliğini kullanır;
- Notlar: GLPI not özelliğini kullanır;
- Geçmiş: Bu türün geçmişini kaydeder;
- Kalıplar: Kalıpların yönetimini sağlar;
- Belgeler: Bu türdeki nesnelere belge eklenebilmesini sağlar;
- Ödünç Verme: Nesnelerin ödünç verilebilmesini sağlar;
- Sözleşmeler: Bir nesneyi bir ya da bir kaç kişi ile ilişkilendirir;
- Ağ Bağlantıları: Bu tür için yönetim ve kapı numaralarının kullanılabilmesini sağlar;
- CSV file injection uygulama eki: Bu türün şu uygulama ekiyle kullanılabilmesini sağlar;
- Item uninstallation uygulama eki: Bu türün kaldırılmasını sağlar;
- Order management uygulama eki: Bu türün bir sipariş ile ilişkilendirilmesini sağlar;
Alan Ekle¶
Örnek: Araçlar için kullanılacak alanları ekleyin: ad, seri numarası, stok kodu, tür, model, renk, durum, gibi.
Alanlar sekmesine gidin.
Bu uygulama eki ile kullanılmaya hazır bazı alanlar gelir:
- Ad
- Tür
- Model
- Seri Numarası
- Stok Numarası
- Ögenin Kullanıcısı
- Grup
- Durum
- Yorumlar
- Notlar
- Konum
- Diğer
- Üretici
- İnternet Adresi
- Eklenme Tarihi
- Son Kullanma Tarihi
- Kategori
- Destek Merkezinde Görüntülensin
- Donanımdan sorumlu kişi
- Etki Alanı
- İlgili
- İlgilinin telefonu
Not
Bazı davranışlar kullanıldığında nesneye bazı alanlar otomatik olarak eklenir:
- ağ bağlantısı => konum
- ödünç verme => konum
- destek merkezi => destek merkezinde görüntülensin
- notlar => notepad
Destek merkezi bütünleştirmesi¶
Bir nesneyi destek merkezinde kullanmak için şu ayarları kullanın:
- Davranış sekmesinde: destek merkezi kullanılsın seçeneği Evet olarak ayarlanmalıdır.
- Kullanıcı alanı belirtilmiş ise öge Ögelerim listesinde görüntülenir (ögenin sahibi bu kullanıcı olarak).
- Grup alanı belirtilmiş ise öge gene Ögelerim listesinde görüntülenir (öge kullanıcının bulunduğu gruba ait olduğundan).
- Destek Merkezinde Görüntülensin alanı ayarlanmış ve değeri Hayır ise nesne destek merkezinde görüntülenmez.
Yeni alanlar ekle¶
Not
Bu seçenek etkinleştirildiğinde, yeni alanlar tüm nesne türleri için kullanılabilir.
<GLPI_ROOT>/files/_plugins/genericobject/fields/<type>.constant.php
adında yeni bir dosya oluşturun
Örneğin arac türü için sabit dosyası <GLPI_ROOT>/files/_plugins/genericobject/fields/arac.constant.php
şeklinde olur.
Lütfen dosyanın ilk satırının şu şekilde olduğundan emin olun. Yoksa yeni alanlar listede görüntülenmez:
<?php
global $GO_FIELDS, $LANG;
- Yeni alan tanımlarını ekle.
Basit bir açılan kutu alanı ekle¶
<?php
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['name'] = $LANG['genericobject']["<type's name>"][2];
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['field'] = 'color';
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['input_type'] = 'dropdown';
Not
Dil dosyasında dil değişkeni tanımlanmalıdır (yukarıdaki açıklamaya bakın).
- Bir varlığa atanmış bir açılan kutu alanı ekle:
<?php
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['name'] = $LANG['genericobject']["<type's name>"][2];
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['field'] = 'color';
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['input_type'] = 'dropdown';
//Does the dropdown take care of entities ? (true/false)
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['entities_id'] = true;
//Can values be recursive ? (true/false, only taking in account if entities_id is set to true)
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['is_recursive'] = true;
Bir açılan ağaç alanı ekle¶
<?php
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['name'] = $LANG['genericobject']["<type's name>"][2];
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['field'] = 'color';
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['input_type'] = 'dropdown';
//Is it a tree-dropdown, or a simple one ? (true/false)
$GO_FIELDS['plugin_genericobject_mytypecolors_id']['is_tree'] = true;
Not
Aynı zamanda şu parametreleri de kullanabilirsiniz: entities_id, is_recursive, is_tree.
GLPI çekirdek nesnesi temelli bir açılan kutu alanı ekle (kullanıcı, konum…):¶
<?php
$GO_FIELDS['users_id_passengers_id']['name'] = 'Passenger';
$GO_FIELDS['users_id_passengers_id']['input_type'] = 'dropdown';
Not
Köşeli parantez içindeki adlar ([]
) GLPI kullanıcı listesinde bir alan olarak değerlendirilmesi için users_id
ile BAŞLAMALIDIR.
Kullanılabilecek alanların tam listesini <GLPI_ROOT>/files/_plugins/genericobject/fields/field.constant.php
dosyasından görebilirsiniz.
Genel açılan kutu ekle¶
Tüm öge türleri için genel bir açılan kutu kullanılabilir. İyi bir örnek şöyle olabilir:
<?php
$GO_FIELDS['categories_id']['name'] = $LANG['common'][36];
$GO_FIELDS['categories_id']['input_type'] = 'dropdown';
$GO_FIELDS['categories_id']['dropdown_type'] = 'global';
Her öge türü için özel bir kategori tablosu oluşturulur. Tablo adı ve alan adı şu şekilde belirlenir:
- tablo :
glpi_plugin_genericobject_<itemtypename>_category
- alan adı :
plugin_genericobject_<itemtype>categories_id
Bir tamsayı alanı ekle¶
<?php
$GO_FIELDS['testinteger']['name'] = 'testinteger';
$GO_FIELDS['testinteger']['input_type'] = 'integer';
$GO_FIELDS['testinteger']['min'] = 10; //not mandatory, by default 0
$GO_FIELDS['testinteger']['max'] = 40; //not mandatory, by default 100
$GO_FIELDS['testinteger']['step'] = 3; //not mandatory, by default 1
Bir metin alanı ekle¶
<?php
$GO_FIELDS['mytextfield']['name'] = 'My text field';
$GO_FIELDS['mytextfield']['input_type'] = 'text';
2.1.2 sürümünde değişti: Şu argümanı ekleyerek, uygulama ekine bir kalıpta kullanıldığında bu alanın otomatik olarak üretileceğini söylemiş olursunuz:
<?php
$GO_FIELDS['mytextfield']['autoname'] = true;
Bir Evet/Hayır alanı ekle¶
<?php
$GO_FIELDS['mybooleanfield']['name'] = 'My boolean field';
$GO_FIELDS['mybooleanfield']['input_type'] = 'bool';
Bir tarih alanı ekle¶
<?php
$GO_FIELDS['creationdate']['name'] = $LANG['genericobject']['fields'][30];
$GO_FIELDS['creationdate']['input_type'] = 'date';
Bir tarih ve saat alanı ekle¶
<?php
$GO_FIELDS['creationdate']['name'] = $LANG['genericobject']['fields'][30];
$GO_FIELDS['creationdate']['input_type'] = 'datetime';
Not
Bir alanın toplu işlemlerden etkilenmesini istemiyorsanız tanımına şu satırı ekleyin:
<?php
$GO_FIELDS['myfield']['massiveaction'] = false;
Genel alanlar ekle¶
Alanlarınızın tüm öge türleri tarafından kullanılabilmesi için:
<GLPI_ROOT>/files/_plugins/genericobject/fields/field.constant.php
adında bir dosya oluşturun- Tanımlarınızı bu dosya içine ekleyin.
Kurulum İzinleri¶
Her profil için her bir nesne türüne göre erişim izinleri tanımlanabilir. Şu seçenekler kullanılabilir:
- tür izni: erişilemez, okuma, yazma.
- bu nesne türünü destek kayıtları ile ilişkilendirme izni: evet, hayır
İzinleri atamak için şunları yapabilirsiniz:
- Öge türü formundaki İzinler sekmesini kullanın.
- Yönetim > Profiller bölümüne gidin ve her bir profil için izinleri ayarlayın.
Yeni alanı kullanın¶
Yeni türü etkinleştirin ve kullanmaya başlayın.
Kullanıcılar yeni türü Uygulama Ekleri > Nesne Yönetimi menüsünden kullanabilir.
Generic Object ile BDBYS Kullanım Örneği¶
Bu belgenin amacı¶
Biyotıp alanında Generic Object ile BDBYS (Bilgisayar Destekli Bakım Yönetimi Sistemi) kullanımını açıklar.
Bu kullanım örneğinin sonunda şunları yapmış olacaksınız :
- adanmış bir Biyotıp varlığı (“Kök varlık” altında)
- Biyotıp nesneleri (Varlıklar menüsü altında)
- iç ve kullanıcı tanımlı alanlar ile
- Biyotıp_Yönetici profilindeki yönetici kullanıcıları
Adımlar¶
Bundan sonraki adımları yapabilmek için Süper Yönetici yetkileriniz olmalıdır :
- GLPI üzerine Generic Object uygulama ekini yükleyin (Generic Object 0.85 ile 1.0 arasındaki sürümler ve GLPI 0.90 ve üzerindeki sürümler gereklidir)
- Generic Object Yapılandırması
- GLPI yapılandırması
- Generic Object ve GLPI Kullanmaya Başlayın
GLPI üzerine Generic Obeject Kurun¶
ref:install_plugin bölümüne bakın.
Generic Object Yapılandırması¶
Nesne türünüzü ekleyin¶
Yeni bir nesne türü ekleyin bölümüne bakın ve iç belirteç olarak biyotıp yazın. Etiket otomatik olarak Biyotıp (Büyük B ile) olarak ayarlanır.
Oturumu kapatıp yeniden açtıktan sonra Varlıklar menüsünde Biyotıp görüntülenir.
Biyotıp için yeni alanları tanımlayın¶
Bu alanlar yalnız Biyotıp nesneleri için kullanılabilir :
- Şu adla yeni bir dosya oluşturun :
<GLPI_ROOT>/files/_plugins/genericobject/fields/biomedical.constant.php
- Şu içeriği ekleyin :
<?php
global $GO_FIELDS, $LANG;
// CODE CNEH
$GO_FIELDS['plugin_genericobject_cnehcodes_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][1];
$GO_FIELDS['plugin_genericobject_cnehcodes_id']['field'] = 'cnehcode';
$GO_FIELDS['plugin_genericobject_cnehcodes_id']['input_type'] = 'dropdown';
// REFORME (yes or no)
$GO_FIELDS['reformed']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][2];
$GO_FIELDS['reformed']['input_type'] = 'bool';
// CLASSE CE (3 choix possibles 1,2a ou 2b)
$GO_FIELDS['plugin_genericobject_classeces_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][3];
$GO_FIELDS['plugin_genericobject_classeces_id']['field'] = 'classce';
$GO_FIELDS['plugin_genericobject_classeces_id']['input_type'] = 'dropdown';
// UF (Unité Fonctionnelle)
$GO_FIELDS['plugin_genericobject_ufs_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][4];
$GO_FIELDS['plugin_genericobject_ufs_id']['field'] = 'uf';
$GO_FIELDS['plugin_genericobject_ufs_id']['input_type'] = 'dropdown';
// PRESTATAIRE BIOMED
$GO_FIELDS['plugin_genericobject_prestataires_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][5];
$GO_FIELDS['plugin_genericobject_prestataires_id']['field'] = 'prestataire biomed';
$GO_FIELDS['plugin_genericobject_prestataires_id']['input_type'] = 'dropdown';
// TYPE D'EQUIPEMENT BIOMED
$GO_FIELDS['plugin_genericobject_typedequipementbiomeds_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][6];
$GO_FIELDS['plugin_genericobject_typedequipementbiomeds_id']['field'] = "type d 'equipement biomed";
$GO_FIELDS['plugin_genericobject_typedequipementbiomeds_id']['input_type'] = 'dropdown';
// Criticite
$GO_FIELDS['plugin_genericobject_criticites_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][7];
$GO_FIELDS['plugin_genericobject_criticites_id']['field'] = 'criticite';
$GO_FIELDS['plugin_genericobject_criticites_id']['input_type'] = 'dropdown';
// Numéro marquage CE
$GO_FIELDS['plugin_genericobject_marquageces_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][8];
$GO_FIELDS['plugin_genericobject_marquageces_id']['field'] = 'marquagece';
$GO_FIELDS['plugin_genericobject_marquageces_id']['input_type'] = 'dropdown';
// Classe électrique
$GO_FIELDS['plugin_genericobject_classeelecs_id']['name'] = $LANG['genericobject']['PluginGenericobjectBiomedical'][9];
$GO_FIELDS['plugin_genericobject_classeelecs_id']['field'] = 'classeelec';
$GO_FIELDS['plugin_genericobject_classeelecs_id']['input_type'] = 'dropdown';
?>
Uyarı
Başlangıçtaki s_id
zorunludur [plugin_genericobject_field*s_id*]
çünkü GLPI çatısı için dış anahtar alanlarının s_id
ile bitmesi gereklidir. Veritabanında, glpi_plugin_genericobject_fields
tablo adıdır ve id
, dış anahtardır. Ayrıntılı bilgi almak için GLPI geliştirici belgeleri bölümüne bakın.
Alan etiketlerini yazın¶
ref:edit_labels bölümüne bakın.
- Dil dosyalarınızı düzenleyin, örnek :
<GLPI_ROOT>/files/_plugins/genericobject/locales/biyotip/biyotip.tr_TR.php
- Dosyanın sonuna şu içeriği ekleyin :
<?php
// Fields
$LANG['genericobject']['PluginGenericobjectBiomedical'][1]="Code CNEH";
$LANG['genericobject']['PluginGenericobjectBiomedical'][2]="Réformé";
$LANG['genericobject']['PluginGenericobjectBiomedical'][3]="Classe CE";
$LANG['genericobject']['PluginGenericobjectBiomedical'][4]="UF";
$LANG['genericobject']['PluginGenericobjectBiomedical'][5]="Prestataire Biomed";
$LANG['genericobject']['PluginGenericobjectBiomedical'][6]="Type d'équipement biomed";
$LANG['genericobject']['PluginGenericobjectBiomedical'][7]="Criticité";
$LANG['genericobject']['PluginGenericobjectBiomedical'][8]="Marquage CE";
$LANG['genericobject']['PluginGenericobjectBiomedical'][9]="Classe électrique";
Davranışları tanımlayın¶
Uygulama Ekleri > Nesne Yönetimi menüsündeki Temel sekmesinden şunu seçin :
- Öge Çöp Kutusunda
- Geçmiş
- Mali ve İdari Bilgiler
- Belgeler
- Genel Arama
- Destek
- Kalıplar
- Sözleşmeler
- Genel Arama
Bu işlem nesne türünüze kullanmaya hazır alanlar ekler.
Nesne türünüze alanlar ekleyin¶
Uygulama Ekleri > Nesne Yönetimi menüsündeki Alanlar sekmesinden Biyotıp türündeki nesneye alanlar ekleyebilirsiniz :
- kullanıma hazır alanlar (GLPI iç alanları)
- yeni alanlar (Biyotıp için yeni alanları tanımlayın bölümünde)
GLPI yapılandırması¶
Biyotıp_Yönetim profilini tanımlayın¶
- Yönetim profilini kopyalayın
- Biyotıp-Yönetim profili için şu izinleri ayarlayın :
- Yönetim > Profiller > Yönetim_Biyotıp > Varlıklar sekmesi > Tümünü Bırak
- Yönetim > Profiller > Yönetim_Biyotıp > Varlıklar sekmesi > Atama > Destek kaydına atanabilecek ögeler > Biyotıp
- Yönetim > Profiller > Yönetim_Biyotıp > Yönetim sekmesi > Tümünü Seç
- Yönetim > Profiller > Yönetim_Biyotıp > Nesne Yönetimi sekmesi > Biyotıp > Tümünü Seç
Not
Bu ayarlar ile Yönetim_Biyotıp kullanıcıları Varlık menüsünde yalnız Biyotıp seçeneğini görebilir.
Biyotıp varlığını ve izinlerini tanımlayın¶
- “Yönetim > Valıklar* bölümünden Kök Varlık altına Biyotıp varlığını ekleyin
- Biyotıp varlığı kullanıcıları için Biyotıp_Yönetim profili izin kurallarını yapılandırın.
Generic Object ve GLPI Kullanmaya Başlayın¶
Yönetim_Biyotıp kullanıcısı olarak Varlıklar > Biyotıp içine ilk nesnenizi ekleyin.
Zaman kazanmak için Kurulum > Açılan kutular > Nesne Yönetimi bölümünden yeni alan değerlerini tanımlayın.