We have been asked many times by our channel partners if there was a way to send out an email reminder to users to tell them what their Primary or Secondary ID Numbers are and provide a PaperCut ID Number Reminder.
As we had some spare time while being between some interesting integration projects (more on these later) and we wanted to put our <a href="https://golang.org/" target="_blank" rel="noopener noreferrer">Go</a> implementation of the <a href="https://www.papercut.com/products/ng/manual/common/topics/tools-web-services.html" target="_blank" rel="noopener noreferrer">PaperCut XML-RPC API</a> to good use we have created this quick tool which will send out those reminders if needed.
<table style="width: 100%;">
<tbody>
<tr>
<td><a href="https://drive.google.com/file/d/1i33UZ6-10WoL8AUL9SNSt3wNFxCGDheU/view?usp=sharing" target="_blank" rel="noopener noreferrer">Download for Linux</a></td>
<td><a href="https://drive.google.com/file/d/14QtdnZURtetfshc8fVFkWlRU2jjz4weX/view?usp=sharing" target="_blank" rel="noopener noreferrer">Download for Windows</a></td>
<td><a href="https://drive.google.com/file/d/10S5IfiVjeqy3-PO9ZRJYftuZpoM1lztm/view?usp=sharing" target="_blank" rel="noopener noreferrer">Download for Mac</a></td>
</tr>
</tbody>
</table>
<h3></h3>
<h3>How do I use the PaperCut ID Number Reminder?</h3>
Simple, download the archive for your platform of choice, extract to an easy to find directory and modify the config.toml file to fit your environment. You can even modify the templates if you want but make sure you keep the placeholders in there for the Primary and Secondary ID numbers.
<h3>What are these values for in the config file?</h3>
[widgetkit id="56" name="Blog - ID reminder tool"]
<h3>Awesome, What are the command options?</h3>
If you want to remind a single user of their ID you would run:
<pre class="toolbar:2 toolbar-overlay:false toolbar-hide:false toolbar-delay:false show-title:false striped:false marking:false ranges:false nums:false nums-toggle:false wrap-toggle:false lang:sh decode:true ">id_reminder user username</pre>
If the username contains a space your command would look like this (this also applies to group names):
<pre class="toolbar:2 toolbar-overlay:false toolbar-hide:false toolbar-delay:false show-title:false striped:false marking:false ranges:false nums:false nums-toggle:false wrap-toggle:false lang:sh decode:true">id_reminder user "user name"</pre>
For a group of users (or OU) you will run:
<pre class="toolbar:2 toolbar-overlay:false toolbar-hide:false toolbar-delay:false show-title:false striped:false marking:false ranges:false nums:false nums-toggle:false wrap-toggle:false lang:sh decode:true">id_reminder group groupname</pre>
If you are feeling brave and your mail server will handle it you can remind all users with this command:
<pre class="toolbar:2 toolbar-overlay:false toolbar-hide:false toolbar-delay:false show-title:false striped:false marking:false ranges:false nums:false nums-toggle:false wrap-toggle:false lang:sh decode:true">id_reminder all</pre>
We can also generate ID numbers if needed for any user that doesn't currently have an ID. For a user you would run:
<pre class="toolbar:2 toolbar-overlay:false toolbar-hide:false toolbar-delay:false show-title:false striped:false marking:false ranges:false nums:false nums-toggle:false wrap-toggle:false lang:sh decode:true">id_reminder generate user "username"</pre>
or for a group of users:
<pre class="toolbar:2 toolbar-overlay:false toolbar-hide:false toolbar-delay:false show-title:false striped:false marking:false ranges:false nums:false nums-toggle:false wrap-toggle:false lang:sh decode:true">id_reminder generate group "groupname"</pre>
<h3>I get user or group does not exist, what did I do wrong?</h3>
Try "    "'s around the name for example "John McTester"
<h3>What happens if I try to send both IDs but users only have one of them set?</h3>
The tool will work this out and just send the ID it can find using the single email template (Mama Didn't Raise No Fool!)
<h3>Hang on, I didn't put my SMTP settings in the config file</h3>
There is no need, We take these values from PaperCut for you so as long as you can send a notification from PaperCut you will be all good here, If you are using a mail relay that doesn't require authentication set the anonrelay value to true in the config.toml
<h3>Where do I go for support or if I want to ask if you can send a notification using a different method?</h3>
Just send an email to <a href="mailto:support@selectec.com">support@selectec.com</a> and we will get back to you, remember this is a free tool so if we are in the middle of an urgent issue there may be a slight delay in our reply. For feature requests - If we agree with you and you are nice then we can look at updating the PaperCut ID Number Reminder Tool with your requirements. Enjoy!

<img class="alignnone wp-image-3602 size-full" title="PaperCut ID Number Reminder" src="https://staging.selectec.com/wp-content/uploads/2017/06/id_reminder.gif" alt="PaperCut ID Number Reminder" width="1905" height="972" />
<h3>What's new?</h3>
<h4>May 1st 2018</h4>
<ul>
 	<li>Added an option to generate ID numbers for users that don't have them</li>
 	<li>Added an option to ignore SSL/TLS certificate issues when sending emails</li>
 	<li>Updated the email templates to support UTF-8 characters</li>
 	<li>Updated the email templates so you can now use the username if required</li>
</ul>