PC Repair Tracker - arnoud - 19-11-2015
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:
- The computer specs are stored with the asset/device (so that you don't need to enter this data manually);
- The scans are logged as asset attachments (so you can track the status of the computer from check-in to check-out);
- 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:
- In your PC Repair Tracker environment:
- 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;
- 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*
- 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";
- Generate the scan widget in your ScanCircle partner environment and copy the generated HTML code or shortcode to your website:
- 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;
- Specify an input field label (e.g. "PC number or email address") if you want the end-user to see/change/enter the pcid;
- 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);
- Day-to-day use:
- When you check in a new computer, you do not need to enter the computer specs and do not print the claim ticket yet;
- 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);
- Now print the claim ticket for the customer and fix the computer;
- 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;
- You may allow the customer to periodically scan its computer using the pcid (suggestion: give them a link containing the pcid).
- Notes:
- 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);
- 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;
- 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;
- 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;
- 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.
RE: Integration with PC Repair Tracker - arnoud - 01-12-2015
Added logto parameter and changed numerical parameter values to descriptive values
RE: Integration with PC Repair Tracker - arnoud - 09-01-2016
Simplified the parameters (no checks on open work orders anymore) and updated to PCRT v2.
RE: Integration with PC Repair Tracker - arnoud - 14-01-2016
Removed the logto parameter and added day-to-day use instructions.
RE: Integration with PC Repair Tracker - arnoud - 16-01-2016
Formal release 1.33
RE: Integration with PC Repair Tracker - arnoud - 14-02-2016
Updated attached scancircle2pcrt.php script to v1.34.1 (Multi-lingual, installation tips, extra fields, version).
Upload scancircle2pcrt.php to your PCRT repair folder and open it in your browser. The will check your configuration and give you install tips. Also shows the version used. Extra fields are not yet supplied by ScanCircle release 1.34.1.
RE: Integration with PC Repair Tracker - arnoud - 19-02-2016
v1.34.2 Added token authentication parameter (suggested by Luke)
RE: Integration with PC Repair Tracker - arnoud - 02-03-2016
V1.35: added extra fields (requires ScanCircle release 1.35) and debug option
RE: Integration with PC Repair Tracker - cartcom - 07-03-2016
Can I use this to create a new work order when someone does a scan?
RE: Integration with PC Repair Tracker - arnoud - 08-03-2016
I have thought about that, but it might "pollute" your PCRT database with thousands of anonymous work orders. Your best approach is to check-in the new computer manually without specifying the computer specs, then do a scan with the generated pcid as reference* (which will add the computer specs and the scan) and next print the claim ticket. Be sure to do a scan before returning the computer to the customer and print the before&after report.
Please let me know if there might be a way to safely add a new computer/work order based on a scan.
*) You can set the reference by adding an "Input field" to the scan widget on your own website or by pressing the word "scan" in the disclaimer below the scan button (which will bring up the partner mode and prompt for a reference code).
|