[{"data":1,"prerenderedAt":730},["ShallowReactive",2],{"guide:en:admin":3},{"id":4,"title":5,"body":6,"description":722,"extension":723,"meta":724,"navigation":725,"path":726,"seo":727,"stem":728,"__hash__":729},"guide_en/en/user/admin/index.md","Administration",{"type":7,"value":8,"toc":699},"minimark",[9,14,18,34,39,42,46,62,65,73,77,80,92,98,102,108,113,116,120,125,141,146,155,159,164,175,180,191,196,206,210,213,217,222,293,296,313,317,322,342,347,379,383,388,414,419,430,436,440,447,485,490,506,510,515,526,531,545,550,564,569,583,587,594,598,635,638,642,677,681],[10,11,13],"h1",{"id":12},"the-role-of-the-admin","The Role of the Admin",[15,16,17],"p",{},"Admins ensure the application behaves in a way that users would expect so it aligns well with both organization record-keeping practices while smoothing organizational processes. In the context of Aptli, this covers several critical configuration activities that will be reviewed in this section:",[19,20,21,25,28,31],"ol",{},[22,23,24],"li",{},"Granting Access vs. Managing Access Requests",[22,26,27],{},"Authentication, customizing session settings and managing Single-Sign-On (SSO) with various Auth providers",[22,29,30],{},"Dynamic Authorization for fine-grained control over content",[22,32,33],{},"Other Application Configurations",[35,36,38],"h2",{"id":37},"database-initialization-and-defaults","Database Initialization and Defaults",[15,40,41],{},"New installations come pre-configured with sensible defaults for layers, resources, and application settings. An administrator can update these through the normal admin workflows described in this guide. If you need to reinitialize defaults, contact your system administrator.",[35,43,45],{"id":44},"version-review-queue","Version Review Queue",[15,47,48,49,53,54,57,58,61],{},"When a non-admin field user submits a GIS version, it enters the ",[50,51,52],"strong",{},"Admin → Versions"," review queue rather than going live immediately. Admins see a list of all pending versions, can preview the feature diff on the map, and choose to ",[50,55,56],{},"Commit"," (publish) or ",[50,59,60],{},"Delete"," (reject) each one.",[15,63,64],{},"This workflow ensures that field-submitted geometry changes are reviewed before they affect the shared dataset. Administrators' own submissions bypass the queue and commit directly.",[15,66,67,68,72],{},"See ",[69,70,45],"a",{"href":71},"/guide/admin/versions"," for the full workflow.",[35,74,76],{"id":75},"automations","Automations",[15,78,79],{},"Automations let admins define trigger-based rules that fire automatically when events occur — for example, send a push notification when an import completes, or post to a webhook when a work order is cancelled.",[15,81,82,83,86,87,91],{},"Automations are configured at ",[50,84,85],{},"Admin → Automations",". Each automation has a trigger (e.g., ",[88,89,90],"code",{},"geo.import.completed","), optional conditions (e.g., only fire for GDB files), and one or more actions (notify, webhook, audit log).",[15,93,67,94,97],{},[69,95,76],{"href":96},"/guide/admin/automations"," for the full guide.",[35,99,101],{"id":100},"resource-qr-code-generator","Resource QR Code Generator",[15,103,104,105,107],{},"For warehouse operations and field staff who need to accept physical shipments, Aptli provides a ",[50,106,101],{}," that creates printable reference books of all resources in the system.",[109,110,112],"h3",{"id":111},"purpose","Purpose",[15,114,115],{},"Field staff often receive shipments where items don't have QR codes attached. Rather than manually typing resource names (which is error-prone and slow), they can scan QR codes from a physical reference book kept at the receiving dock or warehouse station.",[109,117,119],{"id":118},"accessing-the-qr-code-generator","Accessing the QR Code Generator",[15,121,122],{},[50,123,124],{},"Navigation:",[19,126,127,138],{},[22,128,129,130,133,134,137],{},"Navigate to ",[50,131,132],{},"Admin → Resource QR Codes"," (",[88,135,136],{},"/admin/resource-qr-codes",")",[22,139,140],{},"Page displays all resources in the system as printable QR codes",[15,142,143],{},[50,144,145],{},"Permissions:",[147,148,149,152],"ul",{},[22,150,151],{},"Requires admin or inventory management permissions",[22,153,154],{},"Public-facing page (no sensitive data exposed)",[109,156,158],{"id":157},"filtering-and-searching","Filtering and Searching",[15,160,161],{},[50,162,163],{},"Filter by Resource Type:",[147,165,166,169,172],{},[22,167,168],{},"Dropdown options: All, Material, Labor, Equipment",[22,170,171],{},"Narrows QR codes to specific categories",[22,173,174],{},"Useful for creating specialized books (e.g., \"Materials Only\")",[15,176,177],{},[50,178,179],{},"Search Resources:",[147,181,182,185,188],{},[22,183,184],{},"Text search filters by resource name or ID",[22,186,187],{},"Real-time filtering as you type",[22,189,190],{},"Helpful for creating small reference sheets for specific projects",[15,192,193],{},[50,194,195],{},"Example Filters:",[197,198,203],"pre",{"className":199,"code":201,"language":202},[200],"language-text","Filter: Material\nSearch: \"cable\"\n→ Shows only material resources with \"cable\" in the name\n→ Cat6 Cable, Cat6A Cable, Fiber Optic Cable, etc.\n","text",[88,204,201],{"__ignoreMap":205},"",[109,207,209],{"id":208},"qr-code-format","QR Code Format",[15,211,212],{},"QR codes encode a reference to the record type and ID. The app handles decoding automatically when you scan.",[109,214,216],{"id":215},"generating-printable-books","Generating Printable Books",[15,218,219],{},[50,220,221],{},"Print Workflow:",[19,223,224,238,254,277],{},[22,225,226,229,230],{},[50,227,228],{},"Apply Filters"," (optional)",[147,231,232,235],{},[22,233,234],{},"Select resource types to include",[22,236,237],{},"Search for specific resources if needed",[22,239,240,243],{},[50,241,242],{},"Click Print Button",[147,244,245,248,251],{},[22,246,247],{},"Browser print dialog opens",[22,249,250],{},"Print layout optimized for standard letter/A4 paper",[22,252,253],{},"3 columns per page for maximum density",[22,255,256,259],{},[50,257,258],{},"Print Settings:",[147,260,261,264,267,270],{},[22,262,263],{},"Color: Optional (black & white works fine for QR codes)",[22,265,266],{},"Orientation: Portrait",[22,268,269],{},"Margins: 0.5 inch / 1.27 cm",[22,271,272,273,276],{},"Background graphics: ",[50,274,275],{},"Enable"," (ensures QR codes print)",[22,278,279,282],{},[50,280,281],{},"Post-Processing:",[147,283,284,287,290],{},[22,285,286],{},"Laminate pages for durability",[22,288,289],{},"Bind into reference book or binder",[22,291,292],{},"Place at receiving stations, warehouse desks, or loading docks",[15,294,295],{},"Each QR code card includes:",[147,297,298,301,304,307,310],{},[22,299,300],{},"QR code (150x150 pixels, scales well)",[22,302,303],{},"Resource name (bold, truncated if too long)",[22,305,306],{},"Resource type (Material/Labor/Equipment)",[22,308,309],{},"Default UOM (if defined)",[22,311,312],{},"Resource ID (small, hidden during print)",[109,314,316],{"id":315},"using-qr-codes-in-the-field","Using QR Codes in the Field",[15,318,319],{},[50,320,321],{},"Mobile Workflow:",[19,323,324,327,330,333,336,339],{},[22,325,326],{},"Field staff receives shipment at warehouse",[22,328,329],{},"Opens Manual Transaction Form on mobile device",[22,331,332],{},"Clicks scan button (📷) next to Resource Name field",[22,334,335],{},"Points camera at QR code in reference book",[22,337,338],{},"Resource details auto-populate from scanned code",[22,340,341],{},"Enters quantity and submits transaction",[15,343,344],{},[50,345,346],{},"Benefits:",[147,348,349,355,361,367,373],{},[22,350,351,354],{},[50,352,353],{},"Speed:"," Scan 5-10 items in under a minute",[22,356,357,360],{},[50,358,359],{},"Accuracy:"," No typos or spelling errors",[22,362,363,366],{},[50,364,365],{},"Batch Mode:"," Scan entire shipment, submit all at once",[22,368,369,372],{},[50,370,371],{},"No Training:"," Intuitive camera interface",[22,374,375,378],{},[50,376,377],{},"Works Offline:"," QR scanning doesn't require internet",[109,380,382],{"id":381},"maintenance-and-updates","Maintenance and Updates",[15,384,385],{},[50,386,387],{},"When to Regenerate Books:",[147,389,390,396,402,408],{},[22,391,392,395],{},[50,393,394],{},"New Resources Added:"," Print supplement pages for new resources",[22,397,398,401],{},[50,399,400],{},"Resource Names Changed:"," Reprint affected pages",[22,403,404,407],{},[50,405,406],{},"Major Catalog Overhaul:"," Regenerate entire book",[22,409,410,413],{},[50,411,412],{},"Damaged Pages:"," Reprint and replace specific pages",[15,415,416],{},[50,417,418],{},"Version Control:",[147,420,421,424,427],{},[22,422,423],{},"Add print date to book cover (handwritten or label)",[22,425,426],{},"Keep old books as backup during transition",[22,428,429],{},"Gradually phase out outdated books",[15,431,432,435],{},[50,433,434],{},"Tip:"," For frequently added resources, keep blank laminated pages in book. Print new QR codes on labels and apply to blank pages.",[109,437,439],{"id":438},"integration-with-manual-transactions","Integration with Manual Transactions",[15,441,442,443,446],{},"The QR code generator is designed to work seamlessly with the ",[50,444,445],{},"Manual Transaction Form",":",[19,448,449,455,461,467,473,479],{},[22,450,451,454],{},[50,452,453],{},"Admin generates book"," → Warehouse staff have reference",[22,456,457,460],{},[50,458,459],{},"Shipment arrives"," → Field staff open transaction form",[22,462,463,466],{},[50,464,465],{},"Scan QR from book"," → Resource auto-fills",[22,468,469,472],{},[50,470,471],{},"Enter quantity"," → Complete transaction",[22,474,475,478],{},[50,476,477],{},"Batch mode"," → Scan multiple items quickly",[22,480,481,484],{},[50,482,483],{},"Submit"," → Inventory updated instantly",[15,486,487],{},[50,488,489],{},"See Also:",[147,491,492,499],{},[22,493,494,498],{},[69,495,497],{"href":496},"/guide/inventory-management/transactions#manual-transaction-entry-with-qr-code-scanning","Manual Transaction Entry with QR Code Scanning"," - Field staff workflow",[22,500,501,505],{},[69,502,504],{"href":503},"/guide/inventory-management/transactions","Transactions"," - Transaction types and audit trail",[109,507,509],{"id":508},"best-practices","Best Practices",[15,511,512],{},[50,513,514],{},"Book Organization:",[147,516,517,520,523],{},[22,518,519],{},"Alphabetical by resource name (easiest to browse)",[22,521,522],{},"Grouped by type (Material → Labor → Equipment)",[22,524,525],{},"Separated by department (if multi-department warehouse)",[15,527,528],{},[50,529,530],{},"Physical Placement:",[147,532,533,536,539,542],{},[22,534,535],{},"Receiving dock (shipment acceptance)",[22,537,538],{},"Warehouse desk (cycle counts, adjustments)",[22,540,541],{},"Loading area (pickups, transfers)",[22,543,544],{},"Mobile carts (for moving around large warehouses)",[15,546,547],{},[50,548,549],{},"Durability:",[147,551,552,555,558,561],{},[22,553,554],{},"Laminate all pages (protect from dust, spills)",[22,556,557],{},"Heavy-duty binder (withstands daily use)",[22,559,560],{},"Chain/cable to desk (prevents loss)",[22,562,563],{},"Backup copy in office (disaster recovery)",[15,565,566],{},[50,567,568],{},"Training:",[147,570,571,574,577,580],{},[22,572,573],{},"Show new staff how to scan QR codes",[22,575,576],{},"Demonstrate batch mode for multi-item shipments",[22,578,579],{},"Practice with sample shipment (5-10 items)",[22,581,582],{},"Emphasize: \"Scan, don't type\"",[35,584,586],{"id":585},"audit-history-export","Audit History Export",[15,588,589,590,593],{},"The ",[50,591,592],{},"Audit History"," page records all significant actions in the system — authentication events, permission changes, record modifications, and soft deletes. Admins can export a subset of the audit log for compliance reporting or investigation.",[109,595,597],{"id":596},"accessing-the-export","Accessing the Export",[19,599,600,605,622,629],{},[22,601,129,602],{},[50,603,604],{},"Admin → Audit History",[22,606,607,608],{},"Apply filters to narrow the export:\n",[147,609,610,616],{},[22,611,612,615],{},[50,613,614],{},"Date range"," — select start and end dates",[22,617,618,621],{},[50,619,620],{},"Model filter"," — limit to a specific data type (users, work orders, transactions, etc.)",[22,623,624,625,628],{},"Select the ",[50,626,627],{},"Format"," — CSV or JSON",[22,630,631,632],{},"Click ",[50,633,634],{},"Export",[15,636,637],{},"The export is generated immediately and downloaded as a file.",[109,639,641],{"id":640},"format-details","Format Details",[643,644,645,657],"table",{},[646,647,648],"thead",{},[649,650,651,654],"tr",{},[652,653,627],"th",{},[652,655,656],{},"Best For",[658,659,660,669],"tbody",{},[649,661,662,666],{},[663,664,665],"td",{},"CSV",[663,667,668],{},"Spreadsheet review, importing into reporting tools",[649,670,671,674],{},[663,672,673],{},"JSON",[663,675,676],{},"Programmatic processing, feeding into external systems",[109,678,680],{"id":679},"limits-and-permissions","Limits and Permissions",[147,682,683,689],{},[22,684,685,688],{},[50,686,687],{},"Row limit:"," 10,000 rows per export. If your filter returns more, narrow the date range or model filter and export in batches.",[22,690,691,694,695,698],{},[50,692,693],{},"Required permission:"," ",[88,696,697],{},"auditExport"," admin right. Users without this right do not see the Export button.",{"title":205,"searchDepth":700,"depth":700,"links":701},2,[702,703,704,705,717],{"id":37,"depth":700,"text":38},{"id":44,"depth":700,"text":45},{"id":75,"depth":700,"text":76},{"id":100,"depth":700,"text":101,"children":706},[707,709,710,711,712,713,714,715,716],{"id":111,"depth":708,"text":112},3,{"id":118,"depth":708,"text":119},{"id":157,"depth":708,"text":158},{"id":208,"depth":708,"text":209},{"id":215,"depth":708,"text":216},{"id":315,"depth":708,"text":316},{"id":381,"depth":708,"text":382},{"id":438,"depth":708,"text":439},{"id":508,"depth":708,"text":509},{"id":585,"depth":700,"text":586,"children":718},[719,720,721],{"id":596,"depth":708,"text":597},{"id":640,"depth":708,"text":641},{"id":679,"depth":708,"text":680},"Administrator tasks for managing users, access control, GIS version approvals, automations, inventory QR codes, and audit exports.","md",{},true,"/en/user/admin",{"title":5,"description":722},"en/user/admin/index","11x1xQAdoythOmoi2Vw8WVDHHOdh-jGA6lcazFovICI",1776295546621]