Plug-Ins 101

From 360Works Product Documentation Wiki
(Difference between revisions)
Jump to: navigation, search
(WebDirect Install (FMS 13))
(Creating Scripts, Calling Functions, and Setting Variables)
(28 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Overview==
+
This is a guide is for FileMaker users and developers who are new to using plug-ins with FileMaker Pro and FileMaker Server. It explains concepts that are applicable to all 360Works plug-ins, and to many FileMaker plug-ins in general. If you are using plugins that were released prior to May 2017 please see [[Legacy Plugins 101 | this page]].
===Intended audience===
+
[[File:PluginDialog.png|right|thumb|400px|The FileMaker Plug-In dialog showing three 360Works plug-ins, with one disabled]]
This guide is intended for FileMaker users and developers who are new to using plug-ins with FileMaker Pro and FileMaker Server. It explains concepts that are applicable to all 360Works plug-ins.  
+
  
 +
==What is a plug-in?==
  
===What is a plug-in?===
+
A plug-in is a file that can be installed to add new functionality to FileMaker. Plug-ins do not stand alone, and are instead only used to extend FileMaker's capabilities. A plug-in's functionality can range from improving FileMaker's ability to send emails to allowing FileMaker to run custom Groovy code at will. By allowing developers to expand the functionality of FileMaker without changing its core structure, plug-ins ensure that FileMaker maintains its broad user group while meeting very specific needs. Without plug-ins, users would need to purchase additional stand-alone software that may not interface with existing FileMaker databases.  By utilizing FileMaker's standard functions to perform non-standard tasks, plug-ins help ensure that your information is accessible, organized, and integrated.
A plug-in is a file that can be installed to add new functions to the calculation dialog in FileMaker. In general, plug-ins do NOT add new script steps or change the overall behavior of FileMaker Pro. They do nothing by themselves, they are only useful when installed some place where they can be accessed by FileMaker.
+
  
 
 
'''Advantages of Plug-ins over….'''
 
 
Plug-ins are the solutions to specific user needs not available in Filemaker's standard features.  By allowing developers to expand the functionality of FileMaker without changing its core structure, plug-ins ensure that FileMaker maintains its broad user group while meeting very specific needs.  Without plug-ins, users would need to purchase additional stand-alone software that may not interface with existing FileMaker databases.  By utilizing FileMaker's standard functions to perform non-standard tasks, plug-ins help ensure that your information is accessible, organized, and integrated.
 
 
 
==Getting Started with Plug-Ins==
 
==Getting Started with Plug-Ins==
 
===Plug-in Installation===
 
===Plug-in Installation===
(FileMaker documentation:[http://help.filemaker.com/app/answers/detail/a_id/10097/~/installing-and-updating-plug-ins-in-filemaker-pro])
 
  
[[Plugin installation|Plug-in Installation File Locations]]
+
Refer to our [[Plug-In Installation]] page.
  
 +
(For further reference, check FileMaker's official [http://help.filemaker.com/app/answers/detail/a_id/10097/~/installing-and-updating-plug-ins-in-filemaker-pro plug-in installation docs])
  
'''Note:''' 360 Works plug-ins require Java in order to run. FileMaker Pro will prompt you on startup to download the appropriate software if it is not found on your computer. But FileMaker Server has no such prompt, and you may be required to manually download a Java Runtime (JRE) if you do not already have one.
+
===Licensing===
On Windows, you will need a current version of Java, [http://www.oracle.com/technetwork/java/javase/downloads/index.html Oracle downloads].
+
On Mac, you will need the latest Java 6 update from Apple. For Mac OS 10.6, [http://support.apple.com/kb/dl1573 click here]. For Mac OS 10.7-10.10, [https://support.apple.com/kb/dl1572 click here], For OS X 10.11, [https://support.apple.com/kb/DL1824?locale=en_US El Capitan click here]
+
  
 
+
Please refer to our [[Plug-In Licensing]] page.
Installing your 360Works plug-in is very straightforward, although there are differences between installing on a client machine using FileMaker Pro, a server using FileMaker Server, or on the FileMaker Server Web Publishing Engine.
+
+
===Client Install===
+
Open the .zip file from your plug-in download.  Locate the appropriate plugin for your operating system inside the MAC or WIN folder.  Drag the plugin to your FileMaker Extensions Folder.
+
+
===Server Install===
+
When installing a plug-in on FileMaker Server, follow a similar process.  Drag the appropriate extension to FileMaker Server/Database Server/Extensions.
+
+
===WPE Install===
+
Install plug-ins on the Web Publishing Engine in order to access them from Instant Web Publishing. Installation is similar: drag the appropriate plugin to FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins.  If the Plug-ins folder does not exist, create one.
+
NOTE: The Extensions folder is NOT the same as the Plugins folder in this situation.
+
 
+
===CWP Install===
+
If you are going to use Custom Web Publishing instead of Instant Web Publishing then install the plugin to FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins. Again, you may need to create the Plugins folder.
+
 
+
===WebDirect Install (FMS 13+)===
+
Install plug-ins for use with WebDirect by dragging the appropriate plugin to <code>FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins</code>
+
 
+
===AutoUpdate===
+
If you have a plug-in that needs to be installed on multiple client machines accessing FileMaker Server, you can use the Auto Update function to streamline the process.  For more information on the process, visit fmp7://autoupdate.360works.com/AutoUpdate360Works.
+
 
+
===FileMaker 12 Installation Options===
+
New in FileMaker 12, you can install and update plug-ins from container fields. Simple insert the plug-in into a container field, and call the Install Plug-in File script step. This makes it possible to deploy your solution with a plug-in bundled in that installs and registers itself with a script. You can then call the function Get (InstalledFMPlugins) to see the display name, version, and state. This new script step will install plug-ins to:
+
 
+
Windows XP: \Documents and Settings\[User Name]\Local Settings\Application Data\FileMaker\Extensions
+
 
+
Windows Vista / 7: \users\[User Name]\AppData\Local\FileMaker\Extensions

+
 
+
Mac OS: /Users/[User Name]/Library/Application Support/FileMaker/Extensions
+
 
+
Plug-ins found in the old location will continue to work and are overridden by plugins installed in the new location.
+
 
+
===Demo copies and Registration===
+
Each 360Works plug-in is available as a demo version that allows users to evaluate a plug-in.  These demonstration copies will generally have limitations on their use such as an expiration date, a time-out timer (typically 2 hours), or limited access to functions.
+
+
Registering your plug-in gives you full access to the plug-in’s functions.  When you purchase a plug-in from 360Works, you will be given a license key to register your product.
+
+
Plug-ins need to be registered in the location that they will be used, whether FileMaker Pro, FileMaker Server, and FileMaker Server Web Publishing.
+
+
If you are using the plug-in in FileMaker Pro, you can register your plug-in using FileMaker’s menu.  Just select FileMaker Preferences > Plug-ins > Select Plug-in > Configure.  Enter the registration name and license key in the fields provided.  This information is case sensitive, so be sure to copy directly from your confirmation email.
+
 
+
[[File:plugins1013.png]]
+
 
+
+
If you are using the plug-in as part of a network, where multiple users will be connecting to your database and accessing the plug-in, or registering the plug-in with FileMaker Server or FileMaker Server Web Publishing, you’ll need to register the plug-in using a script.  We recommend putting this in your database startup script, so that the plug-in will always be registered when new users connect to your database.
+
+
 
+
To create the script, open your database and select Scripts > Manage Scripts.  This will launch the scripts manager.
+
 
+
 
+
[[File:plugins1015.png]]
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
+
Click “New” in the lower left corner.  Name the script in the Script Name Field, then double-click “Set Variable” from the menu on the left.  Now click “Specify” in the lower right.  This will allow you to define the script’s process.  In the Name field, enter $register.
+
 
+
 
+
[[File:plugins1017.png]]
+
 
+
 
+
 
+
Click the “Specify” button beside the Value field to bring up the Calculation editor.  This is where you can access the plug-in features.  In the drop-down menu beside “View” in the upper right, select External Functions.  The external functions view is where you can access your plug-in’s capabilities.
+
 
+
 
+
[[File:plugins1019.png]]
+
 
+
 
+
+
+
For this script, double click the pluginRegister( key ; registeredTo ) function, where plugin is the name of your plug-in.  This moves the function to the function editor window, where you can replace “key” with your license key and “registeredTo” with the registration name from your invoice. Click OK in the calculation window and OK in the “Set Variable” option window, then click Save when prompted.
+
 
+
 
+
[[File:plugins10111.png]]
+
 
+
 
+
 
+
 
+
 
+
+
You’ve now created a registration script to run on startup when your database loads.  This ensures that the plug-in is registered across FileMaker Pro, FileMaker Server, and FileMaker Server Web Publishing, as well as on any client computers who access your database.  This is also the process you will use to call other plug-in functions when building your scripts.
+
  
 
===Using Plug-ins===
 
===Using Plug-ins===
Line 119: Line 23:
 
===Creating Scripts, Calling Functions, and Setting Variables===
 
===Creating Scripts, Calling Functions, and Setting Variables===
  
Scripts are commands that cause FileMaker to perform specific tasks.  They can be simple or complex, made of variable script steps.  Script steps are generally composed of a Function, which defines the action that the script performs, and Variables, which define the parameters of the action.  As plug-ins are used within FileMaker, you can use scripts to control the actions of plugins.
+
Scripts are commands that cause FileMaker to perform specific tasks.  They can be simple or complex, made of variable script steps.  Script steps are generally composed of a Function, which defines the action that the script performs, and Variables, which define the parameters of the action.  As plug-ins are used within FileMaker, you can use scripts to control the actions of plugins.  
 
   
 
   
To create a script, open the script manager from the menu bar of your FileMaker database. This opens the script manager, where you can create new scripts or edit existing ones using the buttons in the lower left. These buttons open the script editor, which show all of the steps in a script.  On the left is a list of all possible scripts. These scripts define how the script will perform an action. Double clicking any of these will add the step to your script.  To further define the function and parameters of the script, select a script step in the editor window, then click the “Specify” button.
+
To create a script, open the script manager from the menu bar of your FileMaker database. This opens the script manager, where you can create new scripts or edit existing ones. To create a script, click the "+" in the upper left corner. To edit an existing script, click on it in the list of scripts on the left and then start editing it. To add a script step to the a script, double click it and it will add the step to your script. You can also just start typing the name of the script step or use its type-ahead designation. Available script steps are listed on the right of the script workspaceIn FileMaker 16, plugin functions will be listed here ( highlighted in red in the image below). You can also call plugin functions by setting the plugin function as the value of the variable. That option is detailed on [[Legacy_Plugins_101#Creating_Scripts.2C_Calling_Functions.2C_and_Setting_Variables | this]] page.  Either option is completely viable but it will be up to you to decide when either option is appropriate. To further define the parameters of the script step, click the options button next to the script step. This will open a drop down menu where you can specify  the value of the parameters as well as a few other options ( see image below).
  
  
[[File:plugins10113.png]]
+
[[File:ScriptWorkspace16.png | 700px]]
  
  
 
   
 
   
+
Click "Specify" next to the parameters to give them a value. This will open a calculation dialogue. Give the parameter the appropriate value and click ok. You can also set a field or a variable to the return value of the function by checking the "Results" checkbox (see screen shot below)
This brings you to the Specify Calculation window. On the left will be a list of all functions accessible to FileMaker. These functions provide the actions that your script will perform.  '''To access the Functions associated with Plug-ins, select “External Functions” in the View drop-down'''. Adding a function to a script step is known as “calling” that function.
+
+
  
The second part of a script step is known as a variable.  This tells the script where to perform the function, and gives the authorization to access this location. Variables are set in the parentheses behind the function in the Specify Calculation window.
+
[[File:ResultsWindow.png | 400px]]
 
+
 
+
[[File:plugins10114.png]]
+
 
+
 
+
 
+
 
+
 
+
Entering this information is known as setting a variable.  This process will allow you to write a script calling a specific function with set variables.
+
  
 +
<b>Note:</b> It is a common mistake that installing a plugin in FileMaker Server will give you access to the plugin's functions in the FileMaker Pro script workspace in a hosted solution. This is not the case. In order to write scripts that will be executed server side, you will need to install the plugin for FileMaker Pro. It can be removed once the scripts have been written. It is also a common mistake that when installing the plugin on FMS, that any script call made from a hosted solution will be executed with the plugin installed on FMS. This is not the case unless your script is being called using the Perform Script on Server script step. Any other script call made from FileMaker Pro in any solution, hosted or not, will execute on the local machine and will require the plugin to be installed there.
  
 
===Error Handling/Reporting===
 
===Error Handling/Reporting===
<p>When something unexpected happens, the plug-in will pop up a dialog showing what the error message is. This makes it easy to see what went wrong. However, in some cases, you (the developer) may prefer to show your own message to the user, or possibly not show a message at all. In that case, you can call <code><<setErrorCaptureFunctionName>></code> with a parameter of true. That will suppress the error dialog from appearing to the user.</p>
+
When calling plugin functions as script steps, you will handle errors in the same manner you would any other FileMaker script step. Please see the FileMaker documentation for how to handle errors appropriately. Generally, if there is an error, our plugins will return an error code of 1552 when Get(LastError) is called. However, some plugin functions will return different error codes. If a function can return an error code other than a 1552, it will be documented with the description of the function below. In addition to the error code, you can also get the description of the error by calling Get(LastExternalErrorDetail)
  
<p>Whether or not you suppress the error dialogs, a plugin function will return the word <code>ERROR</code> if something goes wrong. It's a good idea to put your plugin functions in an 'If' statement so that you don't execute a bunch of script steps after something has gone wrong. If you'd like for your script to get the error message, you can get that by calling the <code><<lastErrorFunctionName>></code> function.</p>
+
You can also call our functions in a calculation dialog. In this case, error handling is done differently. If you decide to call plugin functions in a calculation dialog and you want to capture errors, see this page page for instruction on how to do so
  
<p>Here is an example of basic error reporting:</p>
+
You can also call our functions in a calculation dialog. In this case, error handling is done differently. If you decide to call plugin functions in a calculation dialog and you want to capture errors, see [http://docs.360works.com/index.php/Error_handling this page] for instruction on how to do so
 
+
<pre>
+
Set Variable [ $result = MyPluginFunction("x" ; "y" ; "z") ]
+
If [ $result = "ERROR" ]
+
    Exit Script[ "Error occurred: " & <<lastErrorFunctionName>> ]
+
Else
+
    ... do more stuff here ...
+
End If
+
</pre>
+
 
+
====Chaining Multiple Functions Together====
+
<p>Since the string <code>"ERROR"</code> evaluates to false when evaluated by FileMaker, and most plugin functions return a <code>1</code> when successful, you can chain multiple dependent plugin operations together using the <code>"and"</code> operator.
+
However, in this case the result will be a <code>1</code> or a <code>0</code>, not <code>"ERROR"</code>. For example:</p>
+
<pre>
+
// chain multiple calls together
+
// if any of the functions fail, the calculation will
+
// short-circuit with a result of <code>false</code>,
+
// and none of the subsequent function calls will be evaluated.
+
Set Variable [ $success =
+
&nbsp;&nbsp;&nbsp;&nbsp;FirstPluginFunction("x") and
+
&nbsp;&nbsp;&nbsp;&nbsp;SecondPluginFunction("y") and
+
&nbsp;&nbsp;&nbsp;&nbsp;ThirdPluginFunction("z")
+
]
+
If [not $success]
+
&nbsp;&nbsp;&nbsp;&nbsp;Show Custom Dialog [ "An error occurred: " & <<lastErrorFunctionName>> ]
+
End If
+
</pre>
+
<p>Note: the above only works for plugin functions which return <code>1</code> on success!  Check the documentation for each function used in this manner.</p>
+
 
+
====Additional Error Checking - Plugin not installed====
+
<p>If a plugin is not installed correctly, calls to a plugin function will return "?".  As part of your startup script, you should check for this occurrence and display a warning accordingly that the plugin needs to be installed. Note: when treated as a boolean true/false value, FileMaker will treat <code>?</code> as <code>true</code>.</p>
+
  
 
==Troubleshooting/Common Plugin Issues==
 
==Troubleshooting/Common Plugin Issues==
 
===The plugin file is installed in the correct directory, but FileMaker doesn't load it===
 
 
Be sure the plugin file is not encrypted and not a hidden file. FileMaker will skip loading plugins that are hidden or encrypted.
 
 
==="?" failed to initialize===
 
 
This generally means there has been a mismatch with the version of Java you are using. 
 
 
This section focuses on FileMaker Pro and Pro Advanced, but the same rules apply to Server concerning 32 vs 64 bit.  To find out which version of the plugin you should be using, see the table here:<br />
 
[[Plugin_installation]]
 
 
====Mac====
 
 
For Mac users, you need the Apple maintained version of Java, available here:<br />
 
https://support.apple.com/kb/dl1572?locale=en_US
 
 
====Windows====
 
 
=====Pre-FileMaker Pro 14=====
 
 
All version of FileMaker Pro prior to 14 were 32 bit, follow the instructions below for 32-bit FileMaker 14
 
 
=====FileMaker Pro 14=====
 
For Windows users, things have gotten a little more complex with the release of FileMaker 14.  There is now a 32-bit ''and'' a 64-bit version of FileMaker 14.
 
 
You need to have the corresponding plugin, and version of Java.
 
 
=====For 32-bit FileMaker Pro 14=====
 
360Works Plugin.fmx (the extension is .fmx)<br />
 
32-bit version of Java, available here:<br />
 
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html<br />
 
Windows x86 is the one you want
 
 
=====For 64-bit FileMaker Pro 14=====
 
360Works Plugin.fmx64 (notice the extension is .fmx64)<br />
 
64-bit version of Java, available here:<br />
 
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html<br />
 
Windows x64 is the one you want
 
  
 
==Getting Help==
 
==Getting Help==
  
'''Individual Plug-in Support'''
+
===Individual Plug-in Support===
  
Many questions about 360Works plug-ins can be answered in one of two places: the plugin documentation or the product support wiki.  To access the documentation, you can either view the documentation.html file within the plugin folder, or visit http://www.360works.com/products. Choose your product from the left sidebar, then click the “View Documentation” button.
+
Many questions about 360Works plugins can be answered in one of two places: the plugin documentation or the product support wiki.  To access the documentation, you can either view the documentation.html file within the plugin folder, or visit http://www.360works.com/products. Choose your product from the left sidebar, then click the “View Documentation” button.
 
   
 
   
You can also check our [http://wo.360works.com/cgi-bin/support/productsupport.cgi/ Product Support Wiki] for answers to common plugin questions or visit the [http://fmforums.com/forums/forum/121-360-works/ FMForums 360Works section]. If your question doesn’t appear in the forums, create a new post and a support representative will respond.
+
You can also check our [http://docs.360works.com/index.php/Main_Page Product Support Wiki] for answers to common plugin questions or visit the [http://fmforums.com/forums/forum/121-360-works/ FMForums 360Works section]. If your question doesn’t appear in the forums, create a new post and a support representative will respond.
  
  
Line 236: Line 60:
  
  
'''Contacting 360Works'''
+
===Contacting 360Works===
  
 
Sometimes you may have questions that the documentation cannot answer.  You can contact 360Works support in a variety of ways.  Our office is open 10am – 6pm ET, and you can reach us at 770-234-9293.  
 
Sometimes you may have questions that the documentation cannot answer.  You can contact 360Works support in a variety of ways.  Our office is open 10am – 6pm ET, and you can reach us at 770-234-9293.  
 
   
 
   
You can also email us at any time at plugins@360works.com.
+
You can also email us at at support@360works.com.
+
  
'''Helping Us Help You'''
+
===Helping Us Help You===
  
 
When we provide support it is important for us to have the most accurate information available.  To do so, we may ask you for a few items that may be helpful. If possible, please have this information available when contacting 360Works Support.
 
When we provide support it is important for us to have the most accurate information available.  To do so, we may ask you for a few items that may be helpful. If possible, please have this information available when contacting 360Works Support.
 
   
 
   
  
'''Product Information'''
+
===Product Information===
  
 
The version and license of the plug-in you are using, the version of FileMaker Pro or FileMaker Server that you are using, and your operating system.
 
The version and license of the plug-in you are using, the version of FileMaker Pro or FileMaker Server that you are using, and your operating system.
Line 259: Line 82:
 
   
 
   
  
'''Bug Report'''
+
===Bug Report===
  
 
If a plug-in is malfunctioning, a bug report is immensely helpful to identify the problem. To generate a report, logout then log back in to FileMaker. Reproduce the issue and immediately go to FileMaker Pro Preferences > Plug-ins.  Select the plug-in, click “Configure” then click “Report a Bug”.  This will send a bug directly to our support team who will contact you to follow up.
 
If a plug-in is malfunctioning, a bug report is immensely helpful to identify the problem. To generate a report, logout then log back in to FileMaker. Reproduce the issue and immediately go to FileMaker Pro Preferences > Plug-ins.  Select the plug-in, click “Configure” then click “Report a Bug”.  This will send a bug directly to our support team who will contact you to follow up.
 
   
 
   
  
'''Getting Log Files'''
+
===Getting Log Files===
 
+
Log files help to tell us what is happening when a plug-in malfunctions.  If you are asked to provide a log file, you can do so easily by navigating to the correct location based on your operating system and FileMaker version.
+
+
 
+
''If using FileMaker Pro:''
+
 
+
OS X:
+
/Users/userName/Library/Logs/360Plugin Logs/360Plugins_XXXXX.log
+
+
 
+
Windows XP or S2003:
+
C:\Documents and Settings\<userName>\My Documents\360Plugin Logs\360Plugins_XXXXX.log
+
+
 
+
Windows Vista, 7, or S2008:
+
C:\Users\<userName>\Documents\360Plugin Logs\360Plugins_XXXXX.log
+
+
 
+
''If Using FileMaker Server:''
+
 
+
OSX:
+
/Library/FileMaker Server/Logs/360Plugin Logs/360Plugins_XXXXX.log
+
+
 
+
Windows XP or S2003:
+
C:\Documents and Settings\Default User\My Documents\360Plugin Logs\360Plugins_XXXXX.log
+
+
 
+
Vista:
+
C:\Users\Default User\Documents\360Plugin Logs\360Plugins_XXXXX.log
+
  
Windows 7, S2008:
+
See [http://docs.360works.com/index.php/Plugin_log_files this page] for log locations.
Windows 7/2008R2 (32 bit): C:\Windows\System32\config\systemprofile\360Works
+
Windows 7/2008R2 (64 bit): C:\Windows\SysWoW64\config\systemprofile\360Works
+

Revision as of 17:33, 21 February 2019

This is a guide is for FileMaker users and developers who are new to using plug-ins with FileMaker Pro and FileMaker Server. It explains concepts that are applicable to all 360Works plug-ins, and to many FileMaker plug-ins in general. If you are using plugins that were released prior to May 2017 please see this page.

The FileMaker Plug-In dialog showing three 360Works plug-ins, with one disabled

Contents

What is a plug-in?

A plug-in is a file that can be installed to add new functionality to FileMaker. Plug-ins do not stand alone, and are instead only used to extend FileMaker's capabilities. A plug-in's functionality can range from improving FileMaker's ability to send emails to allowing FileMaker to run custom Groovy code at will. By allowing developers to expand the functionality of FileMaker without changing its core structure, plug-ins ensure that FileMaker maintains its broad user group while meeting very specific needs. Without plug-ins, users would need to purchase additional stand-alone software that may not interface with existing FileMaker databases. By utilizing FileMaker's standard functions to perform non-standard tasks, plug-ins help ensure that your information is accessible, organized, and integrated.

Getting Started with Plug-Ins

Plug-in Installation

Refer to our Plug-In Installation page.

(For further reference, check FileMaker's official plug-in installation docs)

Licensing

Please refer to our Plug-In Licensing page.

Using Plug-ins

Think of plug-ins as the tools you need to build a specific solution within FileMaker. For example, purchasing 360Works’ Plastic plug-in will not give you an out of the box point of sale system. However, using the tools that Plastic provides and using FileMaker’s existing functions will allow you to build your system from the ground up.

Creating Scripts, Calling Functions, and Setting Variables

Scripts are commands that cause FileMaker to perform specific tasks. They can be simple or complex, made of variable script steps. Script steps are generally composed of a Function, which defines the action that the script performs, and Variables, which define the parameters of the action. As plug-ins are used within FileMaker, you can use scripts to control the actions of plugins.

To create a script, open the script manager from the menu bar of your FileMaker database. This opens the script manager, where you can create new scripts or edit existing ones. To create a script, click the "+" in the upper left corner. To edit an existing script, click on it in the list of scripts on the left and then start editing it. To add a script step to the a script, double click it and it will add the step to your script. You can also just start typing the name of the script step or use its type-ahead designation. Available script steps are listed on the right of the script workspace. In FileMaker 16, plugin functions will be listed here ( highlighted in red in the image below). You can also call plugin functions by setting the plugin function as the value of the variable. That option is detailed on this page. Either option is completely viable but it will be up to you to decide when either option is appropriate. To further define the parameters of the script step, click the options button next to the script step. This will open a drop down menu where you can specify the value of the parameters as well as a few other options ( see image below).


ScriptWorkspace16.png


Click "Specify" next to the parameters to give them a value. This will open a calculation dialogue. Give the parameter the appropriate value and click ok. You can also set a field or a variable to the return value of the function by checking the "Results" checkbox (see screen shot below)

ResultsWindow.png

Note: It is a common mistake that installing a plugin in FileMaker Server will give you access to the plugin's functions in the FileMaker Pro script workspace in a hosted solution. This is not the case. In order to write scripts that will be executed server side, you will need to install the plugin for FileMaker Pro. It can be removed once the scripts have been written. It is also a common mistake that when installing the plugin on FMS, that any script call made from a hosted solution will be executed with the plugin installed on FMS. This is not the case unless your script is being called using the Perform Script on Server script step. Any other script call made from FileMaker Pro in any solution, hosted or not, will execute on the local machine and will require the plugin to be installed there.

Error Handling/Reporting

When calling plugin functions as script steps, you will handle errors in the same manner you would any other FileMaker script step. Please see the FileMaker documentation for how to handle errors appropriately. Generally, if there is an error, our plugins will return an error code of 1552 when Get(LastError) is called. However, some plugin functions will return different error codes. If a function can return an error code other than a 1552, it will be documented with the description of the function below. In addition to the error code, you can also get the description of the error by calling Get(LastExternalErrorDetail)

You can also call our functions in a calculation dialog. In this case, error handling is done differently. If you decide to call plugin functions in a calculation dialog and you want to capture errors, see this page page for instruction on how to do so

You can also call our functions in a calculation dialog. In this case, error handling is done differently. If you decide to call plugin functions in a calculation dialog and you want to capture errors, see this page for instruction on how to do so

Troubleshooting/Common Plugin Issues

Getting Help

Individual Plug-in Support

Many questions about 360Works plugins can be answered in one of two places: the plugin documentation or the product support wiki. To access the documentation, you can either view the documentation.html file within the plugin folder, or visit http://www.360works.com/products. Choose your product from the left sidebar, then click the “View Documentation” button.

You can also check our Product Support Wiki for answers to common plugin questions or visit the FMForums 360Works section. If your question doesn’t appear in the forums, create a new post and a support representative will respond.


Plugins10116.png


Contacting 360Works

Sometimes you may have questions that the documentation cannot answer. You can contact 360Works support in a variety of ways. Our office is open 10am – 6pm ET, and you can reach us at 770-234-9293.

You can also email us at at support@360works.com.

Helping Us Help You

When we provide support it is important for us to have the most accurate information available. To do so, we may ask you for a few items that may be helpful. If possible, please have this information available when contacting 360Works Support.


Product Information

The version and license of the plug-in you are using, the version of FileMaker Pro or FileMaker Server that you are using, and your operating system.


Plugins10118.png


This shows the License Type (Enterprise License) and Version (1.56). Also notice the “Report a bug” button.


Bug Report

If a plug-in is malfunctioning, a bug report is immensely helpful to identify the problem. To generate a report, logout then log back in to FileMaker. Reproduce the issue and immediately go to FileMaker Pro Preferences > Plug-ins. Select the plug-in, click “Configure” then click “Report a Bug”. This will send a bug directly to our support team who will contact you to follow up.


Getting Log Files

See this page for log locations.

Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox