Start-up Package

Version 1.2 Table Of Contents

Start your Implementation ...... 3 Steps Overview ...... 3 (Required) Enroll in the iOS Developer Enterprise Program ...... 3 Provide Graphic Design Assets and Theme Configuration ...... 4 Specify Configuration Details ...... 7 (Required) Provide Distribution ...... 11 Summary & Checklist ...... 12 Appendices ...... 13 iOS App Re-signing Concepts ...... 14 Advanced Re-Branding ...... 16

2 | 18 Back to Table of Contents Start your Implementation

Implementing your SharePlus application requires you to complete five steps to start the process and correctly configure your application. This section helps you achieve these steps to meet your needs and personalize its look and feel. The IOS Developer Enterprise Program will allow you to distribute your application internally. While in the Graphic Design and Configuration steps you will have the chance to customize, trim or modify many of the features that SharePlus provides. This will allow you to better control how users interact with the application. In the Distribution stage you will provide us with two important files (provided by Apple Inc.) to digitally sign the application so it becomes yours when it is built.

Steps Overview Start your SharePlus project implementation following these steps: 1. (Required) Enroll in the iOS Developer Enterprise Program 2. Provide Graphic Design Assets and Theme Configuration 3. Specify Application Configuration Details 4. (Required) Provide Distribution Files

Enroll in the iOS Developer Enterprise Program To distribute the app internally, Apple requires you to be part of the iOS Developer Enterprise Program. You just need to fill a form in Apple’s website to start the process and then wait for Apple’s response. Once you complete the process, Apple will provide you an account that will be needed to complete the Distribution step.

Timeframe This process usually takes at least two weeks and it depends entirely on Apple’s approval. So, if you are not part of this program already, it is important that you start the process as soon as possible.

ENROLL https://developer.apple.com/programs/start/enterprise/

3 | 18 Provide Graphic Design Assets and Theme Configuration In this step you will provide our engineers with the application icons, splashes and passcode lock headers they need to personalize your application’s graphics. These include icons your application will show in the iOS User Interface along with other images the application itself will use when it is launched. Besides the graphic assets, you may provide a desired theme configuration to adjust the color palette.

Samples Download the Sample Graphics package from http://download.infragistics.com/shareplus/site/4.0.html.

Application Re-Branding Re-branding can be achieved through the inclusion of customized assets and the configuration of the application color settings (theme).

List of Re-Branding PNG Images Re-branding images include:  Application Icons, used in the Springboard, iTunes Artwork, device settings, .  Splash screens, images displayed when first launching the app while the interface loads.  Passcode Lock headers, you can optionally change the Passcode Lock header. App Icons Springboard / iOS home screen

iTunes Artwork

Device settings

Spotlight search

4 | 18 Splash screens

Passcode Lock headers

Basic Re-Branding This iOS7 Application Re-Branding method is quick and straightforward, but it has some minor drawbacks. The method requires only three images that will be stretched to match all the required sizes for the application icons, splash screens and passcode lock headers. Minor drawbacks for images generated with this re-branding method:  Images are stretched and won’t be pixel-perfect. This means that for the trained eye, several image quality factors like sharpness or distortion may suffer.  The app icon image is heavily stretched, ranging from 1024 x 1024 to 76 x 76 px. To make your logo noticeable in small icons, the logo should cover most of the image canvas. Image provided Result

5 | 18 Important considerations on graphic assets:

 All images must follow these general requirements: o No transparency, except the Passcode Lock header o 72 dpi o PNG format In the list below you will find the minimum required images for iOS7. Required Images iOS VERSION IMAGE LOCATION DEVICE MIN SIZE (px) TENTATIVE NAME All App Icons iPad/iPhone 1024 x 1024 app-icon@2x

iOS7 All Splash Screens iPad/iPhone 2048 x 1536 default-Landscape@2x

All Passcode lock headers iPad/iPhone 948 x 292 header@2x

Note: If you need information regarding iOS6 or you want to have more control over the re-branding process, refer to the Advanced Re-Branding section in the Appendices.

The Application’s Theme With the iOS7 theme, you can adjust the UI appearance in iOS7 environments according to your needs.

6 | 18 Theme Configuration Form Adjust the UI appearance in iOS7 environments by definining a key color in the application.

Enable Theme Management: iOS7 RGB Color Settings: Tint Color R: G: B:

