Skip to main content

Reassign Actions Installation Guide

Raise a support ticket

DISCLAIMER​

Any advice FYB provide in relation to setting up any FYB App, FYB Add-in, FYB Connector and or advice in relation to opening access to your on-premises or in the cloud systems will be general advice only. This means that the advice is of a general nature and will not consider your network setup, network infrastructure or any security requirements that you may have or in fact need. It is highly advised that you seek advice from internal or external providers to ensure that they are comfortable with what is required prior to going ahead with any deployment, setup, or configuration for external access.

LICENSE DETAILS​

Please contact FYB for a valid license if you are yet to obtain one for your Connector.

INSTALLATION COMPONENTS​

The following installation components are required to ensure full functionality of the FYB Reassign Actions, these are server-side components:

  • Reassign Actions Add-in

INSTALLING THE REASSIGN ACTIONS ADD-IN​

INSTALLATION​

  1. Create an FYB Add-Ins folder on the appropriate server that contains Content Manager

    image.png

  2. Right-click on the FYB Add-ins folder > Properties > click on the Sharing tab

    image.png

  3. If the Network Path is set to ‘Not Shared’, click on the Advanced Sharing button

    image.png

  4. In the Advanced Sharing window, enable the ‘Share this folder’ option and remove the space between FYB and Add-ins, then add a ‘$’ sign which will keep the folder hidden

    image.png

  5. Click the Permissions button

  6. Give Everyone the Full Control permission

    image.png

  7. A Network Path will now be available (this path is needed during the installation and settings setup)

  8. Create an appropriate folder to house the license file (.lic) on the server. For Example: \server\FYBAddins\License You will be asked to enter this location when configuring the application settings.

  9. Move the license file into the license folder

  10. Launch the reassignactions-xxx-32bit/64bit.msi

  11. Click on the Next button

    image.png

  12. On the Configuration Settings screen, enter the dataset ID, temp path, license path (network share), and search string

    Note

    License and Temp paths should be network shared paths. For example, \server\fybaddins$\Reassign Actions\

    image.png

    NAMEDESCRIPTION
    Dataset IDThe two-character dataset identifier
    Workgroup Server NameThe workgroup server name to connect the dataset. Either the workgroup server name or URL can be used for the connection.
    Workgroup Server URLThe workgroup server URL to connect the dataset. Either the workgroup server name or URL can be used for the connection.
    License PathThe shared path to your license file, including '.lic'
    Temp PathThe shared path to the temporary directory for Reassign Actions
    Search StringA filter string that determines what will appear in the location search window. The search automatically filters to include only active and internal locations. Leave this string blank to include all location types.
    For Example:
    type:person // filter to only show locations of type person
    type:person,group // filter to only show people and groups
  13. If your environment is configured to only allow OpenId authentication (e.g. Azure AD or ADFS) for your Content Manager, you'll receive the following message:

    image.png

    Note

    If you have not already, please ensure you are using a Workgroup Server URL not the Workgroup Server Name for the connection defined on the previous screen

  14. Click OK to navigate to the Open Id settings screen and enter the required values.

    2024-07-24_10-55-02.png

    Note

    Please refer to the below guides on how to configure the Confidential Client App and Trusted User:

    NAMEDESCRIPTION
    Client IdThe Client/App Id of the Open Id application used to secure Content Manager. For ADFS authentication, this will be the username of the Confidential Client app.
    Client SecretThe Client/App Secret of the Open Id application used to secure Content Manager. For ADFS authentication, this will be the password of the Confidential Client app.
    Trusted UserThe Network Login value of the Content Manager Confidential Client app location. For ADFS authentication, this will be the username of the Confidential Client app.
  15. On the Email Notification Settings screen, enter the sender, addressee, mail host, and mail port

    image.png

    NAMEDESCRIPTION
    SenderThe email address that email notifications are to be sent from.
    Ideally, it should be set to a do not reply account or equivalent
    AddresseeThe email address of the recipient of the email notifications, i.e., an administration account
    Mail HostThe email hosting service that operates the email server
    Mail PortThe port to be used to connect to the mail host
    SMTP username (optional)The username used to authenticate with your SMTP server
    SMTP password (optional)The password used to authenticate with your SMTP server

    2021-02-18_11-44-00.png

  16. From the Confirm Installation window, click Install

    2021-02-18_12-04-37.png

  17. The installation will commence

  18. Once the installation is complete, click on the Finish button

    image.png

COMMAND-LINE ARGUMENTS (OPTIONAL)​

The following command-line arguments can be passed to the MSI if required.

ARGUMENTPURPOSE
DBIDThe two-character dataset identifier
LICENSE_PATHThe shared path to your license file, including '.lic'
TEMP_PATHThe shared path to the temporary directory for Reassign Actions
SEARCH_STRINGA filter string that determines what will appear in the location search window. The search automatically filters to include only active and internal locations. If no search string is required, do not include this field
SENDERThe email address that email notifications are to be sent from
ADDRESSEEThe email address of the recipient of the email notifications
MAIL_HOSTThe email hosting service that operates the email server
MAIL_PORTThe port to be used to connect to the mail host
INSTALLFOLDERThe nominated installation directory

CONFIGURATION​

