24U SimpleDialog Plug-In 6.0

This ReadMe file contains some important information about 24U SimpleDialog Plug-In, such as system requirements, installation guide, quick start, troubleshooting, license notice, contact information, and copyright statement.
 


Introduction

24U SimpleDialog Plug-In is a FileMaker® Pro plug-in. It allows your FileMaker Pro databases to display dialog boxes with text prompts, text fields, password fields, check boxes, radio buttons, pop-up menus and pictures based on real-time data from your database. You can use this plug-in to prompt user for required data input just the same way you are used to work with the built-in Show Custom Dialog script step. Starting with the version 2.0 you can also display progress dialogs to indicate work progress to user.


       

System requirements

System requirements:

Mac

Recommended: Any Intel Mac, 4096 MB RAM, macOS High Sierra 10.13 or newer, FileMaker Pro 16 Advanced or newer.

Minimum: Any Intel Mac since 2008, 2048 MB RAM, Mac OS X 10.10 Yosemite, FileMaker Pro 14..

Windows

Recommended: Dual Core 1.6 GHz processor, 4096 MB RAM, Windows 10 or newer, FileMaker Pro 16 Advanced or newer.

Minimum: 1 GHz processor, 2048 MB RAM, Windows 7, FileMaker Pro 14.

iOS

Installation for FileMaker Pro

To install 24U SimpleDialog Plug-In, follow these steps:

  1. If you did not do this yet, download and open the 24U SimpleDialog Plug-In distribution archive
  2. To install the plug-in, copy its binary file into Extensions directory. If you are not sure where the binary should be placed, see UsingFMPlugIns.html
  3. Restart or start the FileMaker Pro
  4. The plug-in should be visible in the "Plug-Ins" preference pane inside FileMaker Pro preferences (Mac OS X) / Edit -> Preferences (Windows)

Installation into FileMaker iOS App SDK

The iOS App SDK allows you to build a standalone iOS app from your FileMaker solution
Users can access your FileMaker solution on iPad and iPhone similar to other iOS apps without having to install FileMaker Go

To install 24U SimpleDialog Plug-In, follow these steps:

  1. Create iOS Project using FileMaker iOSAppSDK by following instructions on FileMaker support website
  2. Add Swift support to created project:
    • Open created iOS Project ( <projectPath>/<appName>.xcodeproj )
    • Add new file: File -> New -> File... (or cmd + N )
    • Choose "Swift File" from iOS section
    • You can name it "SwiftHelper.swift" or similarly and store it under project directory
    • When prompted "Would you like to configure an Objective-C bridging header?" choose "Create Bridging Header"
  3. Update Info.plist:
    • Open created iOS Project ( <projectPath>/<appName>.xcodeproj )
    • Find project's Info.plist in Project Navigator ( "Custom Application Resources" -> "Info.plist" )
    • Right click Info.plist and choose "Open As" -> "Source Code"
    • Paste this snippet on end of line 5:
      <key>UISupportedExternalAccessoryProtocols</key>
      <array>
      	<string>com.custom.printeralt</string>
      	<string>com.custom.printer</string>
      	<string>com.custom.my3alt</string>
      	<string>com.custom.my3</string>
      	<string>com.custom.donglealt</string>
      	<string>com.custom.dongle</string>
      	<string>it.caenrfid.protocol</string>
      	<string>com.datecs.linea.pro.msr</string>
      	<string>com.datecs.linea.pro.bar</string>
      </array>
      <key>NFCReaderUsageDescription</key>
      <string>NFC Reading</string>
                
  4. Install 24U SimpleDialog Plug-In:
    • Copy SimpleDialog.fmplugin into <projectPath>/<appName>/Plug-Ins/ folder
    • If you want to test 24U SimpleDialog Plug-In on iOS Simulator copy SimpleDialogSimulator.fmplugin into <projectPath>/<appName>/Plug-Ins folder
  5. Get license for 24U SimpleDialog Plug-In:
    • Buy iOS license from 24U SimpleDialog Plug-In website
    • Inside Bundle ID text field, insert Bundle ID of your created iOS project (be careful: The license is bound to the this Bundle ID)
    • After successful payment, you will receive serial number (SN)
  6. Register 24U SimpleDialog Plug-In with your SN:
    • Inside your FileMaker solution use SDialog_Register plugin function with SN given as first parameter

Quick Start