Specify Configuration Details You can make SharePlus fit your company’s needs by customizing SharePlus features’ settings or even trim those features you don’t want by filling in the configuration form.

Guidance Please refer to Chapter 1: Planning Configuration in SharePlus 4.0 Administrator Guide for guidance. For a complete list of available settings check the Configuration Reference appendix in SharePlus 4.0 Administrator Guide and contact your Sales Engineer.

Application Configuration Form

APPLICATION NAME

Name:

INFO Application display name, cannot be larger than 13 characters

CONFIGURATION BROADCAST

Remote Configuration URL:

Configuration Broadcast allows system administrators to broadcast and replicate SharePlus’ INFO configurations to all devices that have it installed. A remote configuration file is loaded by SharePlus every time the application is launched in order to load any existing update. Please refer to the Configuration Broadcast Guide for further information.

FEATURES

Allow SITES Administration:

INFO Allow add/edit/delete SharePoint sites in SharePlus.

Include Pre-configured SITES:

7 | 18 Allow LISTS Administration:

INFO Allow the user to set up SharePlus’ list settings of any SharePoint list.

Allow LISTS Offline Support Administration:

INFO Allow the user to set up SharePlus’ list Offline settings of any SharePoint list.

Allow ITEMS Administration:

Allow the user to perform actions over items. Includes add, edit, delete, check out, INFO approve/reject, copy URL, email URL, and save as draft actions.

Allow LOCAL FILES Section:

Allow the user to copy documents from libraries, send documents via email, and share INFO data via Wi-Fi (download and upload).

Show GLOBAL SETTINGS:

Show auto-lock settings, connection timeouts, application logs, synchronization idle time INFO settings, and other low-level parameters.

GLOBAL SETTINGS Configuration:

CONFIGURE CONNECTIVITY Specify Connection timeout (seconds):

INFO Amount of seconds the app waits for a response before assuming a time out.

