Genel nesne

İndir

Kaynaklar

https://github.com/pluginsGLPI/genericobject/releases

https://github.com/pluginsGLPI/genericobject

Gereksinimler (özel kurulum)

GLPI sürümü

En düşük PHP sürümü

Önerilen

10.0.x

8.1

8.2

Not

This plugin is available without a GLPI Network subscription. It is also available on GLPI Cloud.

Özellikler

Bu eklenti GLPI yapısına bütünleşik yeni envanter nesneleri 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 eklentisi bütünleştirmesi,

  • Öge kaldırma eklentisi bütünleştirmesi,

  • Sipariş yönetimi eklentisi bütünleştirmesi.

Kullanım örneği

Amaç: Araç filonuzu BT varlıklarınız gibi yönetmek.

  • Araçlar adında yeni bir envanter nesnesi 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 birimde 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.

Eklentiyi kurmak

  • Arşivi ayıklayın.

  • genericobject klasörünü <GLPI_ROOT>/plugins klasörüne taşıyın

  • Yapılandırma > Eklentiler bölümüne gidin

  • Eklentiyi kurup etkinleştirin.

Kullanım

Yeni bir nesne türü ekleyin

Bu ilk adımdır.

  • Eklenti yapılandırması formunda + düğmesine tıklayın.

  • Yeni envanter nesnesi türü oluşturun:

    • Ad: Zorunludur, küçük harflerle ve yalnızca ş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ç envanter 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 eklenti ş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ızca 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>";

Etiketleri ayrıca <GLPI_ROOT>/files/_plugins/genericobject/locales/fields.<lang>.php dosyalarında genel olarak da tanımlayabilirsiniz:

<?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 birim 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 bağlantı noktalarının kullanılabilmesini sağlar;

  • CSV file injection eklentisi: Bu türün şu eklentiyle kullanılabilmesini sağlar;

  • Item uninstallation eklentisi: Bu türün kaldırılmasını sağlar;

  • Sipariş yönetimi eklentisi: Bu türün bir sipariş ile ilişkilendirilmesini sağlar;

Alanlar ekleyin

Örnek: Araçlar için kullanılacak alanları ekleyin: ad, seri numarası, stok kodu, tür, model, renk, durum, gibi.

Alanlar sekmesine gidin.

Bu eklentisi 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 eklemek

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ı ekleyin.

Basit açılan kutu alanı eklemek

<?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ı eklemek:

<?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ı eklemek

<?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ı eklemek (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.

Bir genel açılan kutu eklemek

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ı eklemek

<?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ı eklemek

<?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, eklentiye 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ı eklemek

<?php
$GO_FIELDS['mybooleanfield']['name']       = 'My boolean field';
$GO_FIELDS['mybooleanfield']['input_type'] = 'bool';

Bir tarih alanı eklemek

<?php
$GO_FIELDS['creationdate']['name']       = $LANG['genericobject']['fields'][30];
$GO_FIELDS['creationdate']['input_type'] = 'date';

Bir tarih ve saat alanı eklemek

<?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 eklemek

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 izinleri

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ı kullanmak

Yeni türü etkinleştirin ve kullanmaya başlayın.

Kullanıcılar yeni türü Eklentiler > Nesne yönetimi menüsünden kullanabilir.

Genel nesle ile BDBYS kullanım örneği

Bu belgenin amacı

Biyotıp alanında Genel nesne 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)

  • İç 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 Genel nesne eklentisini kurun (Generic Object 0.85 ile 1.0 arasındaki sürümler ve GLPI 0.90 ve üzerindeki sürümler gereklidir)

  • Genel nesne yapılandırması

  • GLPI yapılandırması

  • Genel nesne ve GLPI kullanmaya başlayın

GLPI üzerine Genel nesne eklentisini kurmak

ref:install_plugin bölümüne bakın.

Genel nesne 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ızca 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. Veri tabanı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

Eklentiler > Nesne yönetimi menüsündeki Temel sekmesinden şunu seçin :

  • Öge çöp kutusunda

  • Geçmiş

  • Mali ve idari 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

Eklentiler > Nesne yönetimi menüsündeki Alanlar sekmesinden Biyotıp türündeki nesneye alanlar ekleyebilirsiniz :

GLPI yapılandırması

Biyotıp_Yönetim profilini tanımlayın

  1. Yönetim profilini kopyalayın

  2. 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ızca Biyotıp seçeneğini görebilir.

Biyotıp varlığını ve izinlerini tanımlayın

  1. “Yönetim > Valıklar* bölümünden Kök varlık altına Biyotıp varlığını ekleyin

  2. Biyotıp varlığı kullanıcıları için Biyotıp_Yönetim profili izin kurallarını yapılandırın.

Genel nesne 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.

SSS

Eklentinin kullanımıyla ilgili herhangi bir sorunuz varsa SSS bölümüne bakabilirsiniz.

Creative Commons Lisansı