EID reader: Installation and Setup

From myFMbutler wiki
(Difference between revisions)
Jump to: navigation, search
 
(4 intermediate revisions by one user not shown)
Line 1: Line 1:
[[Category:PrinterSwitch]]
+
[[Category:eID reader plugin]]
[[eID reader plugin|< Back to PrinterSwitch]]
+
<small>[[Main_Page|Main Page]] > [[EID_reader_plugin|EID plugin]] > Installation and setup</small>
  
 
= What does it do? =
 
= What does it do? =
Line 19: Line 19:
 
== Installation ==
 
== Installation ==
  
First of all, install the plugin - make sure to quit FileMaker first if it is running:
+
To read the eID card, the Belgian eID runtime software must first be installed.
 +
If that's not the case, please pre-install this separately.
 +
The runtime software "Belgian_Identity_Card_Run-time" is available for free to download on:
 +
[http://eid.belgium.be/nl/Hoe_installeer_je_de_eID/]
  
 +
Once you've installed the middleware, open the "myFMbutler eID Installer."
 +
• Windows
 +
The plug-in will be  installed in:
 +
C: \ Documents and Settings \ [user] \ Local Settings \ Application Data \ FileMaker \ Extensions (Windows XP)
 +
C: \ Users \ [user] \ Local Settings \ Application Data \ FileMaker \Extensions (Windows Vista / 7)
 +
The "eID" folder, which contains the instructions and example files, is installed in the Documents folder of the user.
  
On '''Windows''', use the included Installer application, which will automatically install all components, the plug-in as well as the PDF printer driver software.
+
A shortcut to this folder is installed on the desktop.
The plug-in will be installed in the following location:
+
  
<code>C:\Documents and Settings\[user]\Local Settings\Application
+
Mac OS X
Data\FileMaker\Extensions  (on Windows XP)</code>
+
The installer copies the plug-in to the following path:
 
+
~ / Library / Application Support / FileMaker / Extensions /
<code>C:\Users\[user]\Local Settings\Application Data\FileMaker\
+
The documentation and sample files are located in the home directory of the user:
Extensions (On Windows Vista/7)</code>
+
~ / Documents / myFMbutler / eID & SIS /
 
+
The '''myFMbutler PrinterSwitch''' folder, containing the manual and example files will be installed in the '''Documents''' folder.
+
 
+
A shortcut to this folder will also be installed on your Desktop.
+
 
+
If you want to remove PrinterSwitch, run the same Install application, and click ‘Remove’ (be sure to quit FileMaker before doing this). Alternatively, you can use ‘Add & Remove Programs’.
+
 
+
 
+
On '''Mac OS X''', run the installer.
+
 
+
The plug-in will be copied to:
+
 
+
<code>~/Library/Application Support/FileMaker/Extensions/</code>
+
 
+
The manual and example files will be installed at:
+
 
+
<code>/Applications/myFMbutler PrinterSwitch/</code>
+
  
 
In order to remove the plugin, quit FileMaker and remove the plugin file from the Extensions folder.
 
In order to remove the plugin, quit FileMaker and remove the plugin file from the Extensions folder.
 
 
  
 
== Example Files==
 
== Example Files==
Line 61: Line 50:
 
The '''''Dialog Suppressed'''''  example demonstrates the behaviour of the plugin where the eID middleware no longer asks for authorisation at each reading.
 
The '''''Dialog Suppressed'''''  example demonstrates the behaviour of the plugin where the eID middleware no longer asks for authorisation at each reading.
  
The '''''Specific'''' example provides you with some examples of how to retrieve only some specific data from the eID card.
+
The '''''Specific''' example provides you with some examples of how to retrieve only some specific data from the eID card.
 
+
 
+
 
+
 
+
=== Basic printer selection ===
+
 
+
In the 'Basic Selection' tab, to make a printer selection from within FileMaker, just select a printer from the Printer Name popup list - you should get an 'OK', which implies PrinterSwitch has selected the printer. Now choose 'Print…' to print to the currently selected printer. The ‘Rebuild Printer List’ button will rebuild the printer list, i.e. execute the PrSw_PrinterNames function, which will update the list of printer names. Refer to p. 9 of this manual for a full overview of all PrinterSwitch functions.
+
The ‘license info’ shows the PrinterSwitch licensing information. For an overview of the PrSw_Version function, please refer to the PrinterSwitch functions overview in Chapter 5.
+
 
+
=== Filtered printer selection===
+
The 'Filtering' example gives an overview of how PrinterSwitch allows you to filter the list of printer names that are shown.
+
You can add patterns that will filter the PrinterNames list that is returned by the PrinterSwitch plug-in, using either ‘ignore’ to omit certain printers from the list, or using ‘only’ to show only a specific type of printer. (see also p. 11 of this manual for more details about the ‘PrSw_Configure’ function).
+
 
+
''Note'': When changing one of the pattern fields in our example, the filtered printer list will be shown in the pop-up dialog only after clicking the 'Rebuild Printer List' button.
+
 
+
=== Creating PDFs from within FileMaker===
+
Another function of the PrinterSwitch plug-in is automatic and dynamic PDF creation.
+
To create a PDF, enter the file path of your choice in the PDF file path field. You can enter either a Mac or Windows file path, or both. If you then select 'Print', the PDF will be generated.
+
 
+
''Note'': on Mac OS X, a standard printer always needs to be selected in order to print to PDF - on Windows, PrinterSwitch will always default to the '''''myFMbutler PrinterSwitch PDF printer''''' for creating PDF's).
+
 
+
''Note for Windows users:'' The myFMbutler PrinterSwitch PDF Printer is only available for use from within FileMaker. The PDF converter driver cannot be used from within other applications.
+
 
+
 
+
PDF file paths on Windows will look like this:
+
 
+
<code>C:\\Windows\\temp\\Example.pdf  (i.e. with double backslashes)</code>
+
 
+
PDF file paths on Mac OS X will look like this:
+
 
+
<code>/Users/[your username]/Desktop/Example.pdf (full path name) or
+
~/Desktop/Example.pdf (user directory path name)</code>
+
 
+
''Note'': if a file with the same name already exists on the file path you specify, the file will automatically be replaced. 
+
If the PDF file path field is empty, PrinterSwitch returns to normal printing.
+
 
+
 
+
===Capture-Restore Settings example===
+
 
+
The '''Capture-Restore''' example shows you how to save a specific printer setup,  consisting of not only page orientation, paper size and paper source for a certain printer, but also certain driver-specific settings.
+
 
+
The example lets you store an unlimited number of settings, and then later retrieve them at the time of printing. Check the field information in the example, as well as some of the sample scripts, to see how you can integrate this functionality in your Windows solutions, and also how to combine it with resetting the current (default) Windows printer after completing your scripts, or when closing your FileMaker files.
+
 
+
More details can be found in the Chapter ‘About Windows Print Options’.
+

Latest revision as of 13:26, 5 January 2016

Main Page > EID plugin > Installation and setup

Contents

[edit] What does it do?

myFMbutler eID is a plugin for FileMaker Pro 13 (and also 11 & 12), which enables you to read information from the Belgian eID identitydirectly into a FileMaker database. The plugin allows to process the following data: a. General information (name and date of birth, etc.) b. address c. additional information d. Photo e. card info

[edit] What do I need?

FileMaker Pro 12 or higher , running on MacOS X 10.6.x or higher, or Windows XP SP3 or higher, including Windows Vista and Windows 7)

