Community
Allows you to view a community. The community is a collection of users who have one or more agents or profiles that match specified query Text, or that match agents or profiles of the specified user.
NOTE: For the Community
action to work correctly, you must have a reasonable number of users on your system, with a reasonable number of profiles and agents.
You must specify the community that you want to find by specifying at least one of Text, AgentName, PID, UID, or UserName. If you specify multiple values, Text takes priority.
The Community
action prints the user name and agent name of agent results by default.
Example
http://12.3.4.56:9000/action=Community&UserName=Administrator
This action requests the community agents and profiles that are similar to the agents and profiles of the Administrator user.
Required Parameters
You must set at least one of the following parameters.
Parameter | Description |
---|---|
AgentName | The name of the agent to match. |
PID | The ID of a profile to query the community with. |
Text | Query text. |
UID | The ID of the user to match agents and profiles for. |
UserName | The name of a user to match agents and profiles for. |
Optional Parameters
This action accepts the following optional parameters.
Parameter | Description |
---|---|
Agents | Whether agents can be used by the action. |
AgentsFindAgents | Whether agents can be matched by agents. |
AgentsFindProfiles | Whether agents can be matched by profiles. |
DeferLogin | Whether user authentication is managed by another system. |
DREQueryParameter | A Query action parameter to add to the action. |
EmailAddress | The e-mail address of the user. |
ExpandQuery | Whether to expand the query to include similar terms. |
FieldFieldName | Creates a field associated with the specified user. |
FindNamedArea | Restricts matching profiles to the specified area. |
NamedArea | Restricts profiles for querying to the specified area. |
OutputEncoding | The encoding of text that the action returns. |
Profile | Whether the action can match profiles. |
ProfileMaxNumber | The maximum number of profile results to return. |
ProfileMaxScore | The maximum profile relevance score to return. |
ProfileMinScore | The minimum profile relevance score to return. |
ProfilesFindAgents | Whether to match profiles against agents. |
ProfilesFindProfiles | Whether to match profiles against profiles. |
Security | Creates a security field for the user to store the security details for the user. |
UserFieldName | The name of a field that must match in a user’s profile. |
UserFieldValue | The value of a field that must match in a user’s profile. |
This action accepts the following standard ACI action parameters.
Parameter | Description |
---|---|
ActionID | A string to use to identify an ACI action. |
EncryptResponse | Encrypt the output. |
FileName | The file to write output to. |
ForceTemplateRefresh | Forces the server to load the template from disk. |
Output | Writes output to a file. |
ResponseFormat | The format of the action output. |
Template | The template to use for the action output. |
TemplateParamCSVs | A list of variables to use for the specified template. |