ADMS

Modul: adms, Asset Document Management System. Register dokumen kedua, dibangun tahun 2023, yang menyimpan dokumen terhadap hierarki asset (plant, unit, equipment), bukan terhadap MDR sebuah project. Punya layar referensi sendiri (adms_reference), tabel sendiri dan alur check-out dan check-in sendiri. Sepenuhnya memakai $pdo.

Cara halaman ini diverifikasi

Ditulis dari master pada 2026-09-06 dan dibandingkan dengan big five di hari yang sama. Bagian layar ditulis ulang pada 2026-09-07 dengan layar dibuka di inact-jadestone.eris.place (snapshot produksi Jadestone, project AKT, super-admin INACT). 12 file modul dan 10 file referensi, sekitar 210 pemanggilan database, tidak ada yang memakai helper legacy.

Posisinya

Level asset (ts_assets: label, is_relation)  →  nilai asset (ts_detail_asset, ts_map_asset_detail)
        ↓ tagging (ts_da_tagging)
Master dokumen (ts_docassets_master)  →  revisi (ts_documents_asset)  →  file (ts_map_file_asset)
        ↓                                        ↓
dokumen terkait (ts_da_related)          log aktivitas (ts_docasset_activity): check-out, check-in

Hierarki asset tidak tetap: ts_assets mendefinisikan level dan labelnya, is_relation menyatakan apakah sebuah level bergantung pada level di atasnya, dan ts_detail_asset menyimpan nilainya. Sebuah dokumen di-tag ke satu nilai per level.

Datanya

Tabel	Berisi
ts_docassets_master	satu baris per dokumen: nomor, judul, da_project, da_doc_owner, da_doc_originator, docdiscp_code, drawing_category_code, da_doc_date, da_doc_rev_date, da_docrurr_status (status terkini)
ts_documents_asset	satu baris per revisi, dengan rev_sort (ditambahkan 2026-08) dan nama file asli (ts_nativefilename_adms)
ts_da_tagging	dokumen ↔ nilai asset
ts_da_related	dokumen ↔ dokumen terkait
ts_docasset_activity	siapa yang check-out atau check-in dokumen dan kapan
ts_adms_doctype, ts_adms_subtype, ts_adms_drawing_category, ts_adms_issued_status, ts_adms_result_code, ts_adms_projects, ts_assetdocdiscipline	daftar referensi ADMS, terpisah dari yang DMS

Layarnya

adms.php merender adms_browse.htm. Berbeda dengan modul DMS lain, ia tidak dibuka pada grid: ia dibuka pada ADMS Home, penjelajah kolom atas level asset, dan grid dokumen adalah lapisan kedua yang dicapai dari sana.

ADMS Home di Jadestone: satu kolom per level asset, FACILITY sampai UNIT, dan Search, Show All serta Submit di bawah · click to enlarge

Menelusuri ke bawah: memilih facility mengisi kolom berikutnya dengan nilai yang di-tag di bawahnya · click to enlarge

ADMS Home

Satu kolom per baris ts_assets, urut level_asset; header kolomnya adalah labelnya (label_asset), itu sebabnya Jadestone membaca FACILITY, GROUP DOCUMENT, DISCIPLINE / PO_VENDOR NAME_EQUIPMENT SUPPLY, DOCUMENT TYPE, UNIT dan instance lain membaca hal lain. Tiap kolom mendaftar nilai level itu (ts_detail_asset), dengan ikonnya. Klik sebuah nilai mengisi kolom berikutnya dengan nilai yang berelasi dengannya (ts_map_asset_detail, berlaku kalau level punya is_relation = 1). Tiga tombol menutup halaman:

Tombol	Yang dilakukan
Submit	membuka grid dokumen untuk nilai yang dipilih di kolom
Show All	membuka grid dokumen untuk seluruh project
Search	membuka dialog Search Data langsung dari halaman home

Grid dokumen

