IDOL Server 12.13

# AgentCopy

Allows you to copy an agent. You can use this action to set up a new agent that shares all or most of the details of an existing agent.

You must specify the agent to copy by setting one of the following parameter combinations:

- AID
- AgentName and UserName
- AgentName and UID

To copy the agent to a new user, set DestinationUserName. You can optionally also set DestinationAgentName.

To copy the agent to create a new agent for the same user, set DestinationAgentName.

## Example

    http://12.3.4.56:9000/action=AgentCopy&UserName=Administrator&AgentName=Global+Warming&DestinationUserName=NewUser&DestinationAgentName=Global

This action copies the `Global Warming` agent details for the `Administrator` user to the `Global` agent for the `NewUser` user.

## Required Parameters

You must set at least one of the following parameters.

Parameter | Description
--- | ---
AgentName | The name of the agent to copy.
AID | The agent ID of the agent to copy.
DestinationAgentName | The name of the new agent.
DestinationUserName | The user name of the user that the new agent belongs to.
UID | The ID of the user that the agent to copy belongs to.
UserName | The user name of the user that the agent to copy belongs to.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
DeferLogin | Use another system for user authentication.
EmailAddress | The e-mail address of the user.
FieldFieldName | A field for the new agent.
InputEncoding | The encoding of the AgentName and UserName values.
OutputEncoding | Converts the encoding of the text that the action returns.
Security | A field for the user to store user security details.

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.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.13 | Last updated October 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Server 12.13

Topic Title: AgentCopy