The easy way to find, call, and text your colleagues, and to navigate up and down your company's org chart.
Employee Directory allows you to look for employees by name, view their details, add them to your contacts, and see their manager and direct reports, as well as call, text, or email them.
Employee Directory always accesses the employee data from a local database on your iPhone. The information is always available, even when you are offline.
The application comes with a sample dataset to provide an "out-of-the-box" experience, and with a simple offline synchronization mechanism to sync with your own data.
Employee Directory requires some integration with your company's infrastructure, and is therefore intended to be set up by a technical person in your organization. The integration is simple. There are two ways you can populate the local Employee Directory database with your own company data:
Static synchronization is the simplest approach to populate your local database with the employees in your organization. Just create a static JSON file (for example, employees.json) representing an array of employee objects, and host it on a web server.
An employee object must have the following fields:
|id||The employee id. Must be unique.||2|
|firstName||The employee's first name.||Julie|
|lastName||The employee's last name.||Taylor|
|managerId||The employee's manager id.||1|
|title||Job Title||VP of Marketing|
|city||City. Can include the state.||Boston, MA|
|picture||Fully qualified URL to employee's picture||http://employeedirectory.org/pics/Julie_Taylor.jpg|
|twitterId*||Twitter id. Can be empty string.||@JulieTaylor|
|blogURL*||Blog URL. Can be empty string.||http://blogs.employeedirectory.org/julie|
|lastModified||Timestamp of last modification.||2012-06-01 01:00:00|
|deleted||0 (employee active) or 1 (employee deleted)||0|
* currently not used in the application. You can provide an empty string as the value.
A sample employees.json file is available here:
To synchronize with a static JSON file:
A sample service is provided at the following URL:
The service returns an array of employee objects. Employee objects follow the structure described in the Using a Static JSON File section.
The client application uses the lastModified field of the employee record to determine the timestamp of the last synchronized item. The application then invokes your synchronization service with a query parameter named modifiedSince to request the employees that have changed (created, updated, or deleted) since then. Your service needs to handle the modifiedSince query parameter and return the corresponding employees. For example...
The following service call will return the employees modified since June 15th 2012 at 1:00am:
The following service call will return the employees modified since March 1st 2012 at 3:00pm:
The following service call will return the employees modified since January 1st 2015 at midnight (obviously, an empty list at this time):
To synchronize with a RESTful service...
The first time:
To get incremental updates:
For questions and comments, please send us an email.