ADMS Library: ALL. Toolbar, satu baris per dokumen dengan revisi terakhirnya, dan sebuah dokumen yang sedang di-check-out di kolom Checkin/Checkout · click to enlarge

show=documents mendaftar baris ts_docassets_master, satu per nomor dokumen dengan revisi terakhirnya dari ts_documents_asset. Tanda + membuka sub-grid revisi (adms_subgrid.inc.php, urut rev_sort), dengan kolom yang sama per revisi plus file native.

Sub-grid revisi: PDF dan Native Files per revisi · click to enlarge

Kolom, dari adms.inc.php: Document No, Document Title, Doc. Rev, Issued Status, Checkin/Checkout, Remarks, PDF File, Native Files, Doc. Date, Doc. Expiration Date, Doc. Originator, Discipline, Doc. Type, Unit Code (Jadestone), Sub Type. Sel Checkin/Checkout menampilkan Checked Out selama seseorang memegang dokumen, dan Remarks membawa catatan check-out-nya.

Tombol	Handler	Yang dilakukan
New	cmd=add, act=add	dialog New Document: nomor, revisi, lampiran PDF dan native, judul, issued status, project, originator, discipline, document type, drawing category, sub type, unit code, tanggal, dokumen terkait, dan satu nilai per level asset
Edit	cmd=edit, act=edit	dialog yang sama untuk dokumen terpilih; editallrevision menerapkan metadata ke setiap revisi
Delete	cmd=deleteDocMaster	setelah isPersonAllowedToDelete
Refresh
Check In, Check Out, Multiple Check In, Cancel Check Out	act=checkin, checkout, cancelCO	lihat di bawah
Download	cmd=downloadAttachment, downloadPdfFile, batchdownload	file-nya, PDF dengan watermark kalau checkSettingWatermark mengatakan begitu, atau zip dari dokumen terpilih
Batch Upload	cmd=uploadmetaform	import metadata, lihat di bawah
Export	export_csv_act	grid sebagai CSV
Regroup By		mengelompokkan grid per kolom
Search	cmd=search	dialog Search Data

New Document: nomor, revisi, lampiran PDF dan native di kiri; judul, issued status, project, originator, discipline, document type dan tanggal di kanan; level asset di bawah · click to enlarge

Search Data: Basic Search, Advance Search dengan field, operator dan nilai, dan My Search, pola tersimpan dari ts_search_pattern · click to enlarge

Search punya tiga tab: Basic (nomor dan judul, di folder terpilih atau semua), Advance (baris field / operator / nilai, dengan between, dan sort), dan My Search, pencarian tersimpan per orang di ts_search_pattern dengan nama, pembuat dan action.

Import lewat metadata

Batch Upload: download template metadata, isi, upload · click to enlarge

Tombol Batch Upload memulai alur Excel-dulu: download template (getTemplateAdmsBatch), isi satu baris per dokumen, upload (uploadmetaprocess). Barisnya masuk penyimpanan sementara dengan temp_id di ts_docassets_master dan ditampilkan di halaman tinjauan (temporarymetadatalist, temporaryconfirmpage) tempat duplikat (checktempduplicatedocnumber) dan nilai level yang tidak dikenal (checkislevellabel) ditandai. Confirm (proceedsavetempdatatodocuments) mengubahnya menjadi dokumen, lalu file di-upload terhadap baris itu (multiuploadafterimportmetadata). cleartemporaryexceldata membuang batch-nya. Alur yang sama dengan temporarymetadatalistmultipleci dipakai Multiple Check In.

Check-out dan check-in

checkout menandai dokumen sedang dipegang orang yang login, menulis baris ts_docasset_activity dan menampilkan Checked Out di grid; checkin meng-upload revisi baru (uploadmetaformedit untuk metadata, lalu file-nya) dan melepasnya; cancelCO melepas tanpa revisi. Hanya orang yang check-out, atau admin, yang bisa check-in (isPersonAllowedToCheckinCheckout); isAllowedCheckInDoc menolak check-in pada dokumen yang tidak sedang di-check-out. Kode privilege adms_checkout dan adms_download mengatur tombolnya.