REASSIGN ACTIONS TO ME​

  1. In Content Manager (Context) navigate to the Administration Ribbon and click External Links

    image.png

  2. Right-click, and select the New External Link option

    image.png

  3. From the external link type list, select External executable and click on the OK button

    image.png

  4. Under Link name, enter Reassign Actions to Me

  5. Under ‘Folder or Subfolder’, enter the Network Location of the FYB Add-ins\Reassign Actions\Reassign To Me folder

    NOTE

    Please use the fully qualified domain name (FQDN) when adding the External Links to stop security prompts For Example: If the share has been set up as \server\FYBAddIns$\Reassign Actions\Reassign To Me
    The FQDN is \server.domain.local\FYBAddIns$\Reassign Actions\Reassign To Me
    You can obtain the FQDN from the Server you are installing at Computer > Properties

  6. Under Executable file name browse to the Reassign To Me folder and select the executable file

    image.png

  7. Enable the Link supports tagged processing option

  8. Under Command line parameters when doing tagged processing enter ^!Urilist^

  9. Enable the Use tagged command line format for single selection option

    image.png

  10. Select the Usage (Record) tab.

  11. Tag each of the appropriate record types.

    image.png

  12. Click on the OK button

REASSIGN ACTIONS TO SOMEONE ELSE​

  1. In Content Manager (Context) navigate to the Administration Ribbon and click External Links

    image.png

  2. Right-click, and select theNew External Link option

    image.png

  3. From the external link type list, select External executable and click on the OK button

    image.png

  4. Under Link name, enter Reassign Actions to Someone Else

  5. Under ‘Folder or Subfolder’, enter the Network Location of the FYB Add-ins\Reassign Actions\Reassign To Someone Else folder

    NOTE

    Please use the fully qualified domain name (FQDN) when adding the External Links to stop security prompts For Example: If the share has been set up as \server\FYBAddIns$\Reassign Actions\Reassign To Someone Else
    The FQDN is \server.domain.local\FYBAddIns$\Reassign Actions\Reassign To Someone Else
    You can obtain the FQDN from the Server you are installing at Computer > Properties

  6. Under Executable file name browse to the Reassign To Someone Else folder and select the executable file

    image.png

  7. Enable the Link supports tagged processing option

  8. Under Command line parameters when doing tagged processing enter ^!Urilist^

  9. Enable the Use tagged command line format for single selection option

    image.png

  10. Select the Usage (Record) tab.

  11. Tag each of the appropriate record types.

    image.png

  12. Click on the OK button

COMPLETE CURRENT ACTION​

  1. In Content Manager (Context) navigate to the Administration Ribbon and click on the External Links button

    image.png

  2. Right-click, and select the New External Link option

    image.png

  3. From the external link type list, select External executable and click on the OK button

    image.png

  4. Under Link name, enter Complete Current Action

  5. Under ‘Folder or Subfolder’, enter the Network Location of the FYB Add-ins\Reassign Actions\Complete Current Action folder

    NOTE

    Please use the fully qualified domain name (FQDN) when adding the External Links to stop security prompts For Example: If the share has been set up as \server\FYBAddIns$\Reassign Actions\Complete Current Action
    The FQDN is \server.domain.local\FYBAddIns$\Reassign Actions\Complete Current Action
    You can obtain the FQDN from the Server you are installing at Computer > Properties

  6. Under Executable file name browse to the Complete Current Action folder and select the executable file

    image.png

  7. Enable the Link supports tagged processing option

  8. Under Command line parameters when doing tagged processing enter ^!Urilist^

  9. Enable the Use tagged command line format for single selection option

    image.png

  10. Select the Usage (Record) tab.

  11. Tag each of the appropriate record types.

    image.png

  12. Click on the OK button

REASSIGN ACTIONS CONFIG​

  1. In Content Manager (Context) navigate to the Administration Ribbon and click on the External Links button

    image.png

  2. Right-click, and select New External Link

    image.png

  3. From the external link type list, select External executable, click OK

    image.png

  4. Under Link name, enter Reassign Actions Config

  5. Under ‘Folder or Subfolder’, enter the Network Location of the FYB Add-ins\Reassign Actions\ folder

    NOTE

    Please use the fully qualified domain name (FQDN) when adding the External Links to stop security prompts For Example: If the share has been set up as \server\FYBAddIns$\Reassign Action
    The FQDN is \server.domain.local\FYBAddIns$\Reassign Actions
    You can obtain the FQDN from the Server you are installing at Computer > Properties

  6. Under Executable file name browse to the Reassign Actions folder and select the executable file

    2021-02-18_16-11-27.png

  7. Enable the Link supports tagged processing option

  8. Under Command line parameters when doing tagged processing enter ^!Urilist^

  9. Check Use tagged command line format for single selection

    image.png

  10. Select the Usage (Record) tab.

  11. Tag each of the appropriate record types.

    image.png

  12. Click on the OK button

UNINSTALLING FYB REASSIGN ACTIONS​

REMOVE FROM CONTENT MANAGER​

  1. In Content Manager (Context) navigate to the Administration Ribbon and click on the External Links button

  2. Right-click on the Reassign Action external link you want to remove > Properties

    image.png

  3. Copy the folder path from the Folder or Sub Folder field

    image.png

  4. Navigate to the folder by pasting the path in a window browser to the Reassign Actions folder

    image.png

  5. Delete the Reassign Actions folder and its contents

  6. Redirect back to Content Manager click on Administration > External Links

  7. Right-click on the Reassign Action external link you want to remove, and click on the Remove option

    image.png

  8. The external link will be removed from Content Manager

UNINSTALL WITH MSI​

To uninstall FYB Reassign Actions using the MSI please follow the steps below:

  1. Double click on reassignactions-xxx-32bit/64bit.msi

  2. The Reassign Actions uninstallation window will appear

  3. Click on the Next button

    image.png

  4. Click on the Remove button

    image.png

  5. On the next window click on the Remove button

image.png 6. The application uninstallation process will commence 7. Click on the Finish button

image.png