PC Repair Tracker

[arnoud]

TO USE THE LATEST FUNCTIONALITY, DOWNLOAD THE ATTACHED scancircle2pcrt.php AND INSTALL IT IN YOUR PCRT repair DIRECTORY

By specifying the PC Repair Tracker (PCRT) asset/device id (pcid) as a reference code for a scan, by default:

1. The computer specs are stored with the asset/device (so that you don't need to enter this data manually);
   
2. The scans are logged as asset attachments (so you can track the status of the computer from check-in to check-out);
   
3. Any changes to the computer specs are logged as internal notes (so you can see what has been changed between scans).
   

Please watch this partner video first (needs to be updated to reflect the new Notifications user interface in release 2.8).

Requirements:

1. In your PC Repair Tracker environment:
   
   1. Go to Settings > Integration Info >Go and copy the API key for the ScanCircle integration. If you don't have an API key yet or want to change it, select Settings > Create New Store Hash > Go; 
      
   2. This interface relies on the mainassetinfofields table in the PCRT database to contain the following matchwords (the fields marked with "*" are non-standard and can be manually added to the database table if required):
      • serial (serial number)
        
      • operatingsystem
        
      • cpu
        
      • ram
        
      • partition (disk drives)
        
      • videocard
        
      • bios
        
      • installedon
        
      • windowsproductkey (only for scans in partner mode)
        
      • computername*
        
      • motherboard*
        
      • ipaddress*
        
2. In your ScanCircle partner environment, select the Notifications tab. Add the destination "PC Repair Tracker" and fill in the required fields (only "URL" and "Store Hash" are required). Optionally change the other fields and the advanced settings, but the defaults usually suffice. For all fields, a description is shown at the righthand site.  Click "Check" to check the connection and then click "OK". Optionally add alternative destinations (e.g. for other categories) and make sure to finish with an "Email" address to which unhandled scan notifications and referral notifications will be sent. Finally click "Save";
   
3. Generate the scan widget in your ScanCircle partner environment and copy the generated HTML code or shortcode to your website:
   
   1. Specify the name of a URL parameter (e.g. "pcid") if you want to set the pcid in a link , e.g. https://domain.com/scan?pcid=1234;
      
   2. Specify an input field label (e.g. "PC number or email address") if you want the end-user to see/change/enter the pcid;
      
   3. Specify a category if you want this widget to only handle PCRT reference codes. Make sure you specify the same category in the "Notifications" setting.  You do not need to specify this if you use a single scan widget and want to allow other reference codes (e.g. e-mail address or phone number) which do not match any PCRT pcid (as failed matches will be forwarded to the next notification option as standard);
      
4. Day-to-day use:
   
   1. When you check in a new computer, you do not need to enter the computer specs and do not print the claim ticket yet;
      
   2. Then perform a ScanCircle scan on the computer and enter the new pcid as reference code (this will set the specs and log the initial state of the computer);
      
   3. Now print the claim ticket for the customer and fix the computer;
      
   4. Before you check out the computer, always perform a last scan with the pcid as reference code (logs the end state) and optionally print the ScanCircle before-and-after report for the customer;
      
   5. You may allow the customer to periodically scan its computer using the pcid (suggestion: give them a link containing the pcid).
      
5. Notes:
   
   1. Only the first digits of the reference code (following any category+colon) are used to find a match, so you may add additional information (e.g. "1234 client A" will match 1234);
      
   2. This add-on was as standard provided in PCRT v2.1-v9. Since there have not been any new releases, please install the attached scancircle2pcrt.php in your PCRT repair directory;
      
   3. If you want to add any pre or post processing, you can create a file called scancircle2pcrt_pre.php and/or scancircle2pcrt_post.php with your own PHP code in your PCRT repair directory; 
      
   4. If you are still using PCRT v2.0 or v1.40, please replace the wo.php file in your PCRT repair directory with the relevant attached version to open the scan links in the main repair page;
      
   5. The standard module SimpleXML must be installed (and not disabled) in your PHP environment.
      

If you want to use this add-on, please make sure you subscribe to this discussion using the option in the lower left corner of this page so that you will be notified of any updates automatically.