Difference between revisions of "Community Tenant"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Β 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
==About the Community Tenancy==
The ''Community Tenant'' supports features like [[Marketplace]] that can be shared by all users of an [[Installable Version]] instance, regardless of which tenancy they normally log into. Β 
The Community Tenancy feature can be used by [[ISV]]s to create community applications 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.
Internally, it works by automatically syncing user information between a user's normal tenancy and the Community Tenant, so users can access applications in the Community Tenant without requiring a separate platform login.
{{tenantfeatures|}}


==How it Works==
{{ServiceOption|Community Site Configuration|On|On}}
The [[ISV]] creates a new [[Tenant|Tenancy]], which serves as host to the Community. This Tenancy is managed via a login account, called the ''Community User''.
Β 
All new Users in all the tenancies (under a single [[ISV]]) are then automatically associated with the Community account. This provides single sign-on capability via the community user credentials.
Β 
If the Community Tenancy feature 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|Enabling a Community Tenant with Existing Users]]''
Β 
==Configure a Community Tenancy==
#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]]
#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 tenancy to see the list of site users
::*The ''Community User'' associated with the Community Tenancy is based on the [[Username]]:
:::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 Tenancy application whenever they login to their tenancy
:*Users are automatically logged out from the Community Tenancy application whenever they log out from the tenancy
:*After the Community Tenancy is enabled, the User object in the community tenant should not have any required, user-defined field, otherwise addition of Users or Tenants will fail
::*If ISVs is not planning to expose the Community Tenancy application registration to the public unless they also register for tenancy then the Community Tenancy username will never by needed by users and they need not know about this
Β 
:*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 Tenant with Existing Users===
To add existing Users in existing Tenancies to a Community Tenancy, complete the following steps:
Β 
#Create a Registration [[Page]] in the Community Tenancy
#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:
::*Via [[Community Resource#Link_a_User_to_the_Community|Link a User to the Community]]
::*Via the following service:
:::<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
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 Tenancy.
Β 
==Sync User Profile Information==
By default, the User Profile in the Community Tenancy 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
<noinclude>
<noinclude>


[[Category:Tenant Management]]
[[Category:Glossary]]
</noinclude>
</noinclude>

Latest revision as of 02:53, 14 January 2015

The Community Tenant supports features like Marketplace that can be shared by all users of an Installable Version instance, regardless of which tenancy they normally log into.

Internally, it works by automatically syncing user information between a user's normal tenancy and the Community Tenant, so users can access applications in the Community Tenant without requiring a separate platform login.

Lock-tiny.gif

  • The Community Tenant option is managed by the Service Provider.
  • In an on-premise installation, the default setting is On.
  • In the cloud, this setting is On.
    (This setting can be modified only in an On-Premise Installation.)
Learn more: Community Site Configuration