Consult plugin documentation for more information: SimpleDialogSyntax.html

If you are new to FileMaker plug-ins, start by checking the UsingFMPlugIns.html file inside the Documentation folder. It briefly explains what plug-ins are, why they are useful, and how they are usually used

To learn how to use this plug-in it is recommended to open the SimpleDialogTutorial.fmp12 tutorial from Documentation folder

Troubleshooting

Before you contact our technical support regarding problems or difficulties using 24U SimpleDialog Plug-In, please check if your issue is not listed below:

macOS and Windows

Italic font style does not work on Mac OS X
Standard Mac OS X dialog font does not support italic style. You must explicitly define text font which supports italic style using TextFont function.

Initialization error: Duplicate plug-in binary on Mac OS X
24U SimpleDialog Plug-In 3.x used incompatible indexing for field "menu". Menu indexing has been 0-based (0 first line, 1 second line...) in version 3.x. This has been changed in version 4.0 to 1-based indexing (1 first line, 2 second line...). Solutions which used 0-based indexing must be changed to 1-based indexing. The only compatible number is 0 - it means the first line in both cases.
In 3.x the menu also supported line separators (character "-" placed alone in single line) but separators had indexes. In 4.0 menu separators are not counted to indexing. For example SDialog_Get function will return the same index regardless how many separators you add or remove from the menu.

SDialog_InputDialog returns a non-zero number as its result
If some SimpleDialog function fails, it will return a non-zero error code as its result. This can be caused by a system error, but more likely the reason will be an incorrectly specified dialog definition.
There is short list of possible error codes:

Plug-In is not visible in the FileMaker Pro
Check if the plug-in binary is present in the one of "Extensions" folders of the FileMaker Pro.

All plug-in functions return an "?" as a result
The 24U SimpleDialog Plug-In is probably not installed or deactivated in your application preferences. Open the Application Preferences from the Edit menu, click on the "Plug-Ins" tab, and make sure that 24U SimpleDialog Plug-In is there and that it is enabled.

iOS

SDialog_InputDialog returns a non-zero number as its result
If some SimpleDialog function fails, it will return a non-zero error code as its result. This can be caused by a system error, but more likely the reason will be an incorrectly specified dialog definition.
There is short list of possible error codes:

All plug-in functions return an "?" as a result

Dialogs are resizing incorrectly after device rotation and application freezes when dialogs are displayed

If your problem is not listed above or if the recommended solution does not work for you, please contact our technical support at http://www.24uSoftware.com/support.php for assistance.

Shareware Notice

Please note that 24U SimpleDialog Plug-In product is SHAREWARE. That means it is not free and you have to pay a license fee if you want to keep it. You can install 24U SimpleDialog Plug-In and try it out for the period of 14 days. After this period, 24U SimpleDialog Plug-In can stop working and require a registration code. You will get your registration code after you pay for your license.

You can freely distribute 24U SimpleDialog Plug-In as long as you distribute the original compacted archive untouched and you don't charge money for the distribution. If you want to distribute 24U SimpleDialog Plug-In on a physical medium, such as CD-ROM, or if you want to distribute it in other form than the original compacted archive, you must ask for our permission. If you are a solution developer and want to bundle 24U SimpleDialog Plug-In with your products please contact 24U Software.

Please find detailed registration instructions in the file named "HowToRegister.html".

iOS license Notice

iOS version of 24U SimpleDialog Plug-In is licensed seperately and differenty from desktop version, please read more in "HowToRegister.html".

You can find detailed license terms in the file named "24U Software License Agreement.pdf". Individual license types are described in the file named "HowToRegister.html".

Contact Information

You can contact us at one of the following addresses. We prefer being contacted via e-mail, but you can use any other method if e-mail is not good enough for you.

E-mail:   info@24uSoftware.com   general information about our products and our company
eval@24uSoftware.com free evaluation codes registration
sales@24uSoftware.com paid licenses ordering and registration
support@24uSoftware.com technical support and bug reports
 
WWW: http://www.24uSoftware.com/
 
Phone: +420-224 910 892
Fax: +420-242 487 778
 
Snail mail: 24U Software
Skochovická 88
252 45  Zvole u Prahy
Czech Republic


24U Software
The software 24U SimpleDialog Plug-In is copyright ©2001-2019 24U Software. All rights reserved.
Portions of the software are © 1984-2019 FileMaker, Inc. All rights reserved