Specify Sync idle time (seconds:

INFO Amount of seconds that the app will wait, after being idle, to trigger a sync process.

Specify user agent:

INFO SharePlus’ user agent. If empty, the standard Mozilla user agent will be used. 8 | 18

Specify SSL level:

INFO Change the SSL level to be used with secure HTTP connections (HTTPS).

Enable technical log:

Information logs about app’s requests and server’s responses. Logs are generated in Local INFO Files under the “Logs” folder.

CONFIGURE CAFFEINE MODE Disable device’s auto-lock on :

INFO Prevents the device from locking itself when previewing documents.

Disable device’s auto-lock on sync:

INFO Prevents the device from locking itself during the synchronization process.

Device must be plugged in to disable device’s auto-lock:

INFO Enables both auto-lock options only if the device is plugged in.

MISCELLANEOUS Preview documents on tap:

When tapping a document, default action is to open the document’s preview instead of INFO displaying the item’s details (metadata).

Remove local files after upload:

Remove the local copy of a file after it has been used as an attachment or a new item was INFO created.

Auto hide navigator:

When browsing a list, the navigator (left pane) auto hides by default unless this value is INFO set to No.

9 | 18

CONFIGURE PASSCODE LOCK Show passcode lock settings:

INFO Allow the user to modify the passcode lock settings.

Enable passcode lock by default:

INFO Enable/Disable the passcode lock feature by default.

Default passcode:

INFO Default passcode configured by default.

Force passcode lock:

Force the user to work with a passcode lock. Requires the user to set it up on the first INFO application run.

Prompt passcode lock after:

INFO Time in minutes that the application will remain idle before it becomes locked.

Enable fails handle:

Allow to be displayed and actions to be performed when the passcode lock INFO authentication fails.

Maximum amount of failed attempts:

INFO The maximum amount of failed authentication attempts.

Block application:

INFO Specify if the application will be blocked or not.

Wipe data:

Clear internal application data when the user fails to provide the valid passcode lock. INFO Including Local Files, Offline cache, internal database and other user data.

10 | 18

Message:

Message to be displayed when the user fails the last attempt, having no more attempts INFO left.

CONFIGURE FEEDBACK Error reporting email address:

Default email addresses to send errors and feedback reports. Addresses should be INFO specified separated by comma and they will be included in the TO field when composing a new message.

Enable feedback form:

INFO Allows the user to send feedback from inside the application.

NOTES

Provide Distribution Files Details - To digitally sign the application using your Enterprise Certificate, provided to you by Apple Inc., we need you to create a Distribution Provisioning Profile and a Distribution Certificate with Apple. By using these two files we are able to legally create a custom build of SharePlus that’s registered by Apple as yours so you are able to use and legally distribute it as you please.

Note: Take into account that we need a Personal Information Exchange (.p12) file instead of the certificate (.cer) file.

Guidance - For general information please refer to iOS App Re-signing Concepts in the Appendices. For deployment-specific information refer to Chapter 1 (Planning Deployment) and Chapter 4 (Deployment) in SharePlus Administrator Guide.

PROVIDE Your company’s Distribution Provisioning Profile and Distribution Certificate with the password set when exporting it on the Access.

11 | 18

Back to Table of Contents Summary & Checklist

To conclude, the following steps are required to start your application implementation: 1. (Required) Enroll in the iOS Developer Enterprise Program in Apple. 2. Provide the Application’s graphic assets. 3. Complete the Theme Configuration Form. 4. Complete the Application Configuration Form. 5. (Required) Provide the Distribution Provisioning Profile and Distribution Certificate

iOS7 Re-branding assets ready to send SIZE (px) TENTATIVE NAME READY 1024 x 1024 app-icon@2x

2048 x 1536 default-Landscape@2x

948 x 292 header@2x

Configuration Forms filled FORM READY Theme Configuration

Application Configuration

Distribution Files ready to send FILE READY Distribution Provisioning Profile (created with the corresponding ID)

Distribution Certificate (.p12 file)

12 | 18

Appendices

Appendix 1: iOS App Re-signing Concepts Appendix 2: Advanced Re-Branding

13 | 18

iOS App Re-signing Concepts

Certificates and Profiles Importance To digitally sign a SharePlus application for enterprise distribution you need two main resources:  Enterprise Distribution Certificate  Distribution Provisioning Profile Those resource files are owned by companies enrolled in Apple’s Enterprise Program and can be retrieved from apple’s portal.

ENROLL • Join Apple's iOS Developer Enterprise Program

PREPARE TO SIGN • Create and install the DISTRIBUTION CERTIFICATE • Create and download a PROVISIONING PROFILE

SIGN & DEPLOY • Sign the app IPA • Add a SharePlus license • Distribute the app IPA

Enterprise Distribution Certificate The distribution certificate is a private certificate that is provided by Apple. Certificates are created to help Apple identify your company and, once retrieved, a certificate must be installed to be used in the application signing process.

Distribution Provisioning Profile The provisioning profile is targeted to one or more apps and can be retrieved from Apple’s portal. Profiles are created to authorize specific apps to run in iOS devices. A specific app can be uniquely identified by its bundle ID. There are two types of provisioning profiles:  Ad-Hoc - It is commonly used for internal testing and is restricted to specific devices.  In-House - It depends only on the App ID and is not limited by device IDs.

About the App ID and Bundle ID App IDs are used by Apple to identify applications. An App ID is a string composed with two parts, a Team ID prefix and a bundle ID search string. The Bundle Identifier (bundle ID) is a unique string used to identify a specific application’s bundle. The application bundle contains the executable code and all resources required to run the application. The Team ID prefix is automatically provided by Apple’s portal and identifies a development team.

14 | 18

The Certificate-Profile Relation Provisioning Profiles are closely related to the Distribution Certificate. Because of that, if the certificate expires the distributed application will no longer run. A Distribution Certificate can have more than one Provisioning Profile associated and a Provisioning Profile can target more than one bundle ID. Profiles are created for a specific App ID, but you can include a wildcard (.*) in the App ID specification. For example, by entering A1B2C3D4E5.com.infragistics.* as the App ID, the same Provisioning Profile can be used for com.infragistics.shareplus and com.infragistics.reportplus bundle IDs. Provisioning App ID Bundle ID Profile Distribution Certificate Bundle ID Provisioning App ID Profile Bundle ID

Certificate-Profile expiration Both Distribution Certificates and Provisioning Profiles must be renewed periodically.  Distribution Certificate – valid for 3 years  Provisioning Profile – valid for 1 year

SharePlus License SharePlus app must have a license associated for each application’s bundle identifier (Bundle ID). SharePlus will not run in a device if the license file (license.splic) is missing or invalid.

The Contoso Company example Contoso company wants to distribute SharePlus Enterprise app internally. To enable app distribution to iOS devices, Apple requires Contoso to be a part of the iOS Developer Enterprise Program. A Distribution Certificate (ContosoCertificate.p12) is needed to legally register an app under Contoso’s name. Next, Contoso must define a bundle ID (com.contoso.shareplus) in order to identify SharePlus Contoso application. To register the bundle ID, Contoso needs to create a new App ID (A1B2C3D4E5.com.contoso.shareplus) in Apple’s Provisioning portal. The Team ID prefix (A1B2C3D4E5) included in the App ID is provided by Apple. After that, a Provisioning Profile (SharePlusContoso.mobileprovision) can be created and downloaded from Apple’s portal to use the previously defined bundle ID (com.contoso.shareplus). Finally, a SharePlus license (license.splic) provided by Infragistics must be included in the IPA to be signed. Note that a SharePlus application will not run without a license file. After gathering all the required resources, the SharePlus Contoso IPA can be signed and distributed by Contoso company. For further details about the whole process refer to the Start-up Package document and Application Re- Signing Process section in the SharePlus Administrator Guide.

15 | 18

Advanced Re-Branding

Re-branding can be achieved through the inclusion of customized assets and the configuration of the application color settings (theme). As specified in the main chapter, Re-branding assets include:  Application Icons, used in the Springboard, iTunes Artwork, device settings, Spotlight.  Splash screens, images displayed when first launching the app while the interface loads.  Passcode Lock headers, you can optionally change the Passcode Lock header. Important considerations on graphic assets:

 All images must follow these general requirements: o No transparency, except the Passcode Lock header o 72 dpi o PNG format  iTunes Artwork images must be named without the .png extension.  Required images are mandatory.  iOS6-related images are relevant only if you are using devices running iOS6.

iOS7 Complete Re-Branding In the list below you will find all the required application icons and splash screens for iOS7. Passcode lock images are also recommended to enhance the application’s user experience. Required Images iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME 512 x 512 iTunesArtwork iTunes iTunes Artwork - 1024 x 1024 iTunesArtwork@2x 76 x 76 appIcon-76x76- iPad Springboard / iOS Home Screen 152 x 152 appIcon-76x76@2x-ipad iPhone 120 x 120 appIcon-60x60@2x- 768 x 1024 default-700-Portrait-ipad iOS7 1536 x 2048 default-700-Portrait@2x-ipad iPad 1024 x 768 default-700-Landscape-ipad Launch / Splash Screen 2048 x 1536 default-700-Landscape@2x-ipad 640 x 960 default-700@2x-iphone iPhone 640 x 1136 default-700-568h@2x-iphone

Passcode Images (Recommended) iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME 474 x 146 header-ipad iPad 948 x 292 header@2x-ipad iOS7 & iOS6 Passcode lock header 292 x 77 header-iphone iPhone 584 x 154 header@2x-iphone

16 | 18

iOS6 Complete Re-Branding

In the list below you will find all the required application icons and splash screens for iOS6. Passcode lock images are also recommended to enhance the application’s user experience. Required Images iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME 512 x 512 iTunesArtwork iTunes iTunes Artwork - 1024 x 1024 iTunesArtwork@2x 72 x 72 appIcon-72x72-ipad iPad 144 x 144 appIcon-72x72@2x-ipad Springboard / iOS Home Screen 57 x 57 appIcon-57x57-iphone iPhone 114 x 114 appIcon-57x57@2x-iphone 768 x 1024 default-Portrait-ipad iOS6 iPad 1536 x 2048 default-Portrait@2x-ipad 1024 x 768 default-Landscape-ipad Launch / Splash Screen 2048 x 1536 default-Landscape@2x-ipad 320 x 480 default-iphone iPhone 640 x 960 default@2x-iphone

640 x 1136 default-568h@2x-iphone

Passcode Images (Recommended) iOS VERSION IMAGE LOCATION DEVICE SIZE (px) TENTATIVE NAME 474 x 146 header-ipad iPad 948 x 292 header@2x-ipad iOS6 & iOS7 Passcode lock header 292 x 77 header-iphone iPhone 584 x 154 header@2x-iphone

The Application’s Theme You can adjust the application’s theme according to your needs. There are two different theme configurations, one for iOS7 and another for iOS6. With the iOS6 theme, you can adjust the color palette and also apply individual changes to some UI components like the top and bottom bars.

17 | 18

Theme Configuration Form

Enable Theme Management: iOS6 RGB Color Settings:

Navigation Bar R: G: B:

Search Bar R: G: B:

Toolbar R: G: B:

TabBar R: G: B:

18 | 18