[Rt-commit] rt branch, 4.2/add-feed-docs, updated. rt-4.1.6-415-ge1ca8fd

Jim Brandt jbrandt at bestpractical.com
Wed Jul 24 16:45:24 EDT 2013


The branch, 4.2/add-feed-docs has been updated
       via  e1ca8fd9c5cd9c3494fedd6acb400932bb26e94b (commit)
      from  ead6750acff723f1c17c3475c50da027a54f4076 (commit)

Summary of changes:
 docs/reporting/feeds.pod | 69 ++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 58 insertions(+), 11 deletions(-)

- Log -----------------------------------------------------------------
commit e1ca8fd9c5cd9c3494fedd6acb400932bb26e94b
Author: Jim Brandt <jbrandt at bestpractical.com>
Date:   Wed Jul 24 16:43:31 2013 -0400

    Additional feed doc updates
    
    Add Excel instructions, add Google Calendar mention, link to
    TimeInICal, make SingleEvent=1 clearer.

diff --git a/docs/reporting/feeds.pod b/docs/reporting/feeds.pod
index 3de02e1..81260e9 100644
--- a/docs/reporting/feeds.pod
+++ b/docs/reporting/feeds.pod
@@ -26,9 +26,51 @@ you need (sorted, summed, etc.) you can sometimes reproduce the report
 back in RT. This has the advatage of making it dynamic and you can share
 the resulting report with other users as a shared search or dashboard.
 
+Depending on your browser brand and settings, the downloaded spreadsheet
+may be given a .xls extension, a .tsv extension, or no extension at all.
+If it gets a .xls extension, the spreadsheet file will likely already be
+associated with a spreadsheet application. In this case, you can
+double-click on the file to open it. You may see a warning about the file
+format, since it is a tsv file and not a .xls file, and then the application
+will either convert the file automatically or open a dialog to guide you.
+
+If your system doesn't automatically associate the tsv file, the following
+sections describe how to manually import a tsv file in some common
+applications.
+
+=head3 Importing into Microsoft Excel
+
+If the file is given a .tsv extension or no extension, here's how to open
+it in Excel 2010:
+
+=over
+
+=item 1.
+
+Select File > Open, locate the file on your system and click Open.
+
+=item 2.
+
+In the Text Import Wizard, select Delimited, import starting at row 1,
+and leave the default File origin. Click Next.
+
+=item 3.
+
+In the Delimiters section, select Tab if it isn't selected by default.
+Leave the other settings with default values. Click Next.
+
+=item 4.
+
+The last dialog lets you define the column formats for the imported columns.
+You can also exclude some columns from the import. 'General' will try to
+guess for you. Click Finish.
+
+=back
+
 =head3 Importing into OpenOffice
 
-To open a tsv in OpenOffice:
+If OpenOffice doesn't automatically open the Text Import dialog when
+you try to open the file, here's how to open a tsv manually:
 
 =over
 
@@ -43,7 +85,7 @@ Select Insert > Sheet From File...
 =item 3.
 
 In the file selection dialog, find the file downloaded from RT. By default,
-the name is Results.tsv.
+the name is Results.
 
 =item 4.
 
@@ -67,9 +109,9 @@ ticket, and the content of the first transaction on the ticket.
 
 The iCal link uses your search to provide a feed suitable
 for subscribing to from a calendaring application like Mozilla Lightning
-(the Thunderbird calendar), Microsoft Outlook, or Apple iCal. You can
-copy the link and use your calendar application's subscribe feature to
-pull in and display ticket dates.
+(the Thunderbird calendar), Google Calendar, Microsoft Outlook, or Apple
+iCal. You can copy the link and use your calendar application's subscribe
+feature to pull in and display ticket dates.
 
 The feed provides Starts and Due dates from the selected tickets. In
 RT 4.0, the calendar events are day-long events, which can be handled
@@ -77,12 +119,17 @@ differently in different calendar applications. The events also contain
 a URL linking to the ticket and some calendars will display this link
 with the event.
 
-RT 4.2 adds an option to include times in the iCal feed so you can
-have calendar events at a specific time. In addition, you can provide
-C<SingleEvent=1> as an additional query parameter to have tickets
-generate a single event using the Start and Due dates/times as the
-start and end values for the event. This is useful if you have tickets
-with shorter durations, like for scheduled maintenance for example.
+RT 4.2 adds the L<RT_Config/$TimeInICal> option, which will include times
+in the iCal feed so you can have calendar events at a specific time. In
+addition, you can provide C<SingleEvent=1> as an additional query parameter
+to have tickets generate a single event using the Start and Due dates/times
+as the start and end values for the event. You can put the parameter on the
+end of the iCal feed URL, for example:
+
+    https://myrt.example.com/NoAuth/iCal/user/...?SingleEvent=1
+
+This is useful if you have tickets with shorter durations, like scheduled
+maintenance for example.
 
 =head2 Secret Tokens
 

-----------------------------------------------------------------------


More information about the Rt-commit mailing list