Cherwell Service Management Integration - Installation and User Guide - TeamViewer Support
<main>
<article class="userContent">
<p><br></p><h2 data-id="general">General</h2><div class="blockquote"><div class="blockquote-content"><p class="blockquote-line"><em>This article applies to customers with a Premium or Corporate subscription license.</em></p></div></div><p><br></p><h3></h3><h2 data-id="platform-requirements">Platform requirements</h2><p>Platform Version Requirements: 9.3.2 or later.</p><p>Out-of-the-Box Content Version Requirements: 9.3.2 or later (exception 9.4.0a)</p><p><br></p><h3 data-id="-1"></h3><h2 data-id="overview">Overview</h2><p>The TeamViewer mergeable application (mApp™) integrates TeamViewer remote control and chat capabilities with CSM. The integration allows CSM users to initiate remote control sessions from within an Incident.</p><p>This mApp includes multiple features, including Stored Values (Client ID, Client Secret, State Value for Browser, Browser Close TeamViewer Session), Web Services (TeamViewer Authorization, TeamViewer Sessions, TeamViewer retrieve code), and One-Steps (Create TeamViewer Session, Close TeamViewer Session, Send TeamViewer Session Email, Automated Delete of TeamViewer Session, Browser Client TeamViewer Token Section, Browser Close TeamViewer Session), Business Objects to store TeamViewer Data (TeamViewer Session, TeamViewer Token), Stored Expression (CurrentDatePlusOneDay) Images (TeamViewer.jpg), and an Automation Process (Automated TeamViewer Cleanup) .</p><p><br></p><h3 data-id="-2"></h3><h2 data-id="how-the-mapp-works"><strong>How the mApp Works</strong></h2><p>CSM provides the TeamViewer integration as a mApp so that Users can easily incorporate remote session functionality into their existing CSM system.</p><p>The mApp includes the following items:</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/6VFMVOAVBP6R/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/6VFMVOAVBP6R/image.png" alt="image.png" height="881" width="908" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><h3 data-id="-3"></h3><h2 data-id="applying-the-teamviewer-mapp">Applying the TeamViewer mApp</h2><p>To apply the mApp, perform the following high-level steps (the screenshots provided may vary, depending on systems and versions):</p><p>1) Download the mApp from the CSM <em>mApp Exchange </em>and save it to a location where you have access to apply it to your system.</p><p>2) Apply the mApp using the Apply mApp wizard in CSM Administrator. The Apply mApp wizard generates a Blueprint. </p><div class="embedExternal embedImage display-medium float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/L12RPHA0XQ4X/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/L12RPHA0XQ4X/image.png" alt="image.png" height="258" width="283" loading="lazy" data-display-size="medium" data-float="none"></img></a>
</div>
</div>
<div class="embedExternal embedImage display-medium float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/DHLP8AASTAJ9/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/DHLP8AASTAJ9/image.png" alt="image.png" height="257" width="276" loading="lazy" data-display-size="medium" 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/lithium_attachments/17944iCD8771451010334F.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17944iCD8771451010334F.jpg" alt="Cherwell_3.png" height="180" width="320" 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/lithium_attachments/17945i78E7E8D6CB4321AC.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17945i78E7E8D6CB4321AC.jpg" alt="Cherwell_4.png" height="180" width="320" 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/lithium_attachments/17946iA8BF22F4004F16A4.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17946iA8BF22F4004F16A4.jpg" alt="Cherwell_5.png" height="180" width="320" 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/lithium_attachments/17947iBA353B522F5E8DB6.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17947iBA353B522F5E8DB6.jpg" alt="Cherwell_6.png" height="180" width="320" 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/lithium_attachments/17948i7D8D0FBDE0111064.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17948i7D8D0FBDE0111064.jpg" alt="Cherwell_7.png" height="180" width="320" 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/lithium_attachments/17949iC83523A16A30009D.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17949iC83523A16A30009D.jpg" alt="Cherwell_8.png" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p></p><p><br></p><p>3) While in the newly created Blueprint, select the Business Object, select , scroll to the bottom of the forms on the left pane and drag the TeamViewer form to the Tabs section of the screen. Right click on the TeamViewer tab and you are able to select or deselect an icon for the tab. Select the Green Checkbox to add this action to the Blueprint. </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/lithium_attachments/17950i9AA3BE8E0291A2AF.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17950i9AA3BE8E0291A2AF.jpg" alt="Cherwell_9.png" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p>4) This Blueprint can now be viewed and published to a test or live system to commit the changes.</p><p><br></p><h3 data-id="-4"></h3><h2 data-id="teamviewer-mapp-for-csm-desktop-client">TeamViewer mApp for CSM Desktop Client</h2><p>When complete, there will be a new Tab on the Incident business object with the integration controls ready to use. </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/lithium_attachments/17952i475605588F31E085.jpg" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/17952i475605588F31E085.jpg" alt="Cherwell_10.png" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p> </p><h2 data-id="using-the-teamviewer-mapp">Using the TeamViewer mApp</h2><p>To use the TeamViewer mApp, you must have a licensed CSM user and valid TeamViewer credentials. You must be viewing a saved incident from either the Desktop or Browser Client.</p><p>To <strong>Create</strong> a TeamViewer session within CSM:</p><p>While in the Incident ticket, run the One-Step™ from the button on the TeamViewer Tab on the Incident form (Desktop Client or CSM Browser Client 10.0). If a requestor is defined in the ticket, their email address will be used for the TeamViewer session invitation email.</p><ol><li></li><li>When using the <strong>Desktop</strong> client, a pop-up will appear within CSM, asking you to logon via a browser session to TeamViewer, prompting you for your TeamViewer credentials, after that process has completed and your information is validated, you will receive a message from TeamViewer to return to the Cherwell record you were working on. In that record, click the Close on the Pop up and the process will continue. An email will be generated to be sent to the customer of that record with the link. After sending the email, the <strong>Join As Admin</strong> button will appear and you can then launch the TeamViewer Session.</li></ol><p>When using the <strong>Browser</strong> client, a pop-up will appear within CSM, asking you to login via a browser session to TeamViewer, prompting you for your TeamViewer credentials, click ok. After that process has completed and your information is validated, you will receive a message from TeamViewer to return to the Cherwell record you were working on. In that record, click the Refresh button then go back to the TeamViewer Tab and click the Part 2 Browser button and the process will continue. An email will be generated to be sent to the customer of that record with the link. After sending the email, the <strong>Join As Admin</strong> button will appear and you can then launch the TeamViewer Session.</p><p>When the customer accesses the URL in the email, the TeamViewer session will be active.</p><p><strong>To Close a TeamViewer session within CSM:</strong></p><ol><li>While in the Incident ticket, run the One-Step™ from the button on the form (Desktop Client or CSM Browser Client). The related Session will send a Close to TeamViewer and will delete the related TeamViewer Session. (note: if a user does not have a current Active Token record, the close button will need to be pressed a second time due to a bug found in the process).</li></ol><p>To <strong>Send</strong> an Email link to the current session within CSM:</p><ol><li>While in the Incident ticket, run the <strong>Share Session</strong> One-Step™ from the button on the form (Desktop Client or CSM Browser Client). The related Session will send an email to the current customer with the Customer Link.</li></ol><p><br></p>
</article>
</main>