[edit] How do I make this work?

[edit] Installation

To read the eID card, the Belgian eID runtime software must first be installed. If that's not the case, please pre-install this separately. The runtime software "Belgian_Identity_Card_Run-time" is available for free to download on: [1]

Once you've installed the middleware, open the "myFMbutler eID Installer." • Windows The plug-in will be installed in: C: \ Documents and Settings \ [user] \ Local Settings \ Application Data \ FileMaker \ Extensions (Windows XP) C: \ Users \ [user] \ Local Settings \ Application Data \ FileMaker \Extensions (Windows Vista / 7) The "eID" folder, which contains the instructions and example files, is installed in the Documents folder of the user.

A shortcut to this folder is installed on the desktop.

• Mac OS X The installer copies the plug-in to the following path: ~ / Library / Application Support / FileMaker / Extensions / The documentation and sample files are located in the home directory of the user: ~ / Documents / myFMbutler / eID & SIS /

In order to remove the plugin, quit FileMaker and remove the plugin file from the Extensions folder.

[edit] Example Files

We have supplied several example files:

The Installer example show you how to include a plugin verification on startup and install the plugin if needed. It also features an example of an entire eID card reading script.

The Dialog activated example demonstrates the behaviour of the plugin where the eID middleware ask for authorisation at each reading.

The Dialog Suppressed example demonstrates the behaviour of the plugin where the eID middleware no longer asks for authorisation at each reading.

The Specific example provides you with some examples of how to retrieve only some specific data from the eID card.

Personal tools