FileMaker Server Guide to Updating Plug-ins

More documents

Recommendations

Info

12 FileMaker Server Guide to Updating Plug-ins 4. Write a script that uses the YourPlugIn_Version function to check the version of the plug-in on the client computer and place version information in the global field named Local_Version in your Auto Update layout. For script syntax, see the Local Plug-in Check script in the AutoUpdatePlugin.fp7 sample file. Information about the YourPlugIn_Version function should be included in the third-party plug-in documentation. 5. Write a script that uses the FMSAUC_FindPlugIn function to check the version of the plug-in on the server computer and place version information in the global field named Remote_Version in your Auto Update layout. For script syntax, see the Remote Plug-in Check script in the AutoUpdatePlugin.fp7 sample file. For information about the FMSAUC_FindPlugIn function, see “FMSAUC_ FindPlugIn” on page 13. 6. Write a script that converts version information to number format and places the result in additional global fields in your Auto Update layout. This conversion to number format is required for a comparison of the plug-in version information collected from the client and server computers. For script syntax, see the Get Version Numbers script in the AutoUpdatePlugin.fp7 sample file. For information about the GetAsNumber function, see the FileMaker Pro Help. 7. Write a script to download the plug-in from the server computer, if the version on the client computer doesn’t exist or is outdated. For script syntax, see the Download Plug-In script in the AutoUpdatePlugin.fp7 sample file. For information about the FMSAUC_UpdatePlugIn function, see “FMSAUC_UpdatePlugIn” on page 13. 8. Write a “parent” script to: 1 make sure the Auto Update plug-in exists and is enabled on the client computer 1 run the individual version checking and downloading scripts you wrote earlier For script syntax, see the Run Plug-in Scripts script in the AutoUpdatePlugin.fp7 sample file. For information about the FMSAUC_Version function, see “FMSAUC_Version” on this page. External functions Auto Update consists of the following external functions. Note These functions are available in FileMaker Pro only if the Auto Update plug-in is installed on your computer and enabled in the Plug-ins tab of Preferences. This function Does this FMSAUC_Version Returns the name and version of the Auto Update plug-in that exists in the current user’s FileMaker Extensions folder on the client computer. If no version is returned, FileMaker Pro assumes that the plug-in is missing or isn’t enabled on the client computer. FMSAUC_FindPlugIn Returns a string listing the plug-in versions located in the AutoUpdate folder or the default database folder on the server computer. If no string is returned, FileMaker Pro assumes that the plug-in doesn’t exist on the server computer. FMSAUC_UpdatePlugIn Downloads a plug-in file from the AutoUpdate folder or the default database folder on the server computer or returns an error code if the file can’t be downloaded.
FMSAUC_Version Format FMSAUC_Version() Parameters Constant integer; 0 Data type returned Text Chapter 1 | External functions 13 Description This function returns the name and version string from the Auto Update plug-in located in the current user’s FileMaker Extensions folder on the client computer. If no string is found, FileMaker Pro assumes the Auto Update plug-in is missing or isn’t enabled on the client computer. Example FMSAUC_Version(0) FMSAUC_ FindPlugIn Format FMSAUC_FindPlugIn("plug-in-name") Parameters plug-in-name – the name of the plug-in file. The parameter must be enclosed in quotes. Data type returned Text Description This function returns a string listing the plug-in versions located in the FileMaker Server AutoUpdate folder or the default database folder. If the plugin can’t be found, the function returns –1 (negative 1). FileMaker Server looks for the plug-in in two places. First, it searches the AutoUpdate folder located in the same folder that contains the hosted database. If the file is not found there, it searches for an AutoUpdate folder located in the FileMaker Server default database folder. Example The following example shows how to specify the external function FMSAUC_FindPlugIn within a Set Field script step. The Set Field script step allows you to return the result of a calculation in a single field. For more information about script steps and FileMaker Pro functions, see FileMaker Pro Help. FMSAUC_UpdatePlugIn Set Field [dbname::Remote_Version; FMSAUC_FindPlugIn("SamplePlugIn")] This example returns versions in the following format: 1.0 1.2 1.5 2.0 3.3... Format FMSAUC_UpdatePlugIn("plug-in-name version") Parameters plug-in-name version – the name of the plug-in or support file that you want to download and the plug-in version number. The parameter must be enclosed in quotes. Data type returned Text Note There must be a space between the plug-in name and the version number.
Page 1 and 2: FileMaker® Server 10 Guide to Upda
Page 3 and 4: Chapter 1 Updating plug-ins Content
Page 5 and 6: Chapter 1 Updating plug-ins This gu
Page 7 and 8: How automatic downloading works Aut
Page 9 and 10: Chapter 1 | Preparing Mac OS plug-i
Page 11: To change the permissions for plug-

FileMaker Server Guide to Updating Plug-ins

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?