Setting up the connection and access data is essential for communication between the PowerPoint plugin and the 4ALLPORTAL. Once the connection has been established, you have to log in with your 4ALLPORTAL user details (username and password) to use the plugin.


Contents


Connection data

To connect the PowerPoint Plugin to the 4ALLPORTAL server, you need the URL to your 4ALLPORTAL as well as an active user account, consisting of user name and password.


For example:  http(s)://YOUR-4ALLPORTAL-URL


Storage of user data - Windows Credential Manager

By entering the credentials, the PowerPoint Plugin saves them in your own Windows Credential Manager in the category "Windows Credentials". You can recognize the entry by its 4ALLPORTAL-URL.

When you start the plugin, the last credentials entered are automatically used to log on to the 4ALLPORTAL. So you do not have to enter your credentials every time.


You can remove or edit the credentials in the login information management, as long as you have the necessary administration rights for your PC.


Setting Up Connection Data and Access Details

There are two different ways to set up connection data and access details.


Option 1: Setting up the connection data and access details via the plugin:

When starting up the PowerPoint plugin, you are asked to enter the connection data and access details.

 

Option 2: Setting up the connection data via software distribution:

The connection data has already been set up by a system administrator so all you have to do is enter your access details when launching the plugin for the first time. This may be the case if software distribution is used for the installation and maintenance of the PC systems within your company. 



Option 1: Setting up the connection data and access details via the plugin  (end user)


  1. Open the “Insert” ribbon in PowerPoint and click on the “User” button.




  2. Enter the URL of your 4ALLPORTAL in the “URL” field and then click on the “Enter/Change” button.


    For example: Enter a URL for the 4ALLPORTAL

    IMPORTANT: Ensure the connection data you enter is accurate. If you enter an incorrect URL or system name, this data will be stored to your computer. Only an administrator can reset/change the connection data saved to your computer. For additional support, consult the 4ALLPORTAL – PowerPoint Plugin installation guide.


  3. Enter your 4ALLPORTAL access details, comprising your username and password, in the designated fields and then click on the “OK” button.

    Tip:You will be automatically logged into the 4ALLPORTAL the next time you launch the plugin if you activate the “Save login details” checkbox to save your access details in the Windows user administration area. 



  4. Once you have successfully connected and logged into the 4ALLPORTAL, the “User details” window opens and you will see your user name under “Logged in as:”.

    Note: If you have not successfully logged in, you will receive a notification from the system. In this case, reopen the user menu as described in Step 1 and reenter your access details. If the message continues to appear, please contact your in-house administrator to check the URL you have entered (see note in Step 2).


    For example: Connection and login successful

  5. Clicking on the “Save” button closes the “User details” window.

  6. Clicking on the “4ALLPORTAL Media” button now allows you to launch the PowerPoint plugin. 


Option 2: Setting up the connection data via software distribution (system administrators only)

Connection data can be configured on the client computers via software distribution. The end user no longer has to configure the connection personally as described in Option 1.


The “Config.xml” configuration file allows you to incorporate the connection data into the plugin. The information is transferred into the “user.Config.xml” the first time the plugin is launched. This involves “user.Config.xml” being saved under the “AppData folder” of the respective Windows user. For this reason, it is important to ensure the plugin is not launched by an end user before you have carried out the configuration via software distribution.


Note: The userConfig.xml has a higher ranking than the Config.xml. If you would like to change the connection data at a later stage, follow the instructions from the step following the “Change connection data” step.


  1. Create the config.xml (UTF8). You can use the following code block to this end.

    <?xml version="1.0" encoding="utf-8"?> <Config xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <StartURL>https://samplename.4allportal.net/</StartURL> <LoginLinkPart>/service/usermanagement/login</LoginLinkPart> <MediaLinkPart>/service/ppt/getmedia</MediaLinkPart> <UpdateRequestLinkPart>/service/ppt/getupdates</UpdateRequestLinkPart> <MamServerLinkPart>4allportal-object_selection/index.html?module=file&view=object_selection</MamServerLinkPart> </Config>
    XML
  2. Enter the URL of your 4ALLPORTAL with a / after the domain in the <StartURL>...</StartURL> tag (see code block).

  3. Alternatively, our 4ALLPORTAL support has already preconfigured the config.xml file for you.

  4. Store the config.xml in the PowerPoint plugin installation folder via software distribution.

    “/Programs(x86)/4ALLPORTAL/PowerPoint Add-In/config.xml”

  5. Your user can now start the plugin. All you have to do is enter your access details to log into the 4ALLPORTAL.


Managing user data

If you would like to change the connection data at a later stage, you can edit or delete the userConfig.xml under the folder path:

“/User/Username/AppData/Local/4ALLPORTAL/PowerPoint Add-In”


Edit:
This allows you to change the connection data on the client computer.

Delete:
This allows you to reconfigure the connection data with the config.xml.