LogMeIn Rescue API User Guide

getReportArea_v6

Displays the report type that is currently set for retrieval. You can set the report area in the Reports tab of the Rescue Administration Center. For information on reports, see Generating Reports in the LogMeIn Rescue Administration Center User Guide.

Changes in Version 6 of getReportArea

The following report area has been introduced in the getReportArea_v6 method:
Transferred Sessions - Extended report
This API method retrieves reports about transferred sessions.

Input Parameters

Element Description
authcode The secret authentication code that is used to authenticate the user without logging in to Rescue. Optional.

Output

OK AREA:16
AREA: Report area

The following report areas are available:

  • 0 - Session report
  • 1 - Customer Survey report
  • 2 - Login report
  • 3 - Missed Sessions report
  • 4 - Performance report
  • 5 - Chat Log report
  • 6 - Custom Fields report
  • 7 - Transferred Sessions report
  • 8 - Technician Survey report
  • 9 - Collaboration Chatlog report
  • 10 - Failed Sessions report
  • 12 - External Collaboration Chatlog report
  • 13 - Customer Survey Issuance report
  • 15 - Rebooting/Reconnecting report
  • 16 - Transferred Sessions - Extended report

Return Values

Displayed Return Value Description
ERROR An unspecified error occurred, such as timeout.
OK Retrieving the report type succeeded.
NOTLOGGEDIN Retrieving the report type failed because the current user is no longer logged in.
INVALID_SECRETAUTHCODE The secret authentication code for the user is invalid.
USER_DELETED_OR_DISABLED The user is deleted or disabled.

Sample Code

The following are examples for using the getReportArea_v6 method that you can call in your environment.

HTTP GET

https://secure.logmeinrescue.com/API/getReportArea_v6.aspx?authcode=4ahx...80u0

HTTP POST

<form method="post" action="https://secure.logmeinrescue.com/API/getReportArea_v6.aspx">
        <input name="authcode" value="4ahx...80u0">
</form>

SOAP

For sample SOAP 1.1 and SOAP 1.2 request and response messages, visit https://secure.logmeinrescue.com/api/API.asmx?op=getReportArea_v6.

PHP with SOAP

The example values shown must be replaced with actual values.

<?php
$soapclient = new SoapClient("https://secure.logmeinrescue.com/api/api.asmx?wsdl");

//define parameters
$loginparams = array (
'sEmail' => 'some@email.com',
'sPassword' => 'secretPassword'
);

//login
$loginResult = $soapclient->login($loginparams);

//print the result
echo "<b>Login full response.</b><br />";		//formatting
print_r($loginResult);
echo "<br /><br />";					//formatting

$sAuthCode = "4ahx...80u0";

//define parameters
$reportarams = array (
'sAuthCode' => $sAuthCode
);

//login
$getReportArea_v6Result = $soapclient->getReportArea($reportareaparams);

//print the result
echo "<b>getReportArea_v6 full response.</b><br />";	//formatting
print_r($getReportArea_v6Result);
echo "<br /><br />";					//formatting

?>

C# with HttpWebRequest

The example values shown must be replaced with actual values.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Net" %>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <% 
     string sEndpoint = "https://secure.logmeinrescue.com/API/";  //add actionName.aspx? for each action called
     string sEmail = "some@email.com";
     string sPwd = "secretPassword";
     string sAuthCode = "4ahx...80u0";

     //set up the request
     HttpWebRequest oReq = (HttpWebRequest)System.Net.WebRequest.Create(sEndpoint + "login.aspx" + "?email=" 
+ sEmail + "&pwd=" + sPwd);
    
     //create a cookie container to store the cookies for this session 
     oReq.CookieContainer = new CookieContainer();
          
     //get the response
     HttpWebResponse oResp = (HttpWebResponse)oReq.GetResponse();

string sResp = new StreamReader(oResp.GetResponseStream()).ReadToEnd();
Response.Write("Login result: " + sResp + "<br />");  //You can customize the response

/*
//debug cookies
foreach (Cookie cook in oResp.Cookies)
{
Response.Write("Cookie:" + "<br />");
Response.Write("Name: " + cook.Name + " " + "Value: " + cook.Value + "<br />");
Response.Write("Domain: " + cook.Domain + "<br />");
Response.Write("Path: " + cook.Path + "<br />");
Response.Write("Port: " + cook.Port + "<br />");
Response.Write("Secure: " + cook.Secure + "<br />");

Response.Write("When issued: " + cook.TimeStamp + "<br />");
Response.Write("Expires: " + cook.Expires + " " + "Expired? " + cook.Expired + "<br />");
Response.Write("Don't save: " + cook.Discard + "<br />");
Response.Write("Comment: " + cook.Comment + "<br />");
Response.Write("Uri for comments: " + cook.CommentUri + "<br />");
Response.Write("Version: RFC " + cook.Version + "<br />");
    
// Show the string representation of the cookie.
Response.Write("String: " + cook.ToString());
}*/
     
//add cookies to cookie container
CookieContainer sessioncookie = oReq.CookieContainer;

//get the ReportArea info
HttpWebRequest oReqReportArea = (HttpWebRequest)System.Net.WebRequest.Create(sEndpoint 
+ "getReportArea_v6.aspx?authcode=" + sAuthCode);
oReqReportArea.CookieContainer = sessioncookie;

HttpWebResponse oRespReportArea = (HttpWebResponse)oReqReportArea.GetResponse();
string sRespReportArea = new StreamReader(oRespReportArea.GetResponseStream()).ReadToEnd();
Response.Write("getReportArea_v6 result: " + sRespReportArea + "<br />");  //You can customize the response

%>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Rescue API getReportArea_v6 Test</title>
</head>
<body>

</body>
</html>

C# with SOAP

The example values shown must be replaced with actual values.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using apiSamples.WebServiceClients;

namespace apiSamples
{
    public partial class SOAP : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            try
            {
                WebServiceClients.API proxy = new WebServiceClients.API();
                proxy.CookieContainer = new CookieContainer();

                string sEmail = "some@email.com";
                string sPwd = "secretPassword";
                string sAuthCode = "4ahx...80u0";
                REPORT_V6 eReportArea;

                WebServiceClients.getReportAreaRet oGetReportArea = proxy.getReportArea_v6(sAuthCode, out eReportArea);
                Response.Write(oGetReportArea + "<br />");

                Response.Write(eReportArea);
            }
            catch (Exception ex)
            {
                Response.Write(ex.Message);
            }
        }
    }
}