Zulu - Integrating with Apple Calendars

From 360Works Product Documentation Wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with ": Zulu can integrate with Apple Calendars, allowing you to view your FileMaker calendars on Apple computers or iPhone. =Prerequisites= * Zulu must be installed: [[Zulu - Inst...")
 
Line 5: Line 5:
 
* Your calendars must be published: [[Zulu - Calendars and Publishing#How To Publish Calendars | How To Publish Calendars]]
 
* Your calendars must be published: [[Zulu - Calendars and Publishing#How To Publish Calendars | How To Publish Calendars]]
  
=Setup=
+
=Constructing Calendar URL=
To integrate with apple calendars, you will need a FileMaker account username and password, and the Calendar URL, which Apple Calendar will use to communicate with Zulu.
+
 
+
==Constructing Calendar URL==
+
 
Whenever you [[Zulu - Calendars and Publishing#How To Publish Calendars | publish your calendars]], the resultant page has a section called "Add your calendar to iCal, iPhone, or iPad", which displays the calendar URL that Apple Calendar needs.  This section is about how to construct that URL on your own so you understand the components of it.
 
Whenever you [[Zulu - Calendars and Publishing#How To Publish Calendars | publish your calendars]], the resultant page has a section called "Add your calendar to iCal, iPhone, or iPad", which displays the calendar URL that Apple Calendar needs.  This section is about how to construct that URL on your own so you understand the components of it.
  
 
The format of the calendar URL is:
 
The format of the calendar URL is:
<pre>https://<your server address>/zulu/calendars/<your database name></pre>
+
<pre>http<s>://<your Zulu address>:<port>/zulu/calendars/<your database name></pre>
 +
 
 +
You may notice that calendar URL reaches out to Zulu.  Zulu intercepts communicate from Apple Calendar, converts it into FileMaker requests, then converts the result back from FileMaker into the format required for Apple Calendar.  This is important because your Apple Calendar devices must be able to communicate with Zulu in order to work properly.
 +
 
 +
To give an example, say I had Zulu running on a machine with the address: "example.com", the database I have my calendars in is: "Zulu2SampleData", and I have a valid SSL certificate installed on that machine, which allows me to use https instead of http.  The url for my calendars would be:
 +
<pre>https://example.com/zulu/calendars/Zulu2SampleData</pre>
 +
 
 +
Another example, with the same server and database as above, but in this case, I had Zulu running on port 8080, and I was not using an SSL certificate of any kind.  The calendar url would be:
 +
<pre>http://example.com:8080/zulu/calendars/Zulu2SampleData</pre>
 +
 
 +
'''Note:''' Apple Calendar has gotten very picky in later versions about servers without SSL certificates.  Frequently Apple Calendars will refuse to send credentials to Zulu, and the request will fail.  To resolve this, try installing a valid SSL certificate on your Zulu server.  If this is not an option for you, you can use the default FileMaker certificate, but you will need to add this certificate to the trust store on each device communicating with Zulu.  See more on that below.

Revision as of 15:41, 22 January 2019

Zulu can integrate with Apple Calendars, allowing you to view your FileMaker calendars on Apple computers or iPhone.

Prerequisites

Constructing Calendar URL

Whenever you publish your calendars, the resultant page has a section called "Add your calendar to iCal, iPhone, or iPad", which displays the calendar URL that Apple Calendar needs. This section is about how to construct that URL on your own so you understand the components of it.

The format of the calendar URL is:

http<s>://<your Zulu address>:<port>/zulu/calendars/<your database name>

You may notice that calendar URL reaches out to Zulu. Zulu intercepts communicate from Apple Calendar, converts it into FileMaker requests, then converts the result back from FileMaker into the format required for Apple Calendar. This is important because your Apple Calendar devices must be able to communicate with Zulu in order to work properly.

To give an example, say I had Zulu running on a machine with the address: "example.com", the database I have my calendars in is: "Zulu2SampleData", and I have a valid SSL certificate installed on that machine, which allows me to use https instead of http. The url for my calendars would be:

https://example.com/zulu/calendars/Zulu2SampleData

Another example, with the same server and database as above, but in this case, I had Zulu running on port 8080, and I was not using an SSL certificate of any kind. The calendar url would be:

http://example.com:8080/zulu/calendars/Zulu2SampleData

Note: Apple Calendar has gotten very picky in later versions about servers without SSL certificates. Frequently Apple Calendars will refuse to send credentials to Zulu, and the request will fail. To resolve this, try installing a valid SSL certificate on your Zulu server. If this is not an option for you, you can use the default FileMaker certificate, but you will need to add this certificate to the trust store on each device communicating with Zulu. See more on that below.

Personal tools
Namespaces

Variants
Actions
Plug-in Products
Other Products
Navigation
Toolbox