02. Setup [7:22]

Description: This video explains the following:

  1.  How to manually install (FileMaker 11 or earlier) and register the Change Printer plug-in on a Windows machine.
  2.  How to manually install (FileMaker 11 or earlier) and register the Change Printer plug-in on a Mac machine.
  3.  Where to access the external plug-in functions.
  4.  How to create a plug-in checker script and hard code the registration process in FileMaker.

Transcript:

Let’s take a look at the basic setup of the Change Printer Plug-in. This video will address these four areas. How to install and register the plug-in on a Windows machine. How to install and register the plug-in on a Mac machine. Where to find all available external plug-in functions. And how to create a plug-in checker script and hard code the registration process.

0:31 Windows plug-in installation and registration: In order to manually install the Change Printer Plug-in to work on a Windows machine, you will first need to download the plug-in bundle from our site which will look something like this. Since the bundle is zipped up for protection, the next step is to unzip or extract the contents of the bundle. This can be done by either right clicking on the zip file and selecting Extract All or by double clicking on the file and selecting Extract All Files. This is an important and necessary step on a Windows machine. With FileMaker closed I will copy the actual plug-in and paste the plug-in into the FileMaker Extensions folder located here. You have now successfully installed the plug-in, so let’s register.

1:30 This plug-in splash screen will disappear once we have registered a licensed copy of the plug-in. You have the option to manually register the plug-in from the demo file provided or your developer can hard code the registration process in your solution, which will be discussed later in this video. For demonstration purposes let’s begin FileMaker. Open the FileMaker demo file that came with the plug-in and manually register. Here I can see the plug-in operating mode and plug-in version installed. Currently I am running in unregistered mode. To manually register, simply enter your license ID or use the demo license provided and select the “Register the Plug-in” button. If running in demo mode, please be mindful of the demo limitations and timeouts.

2:20 Next let’s demonstrate how you install and register the plug-in on a Mac machine. Download the plug-in bundle from our website, which will look like this. Ensure that FileMaker is closed, copy the actual plug-in and paste the plug-in into the FileMaker Extensions folder located here. You have now successfully installed the plug-in. Let’s begin registration.

2:52 Let’s begin by opening FileMaker and opening the demo file that came with the plug-in so we can manually register. This plug-in splash screen will disappear once we have registered a license plug-in version. Here I can see that my machine is running in unregistered mode. Simply enter your license ID or use the demo license and select the Register the Plug-in button. Remember, your developer can also hardcode the registration process in your solution which will be discussed later in this video.

3:27 Now let’s take a look at all External Change Printer Plug-in functions that are made available by our plug-in. Since I have FileMaker Pro Advanced installed, I can utilize various additional development tools. I recommend that all developers obtain a copy of FileMaker Pro Advanced to aid and assist during the development process. Let’s open the data viewer, navigate to Watch and select Add Expression here. In the upper right hand corner from the drop down list, I will choose External functions. Here I will find a list of all available external plug-in functions. All functions are prefixed with their unique function header. For example; we can see that all Change Printer Plug-in functions are neatly organized beneath the plug-in name and all begin with PCCP_ as shown here. The naming convention of the plug-in functions is determined by the plug-in manufacturer. Now that I have the plug-in installed and registered, I can use these additional functions made available by the plug-in. For detailed descriptions of each plug-in function, please refer to the plug-in documentation provided by Productive Computing.

4:45 Lastly let’s discuss the Plug-in Checker Script. This script ensures that the plug-in has been properly installed and registered before attempting to use any of the other plug-in functions. This script can be created in less than 10 minutes and is recommended in a multi-user environment in order to alleviate any user frustration or error. The three functions used to create this script are: PCCP_Version, which determines if the plug-in has been properly installed; PCCP_GetOperatingMode, which determines what mode the plug-in is in and PCCP_Register, which registers the plug-in behind the scenes if needed. Let’s look at these FileMaker script steps now. First let’s check to see if the plug-in is installed by calling the Version function. This version function will return empty results or a question mark if the plug-in is not installed. We can show a custom dialogue if the plug-in is not installed alerting the user, and it might even be a good idea to go back to the main setup layout and help the script. Next let’s check to see if the plug-in has been properly registered by determining the operating mode. If the GetOperatingMode function does not equal live, then we will call the register function, hard code the four parameters including your license ID and register the plug-in behind the scenes. If the registration result does not equal zero/0, then we can display a dialogue that the plug-in registration failed, alerting the user and halting the script. Once you have created the appropriate plug-in checker script, you can now simply add this script step at the beginning of any script using the plug-in functions. There are various ways you can implement and write a plug-in checker script: the Version, GetOperatingMode and Register functions are explained in further detail in the plug-in documentation.

6:44 This is just one example to get your creative juices flowing. Now we can begin to integrate the plug-in into your FileMaker solution. Please make sure you utilize all available tools provided such as: additional training videos, documentation and reverse engineer our demo file. If you need additional assistance, you can contact us via email, phone or browse our forum for answers. We are happy to assist you with any integration steps or even design a solution for you. Thank you for watching and Happy FileMaking!