Creating a new provider¶
Note: This describes how to create a provider for an external data source, such as IFS Applications/IFS Cloud.
There are two ways of creating providers. You can either create the providers and then add them to the apps you create, or you can import an existing app and automatically create the providers during the import.
Once you have created the providers, there are several ways of accessing the provider versions. You can access:
- The Active (live) version of the provider.
- A numbered version (version 1), but note that the version might not be live.
- The Latest version of the provider. This is the latest successfully created version, but it might not be live.
Select the Active version or Latest version if you want an automatic upgrade policy for your app or template, or the numbered version for manual upgrades.
Note: You can create providers with SSO configuration.
Create providers to add to portal apps¶
To create a new provider which you will then add to a portal app:
- Go to Home > Providers.
- Click Create Provider.
On the Provider Details tab:
Field Description Provider Name Enter a descriptive name that will make it easier to identify the provider when configuring apps and templates. You can edit this later. Service type Select the service type. The IFS Applications type covers both IFS Applications 10 and IFS Cloud. Time Zone By default, data containing datetimes is saved as UTC, and returned without any offset for time zones.
If data is saved by the data source (such as IFS Cloud) with a time zone offset then you need to specify this offset when creating the provider. The default time zone for all providers is UTC.
When the timezone offset is calculated Portal Studio takes into account both the provider's time zone and the user's time zone:
• For public portal apps, it takes the user's time zone from the browser.
• For all other types of app, it adjusts the display of times by allowing for the time zones from the Portal Studio user and also from the browser.Credentials Object Select the credentials for the target environment. This contains both the endpoint URL and the credentials needed to connect to that environment.
You need to create credentials first:
• Go to the Admin Configuration and the Credentials page.
Note: You cannot create the provider if there is an issue with the endpoint or a network problem.Service The service name without the URL of the endpoint.
• For IFS Cloud,MainCaseHandling.svcis an example of a service name. You can search for a service by typing the 3 or more characters from the name.
• For an endpoint where there is no service name, enter a forward slash/.Description Additional information about the provider. This is an optional field, and you can edit this later. Concurrency Checks Use this where the deployment does not enforce concurrency on operations such as update, upsert and patch. When selected, the provider will attempt to handle concurrency for these types of operation. 4. Click Continue. The button is unavailable if any mandatory information is missing. Note: You cannot create the provider if there is an issue with the endpoint or a network problem. In this situation, the status of the provider will show as !. Try again later to create the provider. 5. Version 1 is created. Make the provider version live. You can only use a provider which has a live version.