Setting

Entri ADMS di bawah Setting membuka adms_reference.php, berjudul ADMS and Internal Document Settings, dengan peringatan saat masuk bahwa menghapus atau mengubah record bisa memutus tautan dokumen yang sudah di-upload. Tiga tab:

Asset Grouping: level-levelnya, urutannya dan apakah sebuah level bergantung pada level di atasnya · click to enlarge

Asset Label: nilai-nilai satu level, dengan visibilitas dan ikon · click to enlarge

Library Grouping And Label: daftar referensi ADMS, di sini project · click to enlarge

Tab	Tabel	Yang diedit
Asset Grouping	ts_assets	satu baris per level: Group Name (label_asset), Level (level_asset, diberi nomor bebas berikutnya), Set Relation (is_relation). New, Edit, Delete, Refresh dan Import Excel
Asset Label	ts_detail_asset, ts_map_asset_detail	pilih level, lalu nilai-nilainya: Value (desc_detail_asset), kode, Visible (is_visible), Icon (imgpath, di-upload ke image/adms_icons/) dan, untuk level berelasi, nilai induknya
Library Grouping And Label	ts_adms_projects, ts_assetdocdiscipline, ts_adms_doctype, ts_adms_subtype, ts_adms_drawing_category, ts_adms_issued_status dan ts_adms_unit_code milik Jadestone	pilih Reference, lalu grid kode / deskripsi / visible dengan New, Delete, Search, Refresh dan Import (adms_reference_import.inc.php)

Hal yang perlu diwaspadai

• Label level adalah data. Layar yang menampilkan "Unit" atau "Area" membacanya dari ts_assets; dua instance bisa menampilkan label berbeda untuk nomor level yang sama.
• Daftar referensi DMS dan ADMS adalah tabel terpisah. Menambah tipe dokumen di setting DMS tidak membuatnya tersedia di sini.
• Check-out tidak punya batas waktu. Dokumen tetap terkunci sampai seseorang check-in atau membatalkan.

Perbedaan antar instance

Status aktif di bawah dibaca dari database local dev (snapshot produksi) tiap instance pada 2026-09-10; jumlah file drift diukur terhadap kode master pada 2026-09-06. "Aktif" berarti modul adms menyala di menu (modules_is_installed) dan, jika disebut, punya data ts_assets. Semua fork membawa kode ADMS — foldernya ada di semuanya — jadi "tidak aktif" berarti kodenya ada tetapi dimatikan.

Instance	Perbedaan
Jadestone	Aktif, dengan data aset. Sembilan file modul dan delapan file referensi berbeda; layar referensi adms_unit_code ditambahkan, dan level Unit plus watermark saat download disambungkan lewat form dan alur upload. Di snapshot 2026-09-07 baris browse adms ditandai mati padahal ADMS Settings dan data asetnya ada, jadi hanya Settings yang muncul di menu — kekeliruan data yang perlu dikonfirmasi di instance live.
Medco	Aktif (adms menyala di menu). Delapan file modul berbeda, drift 2024 sampai 2026, bukan pekerjaan klien. Belum ada baris aset.
Tomori	Aktif, dengan data aset. Tomori adalah implementasi ADMS itu sendiri; pekerjaan ADMS punya space sekali pakai sendiri INA34, tetapi project Tomori adalah INA12. Sembilan file modul berbeda.
Timas, KTP, JOTRE, Prima Energy	Kode ADMS ada (8 sampai 10 file berbeda, drift) tetapi tidak aktif: modul mati di menu dan tidak ada data aset.

Terkait

• Document Library: register berbasis project.
• Setting DMS: daftar referensi DMS, sebagai pembanding.
• Users dan privilege.