xAssist SAP FSM Extension Installation - TeamViewer Support
<main> <article class="userContent"> <p><br></p><h2 data-id="customer-requirements">Customer Requirements</h2><p>The extension requires the setup of an OAuth2 client for the FSM Account and appropriate access permissions for each company. <strong>This needs to be done to enable the installation of the extension.</strong></p><p><br></p><h3></h3><h2 data-id="account-information">Account Information</h2><p>You need to provide the technical names of the account and company in FSM along with the cluster their instance is installed in. This information can be found in the administration panel as shown in the images below:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/O4LFYU4OAQ3H/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/O4LFYU4OAQ3H/image.png" alt="image.png" height="246" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-1"></h3><h2 data-id="company-information">Company Information</h2><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/DAYUOCTEM1RW/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/DAYUOCTEM1RW/image.png" alt="image.png" height="272" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>In the above example images, the information required is:</p><ul><li>Account name: <em>Teamviewer-demo</em>, </li><li>Company: <em>DemoCompany1</em>, </li><li>Cluster: <em>DE</em></li></ul><p>📌<strong>Note:</strong> The extension can support more than one company, please specify all companies that will use it.</p><p><br></p><h3 data-id="-2"></h3><h2 data-id="user-group">User Group</h2><p>The extension requires only a few permissions to function. It acts as a ‘Dispatcher’ in the sense that it reads ‘ServiceCall’ and ‘Activity’ objects and then creates an ‘Attachment’ object for the matching ‘ServiceCall’. It will also delete created assets in case of updates.</p><p>You can either decide the use the existing ‘Dispatcher’ role in FSM or you can create a new one to be used by the client. One way to create a suitable group is copying the existing ‘Dispatcher’ group.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/A8OKX0EE6FQJ/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/A8OKX0EE6FQJ/image.png" alt="image.png" height="387" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/1UJT4Q4RIDCF/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/1UJT4Q4RIDCF/image.png" alt="image.png" height="357" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>With this copy you can then further restrict the access if required, e.g. you can remove ‘Create’ and ‘Delete’ permissions for all objects (except for ‘Attachment’ objects).</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/YO0VX1S3K6K1/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/YO0VX1S3K6K1/image.png" alt="image.png" height="418" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-3"></h3><h2 data-id="client">Client</h2><p>To technically access the FSM the extension requires an OAuth2 client setup.</p><p>In the FSM ‘Clients’ configuration, you need to create a new client.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/OMPTOYLIS4LL/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/OMPTOYLIS4LL/image.png" alt="image.png" height="266" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>You can either accept the new randomly generated client id or define your own. Make sure to assign the previously generated ‘User Group’ for each company.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/2IHXLJ8XFAR5/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/2IHXLJ8XFAR5/image.png" alt="image.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>⚠ <strong>Important note: </strong>When saving make sure to note down the generated client secret. This is required by the TeamViewer Solution Delivery Team to provide the extension instance.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/D9Y4M4Q38TBI/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/D9Y4M4Q38TBI/image.png" alt="image.png" height="359" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>With the access permissions set and the client id and client secret pair TeamViewer can provision the extension for the FSM account. Provide the <strong>client id</strong> and <strong>client secret</strong> over a secure communication channel to your TeamViewer contact.</p><p>📌<strong>Note:</strong> The FSM team is working on a way to make this step easier in the future.</p><p><br></p><h3 data-id="-4"></h3><h2 data-id="extension-installation-in-fsm">Extension Installation in FSM</h2><h3 data-id="extension-link">Extension Link</h3><p>After the extension instance has been provisioned an Extension Access URL will be provided by TeamViewer that is used to install the extension.</p><p><br></p><h3 data-id="installation">Installation</h3><p>The extension is installed via the ‘Foundational Services’ configuration in the ‘Installed’ overview.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/LGNJAHMJSEH8/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/LGNJAHMJSEH8/image.png" alt="image.png" height="89" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>📌<strong>Note: </strong>There will be an Extension tile in the FSM Directory for the integration, but the installation will only be supported via custom URL provisioning upon request.</p><p>Selecting ‘Add Extension’ prompts you for the URL provided by TeamViewer.</p><p><strong>📌Note: </strong>Please type in the URL exactly as provided (it may end with a ‘/’ that is required).</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/IZDSC1P78JJ8/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/IZDSC1P78JJ8/image.png" alt="image.png" height="286" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Review settings and allow data sharing with the extension.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/5LSVI20GXUMV/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/5LSVI20GXUMV/image.png" alt="image.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>In the last step, you can optionally put the extension into your sidebar. You can uncheck this if you would like to manually add the extension later.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/6EQJY6CIDMR5/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/6EQJY6CIDMR5/image.png" alt="image.png" height="328" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Done! The extension is now available.</p><p><br></p><h3 data-id="sidebar">Sidebar</h3><p>If you selected to not install the extension into the sidebar at first, you can do so manually.</p><p>Open the <strong>Extension Configuration</strong> of your sidebar.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/2ESYABAI5FV4/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/2ESYABAI5FV4/image.png" alt="image.png" height="322" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Click on <strong>Add Extension</strong></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/W62R6WBU0L3B/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/W62R6WBU0L3B/image.png" alt="image.png" height="272" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Select <strong>Frontline xAssist</strong></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/JPY9O0VFEY3Q/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/JPY9O0VFEY3Q/image.png" alt="image.png" height="367" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Click <strong>Add</strong>. Close the <strong>Extension Configuration</strong>.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/PG9L41G3EXVK/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/PG9L41G3EXVK/image.png" alt="image.png" height="278" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>The extension is now installed!</p><p><br></p><h3 data-id="-5"></h3><h2 data-id="uninstalling-removing-from-sidebar">Uninstalling / Removing from Sidebar</h2><p>You can safely uninstall or remove the extension at any time. While your instance is still valid you can later reinstall or reenable the extension with the same Extension Access URL.</p> </article> </main>
