AgileApps Support Wiki Pre Release

Difference between revisions of "Community Tenant"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
==About the Community Site==
==About the Community Tenant==
The Community Site can be configured by [[ISV]]s to create community pages like [[Marketplace]], Support Portal, Answers, Ideas, and Social Networking.  
The Community Tenant can be configured by [[ISV]]s to create community pages like [[Marketplace]], Support Portal, Answers, Ideas, and Social Networking.  


The Community provides a space where all Users in all the tenancies (under a single [[ISV]]) can share knowledge and collaborate, without requiring a separate login to the platform.
The Community provides a space where all Users in all the tenancies (under a single [[ISV]]) can share knowledge and collaborate, without requiring a separate login to the platform.
Line 10: Line 10:
All new Users in all tenancies under a single [[ISV]] are automatically associated with the Community account. This provides single sign-on capability via the community user credentials.
All new Users in all tenancies under a single [[ISV]] are automatically associated with the Community account. This provides single sign-on capability via the community user credentials.


If the Community Site is enabled ''in a tenancy with existing users'', additional steps must be taken to make the association.  
If the Community Tenant is enabled ''in a tenancy with existing users'', additional steps must be taken to make the association.  
:''Learn more: [[#Enabling a Community Site with Existing Users|Enabling a Community Site with Existing Users]]''
:''Learn more: [[#Enabling a Community Tenant with Existing Users|Enabling a Community Tenant with Existing Users]]''


==Configure a Community Site==
==Configure a Community Tenant==
#Complete the following steps to create a ''Community User'' (Linked Community Username):
#Complete the following steps to create a ''Community User'' (Linked Community Username):
#:*Create a New Tenant
#:*Create a New Tenant
Line 21: Line 21:
;Considerations:
;Considerations:
:*Users added to the tenancies are automatically added as users in the Community to enable single sign-on access
:*Users added to the tenancies are automatically added as users in the Community to enable single sign-on access
::*The [[ISV]] can login to the Community Site to see the list of site users
::*The [[ISV]] can login to the Community Tenant to see the list of site users
::*The ''Community User'' associated with the Community Site is based on the [[Username]]:
::*The ''Community User'' associated with the Community Tenant is based on the [[Username]]:
:::For Username of <tt>john@domainname.com</tt>, the ''Community User'' is  <tt>john@domainname.com.site</tt>
:::For Username of <tt>john@domainname.com</tt>, the ''Community User'' is  <tt>john@domainname.com.site</tt>
:*Users are automatically logged into the Community Site when they login to their tenancy
:*Users are automatically logged into the Community Tenant when they login to their tenancy
:*Users are automatically logged out from the Community Site when they log out from their tenancy
:*Users are automatically logged out from the Community Tenant when they log out from their tenancy
:: *If ISV is not planning to expose Community Site registration to the public unless they also register for tenancy, then the Community Site username will never by needed by users and they need not know about it.
:: *If ISV is not planning to expose Community Tenant registration to the public unless they also register for tenancy, then the Community Tenant username will never by needed by users and they need not know about it.
:*In addition to [[Sites#Tags|Site Tags]], ISVs can use services available in the [[Community Resource]] in the [[REST API]] to develop additional functionality
:*In addition to [[Sites#Tags|Site Tags]], ISVs can use services available in the [[Community Resource]] in the [[REST API]] to develop additional functionality


===Enabling a Community Site with Existing Users===
===Enabling a Community Tenant with Existing Users===
To add existing Users in existing tenancies to a Community Site, complete the following steps:
To add existing Users in existing tenancies to a Community Tenant, complete the following steps:


#Create a Registration [[Page]] in the Community Site
#Create a Registration [[Page]] in the Community Tenant
#Invite Existing Users to register using this page (send the link via [[Email]])
#Invite Existing Users to register using this page (send the link via [[Email]])
#After Users register, use the <tt>LINK_TO_COMMUNITY_LOGIN</tt> service to link the [[Username]] with the ''Community User''; Choose one of the following methods:
#After Users register, use the <tt>LINK_TO_COMMUNITY_LOGIN</tt> service to link the [[Username]] with the ''Community User''; Choose one of the following methods:
Line 39: Line 39:
:::<tt>/networking/Service?s=243&a=link_to_community_login&community_login={COMMUNITY_LOGIN}&community_password={COMMUNITY_PASSWORD}</tt>
:::<tt>/networking/Service?s=243&a=link_to_community_login&community_login={COMMUNITY_LOGIN}&community_password={COMMUNITY_PASSWORD}</tt>
:::*This Service can only be invoked by Tenant users after they have logged into their tenancy
:::*This Service can only be invoked by Tenant users after they have logged into their tenancy
After any one of the services has been executed successfully, the [[Username]] and ''Community User'' are now connected. From this point forward, when the user logs in to their tenancy, they are automatically logged in to the Community Site.
After any one of the services has been executed successfully, the [[Username]] and ''Community User'' are now connected. From this point forward, when the user logs in to their tenancy, they are automatically logged in to the Community Tenant.


==Sync User Profile Information==
==Sync User Profile Information==
By default, the User Profile in the Community Site is automatically kept in sync with the user's Personal Setup Information, found in: [[My Information]].
By default, the User Profile in the Community Tenant is automatically kept in sync with the user's Personal Setup Information, found in: [[My Information]].


The following fields are automatically synchronized:
The following fields are automatically synchronized:

Revision as of 00:08, 4 April 2014

About the Community Tenant

The Community Tenant can be configured by ISVs to create community pages like Marketplace, Support Portal, Answers, Ideas, and Social Networking.

The Community provides a space where all Users in all the tenancies (under a single ISV) can share knowledge and collaborate, without requiring a separate login to the platform. Template:ISV Feature

How it Works

The ISV creates a new Tenancy, which serves as host to the Community. This Tenancy is managed via a login account, called the Community Admin.

All new Users in all tenancies under a single ISV are automatically associated with the Community account. This provides single sign-on capability via the community user credentials.

If the Community Tenant is enabled in a tenancy with existing users, additional steps must be taken to make the association.

Learn more: Enabling a Community Tenant with Existing Users

Configure a Community Tenant

  1. Complete the following steps to create a Community User (Linked Community Username):
    • Create a New Tenant
    • Create a Community Application in that Tenant via Sites
  2. Enable Service_Provider_Settings#Community Site Configuration
Considerations
  • Users added to the tenancies are automatically added as users in the Community to enable single sign-on access
  • The ISV can login to the Community Tenant to see the list of site users
  • The Community User associated with the Community Tenant is based on the Username:
For Username of john@domainname.com, the Community User is john@domainname.com.site
  • Users are automatically logged into the Community Tenant when they login to their tenancy
  • Users are automatically logged out from the Community Tenant when they log out from their tenancy
*If ISV is not planning to expose Community Tenant registration to the public unless they also register for tenancy, then the Community Tenant username will never by needed by users and they need not know about it.

Enabling a Community Tenant with Existing Users

To add existing Users in existing tenancies to a Community Tenant, complete the following steps:

  1. Create a Registration Page in the Community Tenant
  2. Invite Existing Users to register using this page (send the link via Email)
  3. After Users register, use the LINK_TO_COMMUNITY_LOGIN service to link the Username with the Community User; Choose one of the following methods:
/networking/Service?s=243&a=link_to_community_login&community_login={COMMUNITY_LOGIN}&community_password={COMMUNITY_PASSWORD}
  • This Service can only be invoked by Tenant users after they have logged into their tenancy

After any one of the services has been executed successfully, the Username and Community User are now connected. From this point forward, when the user logs in to their tenancy, they are automatically logged in to the Community Tenant.

Sync User Profile Information

By default, the User Profile in the Community Tenant is automatically kept in sync with the user's Personal Setup Information, found in: My Information.

The following fields are automatically synchronized:

  • First Name
  • Last name
  • Email
  • Street
  • City
  • State
  • Zip
  • Country
  • Company
  • Title
  • Division
  • Phone
  • Fax
  • Mobile