GoZync4
Integration 3 Of 4
GoZync4.Integration3Of4 History
Hide minor edits - Show changes to markup
Changed line 13 from:
If you don't have FileMaker Advanced, and can't copy and paste tables, we're happy to do this step for you. Send your mobile file to [email protected] or if it's too big to email.
to:
If you don't have FileMaker Advanced, and can't copy and paste tables, we're happy to do this step for you. Send your mobile file to [email protected] or get in touch if it's too big to email.
Changed line 13 from:
If you don't have FileMaker Advanced, and can't copy and paste tables, you can import the gz table into your file; starting in your mobile file, click "import" in the lower right of the Tables tab of File / Manage / Database.
to:
If you don't have FileMaker Advanced, and can't copy and paste tables, we're happy to do this step for you. Send your mobile file to [email protected] or if it's too big to email.
Changed line 50 from:
- Be sure that the example file you're copying from is in the same folder as your mobile file and GoZyncMobile.fmp12
to:
Be sure that the example file you're copying from is in the same folder as your mobile file and GoZyncMobile.fmp12
Changed lines 35-36 from:
to:
gz_LatestAction gz_TimeStampZynced
Added lines 56-60:
Note that the script "Zync It - This Table..." will be one of your go-to scripts for sync. You can call it without a script parameter if the Table Occurrence (TO) name of the layout you call it from matched the name of one of your sync TOs in GoZyncMobile (without the gz... prefix). Otherwise pass in the TO name from GoZyncMobile as a script parameter. Example:
Your TO in GoZyncMobile is "gzm_Contact" but the layout in your mobile file is based on a TO named "People". Call the script "Zync It - This Table..." passing in a parameter of "Contact". You wouldn't need a parameter if the layout in your mobile file were based on a TO named "Contact".
Changed lines 88-89 from:
Check you work
to:
Check your work
Deleted line 43:
Changed lines 58-59 from:
There is one script to edit in GoZyncMobile. Learn what needs to be changed here:
to:
Changed lines 57-58 from:
to:
Step 3.4: Edit the Go To Related Records Script in GoZyncMobile
There is one script to edit in GoZyncMobile. Learn what needs to be changed here:
Step 3.5: UUIDs
Changed lines 85-91 from:
Checking Your Work
Scan and Validate
Click "Refresh..." at the bottom of the screen to check your work..
to:
Check you work
Head over to GoZyncHosted and visit the Configuration tab again: click "refresh" and see if your fields check out. If they don't, click on the caution icon beside them to see what's wrong.
Now click on the checkbox area in the "more" column: if you've done everything there click "done".
Next...
Move on to the next step.
Changed lines 7-8 from:
Step 6.1: Adding a new table to your mobile file
to:
Step 3.1: Adding a new table to your mobile file
Changed lines 15-16 from:
Step 6.2: Add required fields
to:
Step 3.2: Add required fields
Changed lines 21-22 from:
If you don't have Advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any). Or get in touch and we can wire this up for you.
to:
If you don't have Advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any). Or get in touch; we offer implementation packages to wire this up for you.
Deleted lines 39-40:
NOTE: A table in your mobile file that will only be synced as related records *technically* only needs the "gz_ModTimeStamp" field. But for simplicity and flexibility, we advise that you add all four fields into every table in your mobile file that you want to sync.
Changed lines 42-49 from:
A note about field names.
The following characters are prohibited in field names when syncing: #, !, •, ., / Please remove them from any field names in your synced tables. Also make sure no field names contain the word "and".
Step 6.3: Required Scripts (Mobile file only)
to:
Step 3.3: Required Scripts (Mobile file only)
Changed lines 57-58 from:
Step 7: UUIDs
to:
Step 3.4: UUIDs
Changed lines 65-66 from:
If you're already down with UUIDs, create your primary keys as Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..."
to:
If you're already down with UUIDs, change your primary keys to Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..."
Changed lines 48-49 from:
The following characters are prohibited in field names when syncing: #, !, • Please remove them from any field names in your synced tables.
to:
The following characters are prohibited in field names when syncing: #, !, •, ., / Please remove them from any field names in your synced tables. Also make sure no field names contain the word "and".
Changed line 33 from:
to:
Changed lines 27-28 from:
The hosted tables only require a single new field named "gz_ModTimeStamp". Copy this field from QuickContactHosted.fmp12
to:
The hosted tables only require a single new field named "gz_ModTimeStamp". Copy this field from QuickContactHosted.fmp12.
Changed lines 31-32 from:
Your mobile tables require one GoZync field as well. The same one:
to:
Your mobile tables require four GoZync fields:
Changed lines 34-37 from:
AND, if the table is your " primary table" for an entity (like the invoice table in invoices) then you need three additional fields:
gz_Send \\
to:
Changed lines 38-39 from:
Copy these from QuicContact.fmp12 (our mobile example file). None of these fields require any modification after being pasted in.
to:
Copy these from QuickContact.fmp12 (our mobile example file). None of these fields will require any modification after being pasted in.
NOTE: A table in your mobile file that will only be synced as related records *technically* only needs the "gz_ModTimeStamp" field. But for simplicity and flexibility, we advise that you add all four fields into every table in your mobile file that you want to sync.
Changed lines 35-36 from:
AND, if the table is your " primary table" for an entity (like the invoice table in invoices) them you need three additional fields:
to:
AND, if the table is your " primary table" for an entity (like the invoice table in invoices) then you need three additional fields:
Changed lines 35-36 from:
AND, if the table is you're " primary table" for an entity (like the invoice table in invoices) them you need three additional fields:
to:
AND, if the table is your " primary table" for an entity (like the invoice table in invoices) them you need three additional fields:
Changed lines 89-90 from:
Be sure to do this in both your mobile and hosted files.
to:
Be sure to do this in both your mobile and hosted files. And if you're creating these fields just for sync, be sure they're indexed (in field options, click storage and either check "Automatically create indexes...")
Added lines 23-24:
And while you need these fields in your tables, you DON'T want them on your sync layouts.
Changed lines 5-6 from:
You'll also paste in a folder of scripts; like the fields, most of these come in without requiring any modification. There is one script you'll want to change; more on that below.
to:
You'll also paste in a folder of scripts. Like the fields, most of these come in without requiring any modification. There is one script you'll want to change: more on that below.
Changed lines 11-14 from:
Open one of GoZync sample mobile files (like QuickContact) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. And you don't need to do this in your hosted file.
If you don't have FileMaker Advanced, and can't copy and past tables, you can import the gz table into your file; starting in your mobile file, click "import" in the lower right of the Tables tab of File / Manage / Database.
to:
Open one of GoZync sample mobile files (like QuickContact) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. You do not need to do this in your hosted file.
If you don't have FileMaker Advanced, and can't copy and paste tables, you can import the gz table into your file; starting in your mobile file, click "import" in the lower right of the Tables tab of File / Manage / Database.
Changed lines 21-22 from:
If you don't have advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any). Or get in touch and we can wire this up for you.
to:
If you don't have Advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any). Or get in touch and we can wire this up for you.
Changed lines 65-66 from:
Each table you're going to zync, both on the mobile and hosted side needs it's primary keys converted to UUIDs.
to:
Each table you're going to Zync, both on the mobile and hosted side needs its primary keys converted to UUIDs.
Added lines 41-44:
Modification of related records.
Added lines 85-86:
Checking Your Work
Changed line 89 from:
Visit the "Fields & Scripts" tab of the Integration wizard in GZH. When everything checks out green you can move on to Step 4 of 4.
to:
Changed line 89 from:
Visi the "Fields & Scripts" tab of the Integration wizard in GZH. When everything checks out green you can move on to Step 4 of 4.
to:
Visit the "Fields & Scripts" tab of the Integration wizard in GZH. When everything checks out green you can move on to Step 4 of 4.
Changed line 89 from:
When everything checks out green you can move on to Step 4 of 4.
to:
Visi the "Fields & Scripts" tab of the Integration wizard in GZH. When everything checks out green you can move on to Step 4 of 4.
Changed lines 65-66 from:
If you're already down with UUIDs, create your primary keys as Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..." Your auto enter definition should look like this:
to:
If you're already down with UUIDs, create your primary keys as Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..."
Take your existing ID field and...
1. Turn it into a text field (you may have had it as a number originally).
2. Add an auto-enter calc. Click "Options" and then "Specify" next to "Calculated value". Enter the following as the calc definition:
Get ( UUID )
Your calc should look like this:
http://www.seedcode.com/rootimages/stikipad/gozync/UUID1.png
3. Set it to not be modifiable. Click "OK" on the screen above and make sure your auto-enter options are set like this:
Changed lines 65-66 from:
If you're already down with UUIDs, create your primary keys as Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..."
to:
If you're already down with UUIDs, create your primary keys as Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..." Your auto enter definition should look like this:
http://www.seedcode.com/rootimages/stikipad/gozync/UUID2.png
Be sure to do this in both your mobile and hosted files.
Changed lines 39-40 from:
Copy these from QuicContact.fmp12 (our mobile example file).
to:
Copy these from QuicContact.fmp12 (our mobile example file). None of these fields require any modification after being pasted in.
Changed lines 49-50 from:
Again, open one of GoZync sample mobile files (like QuickContact) and in scripts you'll see a folder called "GoZync".
to:
Again, open one of GoZync sample mobile files (like QuickContact.fmp12) and in scripts you'll see a folder called "GoZync".
Changed lines 25-26 from:
The hosted tables only require a single new field named "gz_ModTimeStamp".
to:
The hosted tables only require a single new field named "gz_ModTimeStamp". Copy this field from QuickContactHosted.fmp12
Added lines 39-40:
Copy these from QuicContact.fmp12 (our mobile example file).
Changed lines 39-42 from:
to:
A note about field names.
The following characters are prohibited in field names when syncing: #, !, • Please remove them from any field names in your synced tables.
Changed lines 11-12 from:
Open one of GoZync sample mobile files (like InvoicesMobile) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. And you don't need to do this in your hosted file.
to:
Open one of GoZync sample mobile files (like QuickContact) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. And you don't need to do this in your hosted file.
Changed lines 44-45 from:
Again, open one of GoZync sample mobile files (like InvoicesMobile) and in scripts you'll see a folder called "GoZync".
to:
Again, open one of GoZync sample mobile files (like QuickContact) and in scripts you'll see a folder called "GoZync".
Changed lines 7-8 from:
Step 6: Add required fields
to:
Step 6.1: Adding a new table to your mobile file
Pasting in the gz table.
Open one of GoZync sample mobile files (like InvoicesMobile) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. And you don't need to do this in your hosted file.
If you don't have FileMaker Advanced, and can't copy and past tables, you can import the gz table into your file; starting in your mobile file, click "import" in the lower right of the Tables tab of File / Manage / Database.
Step 6.2: Add required fields
Changed lines 39-48 from:
Step 6.1: Adding a new table to your mobile file
Pasting in the gz table.
Open one of GoZync sample mobile files (like InvoicesMobile) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. And you don't need to do this in your hosted file.
If you don't have FileMaker Advanced, and can't copy and past tables, you can import the gz table into your file; starting in your mobile file, click "import" in the lower right of the Tables tab of File / Manage / Database.
Step 6.2: Required Scripts (Mobile file only)
to:
Step 6.3: Required Scripts (Mobile file only)
Changed lines 5-6 from:
You'll also paste in a folder of scripts; like the fields, these come in without requiring any modification.
to:
You'll also paste in a folder of scripts; like the fields, most of these come in without requiring any modification. There is one script you'll want to change; more on that below.
Added lines 49-50:
You only need to edit one of these scripts, "Zync - Is a new version permitted". Toward the beginning of that script we go to a layout based on the primary TO you're syncing. Edit the script so you're going to the right layout. You can return to this script later to add additional branches for other TOs you may be syncing in the same file.
Changed lines 53-54 from:
Each table you're going to zync, both on the mobile and hosted side needs it's primary keys? converted to UUIDs.
to:
Each table you're going to zync, both on the mobile and hosted side needs it's primary keys converted to UUIDs.
Changed lines 51-52 from:
to:
Convert your primary keys to UUIDs.
Each table you're going to zync, both on the mobile and hosted side needs it's primary keys? converted to UUIDs.
For more on the rationale here and details on what UUIDs are, read our article on UUIDs.
If you're already down with UUIDs, create your primary keys as Text fields with an auto-enter calc of Get(UUID). Uncheck "Do not replace existing value..." and check "Prohibit modification..."
Changed lines 43-48 from:
Again, open one of GoZync sample mobile files (like InvoicesMobile) and in scripts you'll see a folder called "GoZync". Copy that folder and paste it into your mobile file. (You don't need to add these to your hosted file.)
If example file is in same relation to GZM, file reference will be right.
Scripts come in without mods.
to:
Again, open one of GoZync sample mobile files (like InvoicesMobile) and in scripts you'll see a folder called "GoZync".
- Be sure that the example file you're copying from is in the same folder as your mobile file and GoZyncMobile.fmp12
Then copy that folder and paste it into your mobile file. (You don't need to add these to your hosted file.) If you don't have FileMaker Advanced you can import the folder of scripts by clicking the "import" icon in the lower right of the Manage Scripts window in your mobile file.
Changed lines 5-6 from:
You'll also bring in a folder of scripts; like the fields, these come in without requiring any modification.
to:
You'll also paste in a folder of scripts; like the fields, these come in without requiring any modification.
Changed lines 35-36 from:
Open one of GoZync sample mobile files (like InvoicesMobile) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records.
to:
Open one of GoZync sample mobile files (like InvoicesMobile) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records. And you don't need to do this in your hosted file.
Changed lines 41-44 from:
Pasting in scripts.
Copy from example file.
to:
Pasting in scripts.
Again, open one of GoZync sample mobile files (like InvoicesMobile) and in scripts you'll see a folder called "GoZync". Copy that folder and paste it into your mobile file. (You don't need to add these to your hosted file.)
Added lines 5-6:
You'll also bring in a folder of scripts; like the fields, these come in without requiring any modification.
Changed lines 31-34 from:
Pasting in the gz table.
adfasg
to:
Pasting in the gz table.
Open one of GoZync sample mobile files (like InvoicesMobile) and copy the gz table, pasting it into your mobile file. The table requires no modification and no records.
If you don't have FileMaker Advanced, and can't copy and past tables, you can import the gz table into your file; starting in your mobile file, click "import" in the lower right of the Tables tab of File / Manage / Database.
Changed lines 3-4 from:
to:
GoZync just needs a couple of fields in your tables. Please add these fields exactly as they are in our sample files and don't change their names.
Changed lines 11-12 from:
If you don't have advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any).
to:
If you don't have advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any). Or get in touch and we can wire this up for you.
Changed lines 23-24 from:
AND, if the table is you're "primary table" for an entity (like the invoice table in invoices) them you need three additional fields:
to:
AND, if the table is you're " primary table" for an entity (like the invoice table in invoices) them you need three additional fields:
Changed line 53 from:
When everything checks out green you can move on to Step 4 of 4.
to:
When everything checks out green you can move on to Step 4 of 4.
Changed line 53 from:
When everything checks out green you can move on to Step 3 of 4.
to:
When everything checks out green you can move on to Step 4 of 4.
Added lines 48-53:
Scan and Validate
Click "Refresh..." at the bottom of the screen to check your work..
When everything checks out green you can move on to Step 3 of 4.
Changed lines 3-6 from:
You may have nothing to do on this tab and arrive to it already with a green checkbox at the top of the screen. In particular, if the layout you chose on the previous screen doesn't have any related fields on it, then there is nothing to do here and you can move on to Step 3 of 4.
But if you do have related fields on your layout, GoZync will pick them up and create additional table occurrence rows for them: each of which needs a table occurrence and a blank layout added to GoZyncHosted (GZH) and to GoZyncMobile (GZM).
to:
Changed lines 29-30 from:
Step 6.1: Adding a new table to mobile
to:
Step 6.1: Adding a new table to your mobile file
Changed lines 1-7 from:
Related Fields and Scripts
Step 6: Add required fields
You'll need to add a couple fields to your tables to get GoZync to work. The fields are listed below. If you have FileMaker Advanced you can simply copy and paste these fields from one of GoZync's example files (be sure to copy the hosted fields from the hosted example file, the mobile ones from mobile).
to:
Background: Pasting in Fields and Scripts
You may have nothing to do on this tab and arrive to it already with a green checkbox at the top of the screen. In particular, if the layout you chose on the previous screen doesn't have any related fields on it, then there is nothing to do here and you can move on to Step 3 of 4.
But if you do have related fields on your layout, GoZync will pick them up and create additional table occurrence rows for them: each of which needs a table occurrence and a blank layout added to GoZyncHosted (GZH) and to GoZyncMobile (GZM).
Step 6: Add required fields
You'll need to add a couple fields to your tables to get GoZync to work.
The fields are listed below. If you have FileMaker Advanced you can simply copy and paste these fields from one of GoZync's example files (be sure to copy the hosted fields from the hosted example file, the mobile ones from mobile).
Changed lines 31-32 from:
Step 6.1: Adding a new table to mobile
to:
Step 6.1: Adding a new table to mobile
Changed lines 37-38 from:
Step 6.2: Required Scripts (Mobile file only)
to:
Step 6.2: Required Scripts (Mobile file only)
Changed lines 48-49 from:
Step 7: UUIDs
to:
Step 7: UUIDs
Changed lines 36-39 from:
to:
If example file is in same relation to GZM, file reference will be right.
Scripts come in without mods.
Changed lines 26-27 from:
Step 6: Adding a new table to mobile
to:
Step 6.1: Adding a new table to mobile
Changed lines 32-33 from:
Step 6: Required Scripts (Mobile file only)
to:
Step 6.2: Required Scripts (Mobile file only)
Changed lines 26-29 from:
Step 6: Adding the gz table to mobile
Pasting in a new table.
to:
Step 6: Adding a new table to mobile
Pasting in the gz table.
Added lines 26-31:
Step 6: Adding the gz table to mobile
Pasting in a new table.
adfasg
Deleted lines 33-36:
Creating the gz table in mobile.
dasfg
Changed lines 28-30 from:
to:
Creating the gz table in mobile.
dasfg
Pasting in scripts.
adfasg
Added lines 26-30:
Step 6: Required Scripts (Mobile file only)
Changed lines 1-4 from:
Tab 3 of 4: Related Fields and Scripts
!!Step 6: Add required fields
to:
Related Fields and Scripts
Step 6: Add required fields
Changed lines 25-26 from:
to:
Step 7: UUIDs
Changed lines 3-4 from:
!! Step 6: Add required fields
to:
!!Step 6: Add required fields
Changed lines 25-26 from:
to:
Changed lines 1-4 from:
Hi again
Step 6: Add required fields
to:
Tab 3 of 4: Related Fields and Scripts
!! Step 6: Add required fields
Changed lines 25-26 from:
to:
Changed lines 17-18 from:
to:
Changed line 21 from:
to:
Changed lines 15-16 from:
Your mobile tables require one GoZync field as well. The same one: "gz_ModTimeStamp".
to:
Your mobile tables require one GoZync field as well. The same one:
gz_ModTimeStamp
Changed lines 15-17 from:
Your mobile tables require four GoZync fields:
to:
Your mobile tables require one GoZync field as well. The same one: "gz_ModTimeStamp".
AND, if the table is you're "primary table" for an entity (like the invoice table in invoices) them you need three additional fields:
gz_Send gz_Sent gz_TimeStampSent
Changed lines 13-14 from:
to:
Mobile.
Your mobile tables require four GoZync fields:
Changed lines 15-16 from:
to:
Added lines 12-17:
Step 7: UUIDs
inlcude a page on UUIDs?
Added lines 1-11:
Hi again
Step 6: Add required fields
You'll need to add a couple fields to your tables to get GoZync to work. The fields are listed below. If you have FileMaker Advanced you can simply copy and paste these fields from one of GoZync's example files (be sure to copy the hosted fields from the hosted example file, the mobile ones from mobile).
If you don't have advanced, just recreate the fields in your table, paying special attention to the field's type and auto-enter definition (if any).
Hosted.
The hosted tables only require a single new field named "gz_ModTimeStamp".
|