This documentation relates to Confluence 3.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.

View File Macro

The view file macro allows you to embed an Office or PDF document into your Confluence page. First attach the document to a wiki page and then use the view file macro to display the document's content.

When viewing the page, users will see the content of the Office document. Users do not need to have Office installed, in order to see the content of the Office document.

Where applicable, users will be able to open the document for editing in their Office application.

This is just one of the ways Confluence can interact with Office documents. For an overview of all Office Connector features, please refer to Working with the Office Connector.

The view file macro provides several unique parameter options for some of the types of files it handles. Hence, to simplify its use, the view file macro is separated into the following four macros in the macro browser:

On this page:

Basic Usage without the Macro Browser

To use the view file macro without the macro browser, enter it directly in the Wiki Markup or Rich Text editors based on one of the following examples, along with any parameters (described below) that suit the type of file.

{viewdoc:name=my document.doc}
{viewppt:name=my presentation.ppt}
{viewxls:name=my spreadsheet.xls}
{viewpdf:name=my document.pdf}
Editing 'older style' {viewfile} macros

In Confluence 3.0, the {viewfile} macro's syntax was changed to be file type-specific (as indicated by the examples above). If your Confluence site was upgraded to Confluence 3.0 and you had existing content which used the 'older style' syntax for this macro ({viewfile}), you can still edit these macros via the macro browser. Just place your cursor inside the viewfile macro's braces and click the macro browser icon to edit it. The 'edit only' version of the view file macro will open in the macro browser, allowing you to edit its specific parameters.

Example of Usage

The live example below shows how to display an Excel spreadsheet on a Confluence page. The Excel spreadsheet is attached to this documentation page.

What you need to type What you will get
{viewxls:name=my spreadsheet.xls}
Edit Document
Task Monday Tuesday Wednesday Thursday Friday Saturday Sunday Total
11/3/08 11/4/08 11/5/08 11/6/08 11/7/08 11/8/08 11/9/08
Planning 5 3 8
Design 3 5 2 10
Development 6 5 5 16
Testing 2 3 5
Admin 1 1

Prerequisites for Viewing and Displaying Office Documents

If you want to make use of the View File macro or to view Office files attached to a wiki page, you need the setup described below.

Browsers and Flash Player

You can use any browser to view an Office file on a wiki page or attachment view, provided that you have installed Adobe Flash Player version 9 or later. You do not need to have an Office desktop application installed on your computer, in order to view Office files in Confluence.

File Types

To be displayed in Confluence, the file needs to be a valid Microsoft Office 97-2007-compatible or PDF file, of the following types:

  • .doc and .docx
  • .xls and .xlsx
  • .ppt and .pptx
  • .pdf

Above are the prerequisites for viewing or displaying Office documents in Confluence. For a full list of Office Connector prerequisites and limitations, please refer to:

Displaying a Word Document in Confluence

Usage with the Macro Browser (doc)

To insert the Office Word macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

Once you have found the Office Word macro and have added the required parameter values, click 'insert' to add it to your page.

Basic Usage with the Wiki Markup Editor (doc)

{viewdoc:name=my document.doc}

Parameters (doc)

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
File Name
(name) 		yes none The file name of the Office Word document to be displayed. The document must be attached to a wiki page on your Confluence site.
Page Name
(page) 		no The page which contains the {viewdoc} macro Enter a page name, if you wish to display a document which is attached to another Confluence page. For example: 
{viewdoc:name=my document.doc|page=Sample Page}
Space Key
(space) 		no The space of the page which contains the {viewdoc} macro Enter a space key, if you wish to display a document which is attached to a page in another Confluence space. For example: 
{viewdoc:name=my document.doc|space=DOC|page=Sample Page}
Date
(date) 		no none If the Page Name refers to a blog post instead of a conventional page, enter the date of the post in the form mm/dd/yyyy.

Editing the Word Document

When viewing a wiki page that displays an attached Office document, you can launch your Office editor directly from Confluence.

  • Move your mouse pointer to the top of the document embedded in the Confluence page, until the hidden title bar appears. (See the screenshot below.)
  • Click the title bar.
  • Confirm your action and log in as prompted.
  • The Office document will open in your Office application. Make any necessary changes, then save the document. It will be saved back into Confluence.

Screenshot: The title bar showing 'document.doc' above an embedded Office document



You will find detailed instructions in Editing an Office Document from Confluence.

Displaying a PowerPoint Presentation in Confluence

You can display an PowerPoint presentation on a Confluence page. By default, the presentation will be displayed as a dynamic slide show, using Adobe Flash Player. You can also choose to display just one of the slides as a static JPEG image.

Usage with the Macro Browser (ppt)

To insert the Office Powerpoint macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

Once you have found the Office Powerpoint macro and have added the required parameter values, click 'insert' to add it to your page.

Basic Usage with the Wiki Markup Editor (ppt)

{viewppt:name=my presentation.ppt}

Parameters (ppt)

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
File Name
(name) 		yes none This file name of the Office Excel document to be displayed. The document must be attached to a wiki page on your Confluence site.
Height
(height) 		no   Specify the height of the display, in pixels (default) or as a percentage of the window's height. For example, to specify a height of 200 pixels: 
{viewppt:name=my presentation.ppt|height=200}

This code also specifies a height of 200 pixels:

{viewppt:name=my presentation.ppt|height=200px}

This code specifies a height of 10 percent of the window's height:

{viewppt:name=my presentation.ppt|height=10%}
Page Name
(page) 		no The page which contains the {viewppt} macro Enter a page name, if you wish to display a document which is attached to another Confluence page. For example: 
{viewppt:name=my presentation.ppt|page=Sample Page}
Slide Number
(slide) 		no none Specify the number of the slide which you want displayed on the Confluence page, starting with '0' for the first slide. Instead of a slide show, the page will display just the single slide represented as a JPEG image.
Space Key
(space) 		no The space of the page which contains the {viewppt} macro Enter a space key, if you wish to display a document which is attached to a page in another Confluence space. For example: 
{viewppt:name=my presentation.ppt|space=DOC|page=Sample Page}
Width
(width) 		no   Specify the width of the display, in pixels (default) or as a percentage of the window's width. For example, to specify a width and height of 200 pixels: 
{viewppt:name=my presentation.ppt|width=200|height=200}

This code also specifies a width and height of 200 pixels:

{viewppt:name=my presentation.ppt|width=200px|height=200px}

This code specifies a width of 10 percent of the window's width:

{viewppt:name=my presentation.ppt|width=10%}
Date
(date) 		no none If the Page Name refers to a blog post instead of a conventional page, enter the date of the post in the form mm/dd/yyyy.

Viewing the Slide Show and Editing the Presentation

When you view the PowerPoint presentation on a Confluence page, options on the bottom frame of the slide show allow you to:

  • — Download the presentation and save it onto your computer.

  • — Edit the presentation in your Office application. You will find detailed instructions in Editing an Office Presentation from Confluence.

  • — Move to the first, previous, next and last slides in the presentation. Or enter a slide number to move directly to that slide.

  • — Refresh the display.

  • — Open the presentation in full-screen mode. To return to normal viewing mode, press the escape key ('Esc') on your keyboard.

Screenshot: PowerPoint presentation embedded on a Confluence page



Displaying an Excel Spreadsheet in Confluence

Usage with the Macro Browser (xls)

To insert the Office Excel macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

Once you have found the Office Excel macro and have added the required parameter values, click 'insert' to add it to your page.

Basic Usage with the Wiki Markup Editor (xls)

{viewxls:name=my spreadsheet.xls}

Parameters (xls)

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
File Name
(name) 		yes none This is the file name of the document to be displayed. The document must be attached to a wiki page on your Confluence site.
Last Column
(col) 		no Last column with content Enter the number of the last column you want displayed, starting from '0' as the first column. For example, the following code will show the first 3 rows and the first 3 columns: 
{viewxls:name=my spreadsheet.xls|col=2|row=2}
Show Grid?
(grid) 		no true Select the check box in the macro browser (true in Wiki Markup) to show grid lines around each cell of the Excel spreadsheet. Clear the check box in the macro browser (false in Wiki Markup) to hide these grid lines.
Page Name
(page) 		no The page which contains the {viewxls} macro Enter a page name, if you wish to display a document which is attached to another Confluence page. For example: 
{viewxls:name=my spreadsheet.xls|page=Sample Page}
Last Row
(row) 		no Last row with content Enter the number of the last row you want displayed, starting from '0' as the first row. For example, the following code will show the first 3 rows and the first 3 columns: 
{viewxls:name=my spreadsheet.xls|col=2|row=2}
Worksheet Name
(sheet) 		no First worksheet in the spreadsheet Enter the name of the worksheet that you want displayed.
Space Key
(space) 		no The space of the page which contains the {viewxls} macro Enter a space key, if you wish to display a document which is attached to a page in another Confluence space. For example: 
{viewxls:name=my spreadsheet.xls|space=DOC|page=Sample Page}
Date
(date) 		no none If the Page Name refers to a blog post instead of a conventional page, enter the date of the post in the form mm/dd/yyyy.

Editing the Excel Spreadsheet

When viewing a wiki page that displays an attached Office spreadsheet, you can launch your Office editor directly from Confluence.

  • Move your mouse pointer to the top of the spreadsheet embedded in the Confluence page, until the hidden title bar appears. (See the screenshot below.)
  • Click the title bar.
  • Confirm your action and log in as prompted.
  • The spreadsheet will open in your Office application. Make any necessary changes, then save the spreadsheet. It will be saved back into Confluence.

Screenshot: The title bar showing 'spreadsheet.xls' above an embedded Excel spreadsheet



You will find detailed instructions in Editing an Office Spreadsheet from Confluence.

Displaying a PDF Document in Confluence

Usage with the Macro Browser (pdf)

To insert the View PDF macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

Once you have found the View PDF macro and have added the required parameter values, click 'insert' to add it to your page.

Basic Usage with the Wiki Markup Editor (pdf)

{viewpdf:name=my document.pdf}

Parameters (pdf)

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
File Name
(name) 		yes none This is the file name of the document to be displayed. The document must be attached to a wiki page on your Confluence site.
Page Name
(page) 		no The page which contains the {viewpdf} macro Enter a page name, if you wish to display a document which is attached to another Confluence page. For example: 
{viewpdf:name=my document.pdf|page=Sample Page}
Space Key
(space) 		no The space of the page which contains the {viewpdf} macro Enter a space key, if you wish to display a document which is attached to a page in another Confluence space. For example: 
{viewpdf:name=my document.pdf|space=DOC|page=Sample Page}
Date
(date) 		no none If the Page Name refers to a blog post instead of a conventional page, enter the date of the post in the form mm/dd/yyyy.

Viewing the PDF Document

When you view the PDF document on a Confluence page, it is displayed as a slide show. Options on the bottom frame of the slide show allow you to:

  • — Download the PDF file and save it onto your computer.

  • — Move to the first, previous, next and last pages in the document. Or enter a page number to move directly to that page.

  • — Refresh the display.

  • — Open the document in full-screen mode. To return to normal viewing mode, press the escape key ('Esc') on your keyboard.

Screenshot: PDF document embedded on a Confluence page



Troubleshooting

Problems? Please refer to our guide to the Office Connector limitations and known issues.

RELATED TOPICS

Take me back to the Confluence User's Guide.

Labels

pdf pdf Delete
viewfile viewfile Delete
office office Delete
doc doc Delete
xls xls Delete
ppt ppt Delete
powerpoint powerpoint Delete
word word Delete
excel excel Delete
confluence confluence Delete
html html Delete
macro macro Delete
security security Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (79)

 

  1. Jan 09, 2009

    Anonymous says:

    The quality of my embedded PDF displayed on confluence is seriously lower than t...

    The quality of my embedded PDF displayed on confluence is seriously lower than that of the original PDF, to the point where you can't read the text in the images, and have trouble with some parts of the doc itself.

    Is this as designed? And is there a parameter I can use to disable this quality drop?

    1. Jan 09, 2009

      Patrick Rogers says:

      I'm hoping there's some help for this one.

      I'm hoping there's some help for this one.

      1. Jan 12, 2009

        Azwandi Mohd Aris [Atlassian] says:

        Hi Patrick, This issue is by design. I have seen your bug report here, however,...

        Hi Patrick,

        This issue is by design. I have seen your bug report here, however, we have an existing bug report for general Confluence users:

        As a workaround, you might want to adjust the width and height of the macro to get clearer display, for instance:

        {viewfile:my.pdf|width=800|height=1000}

        Hope that helps.

        Cheers,
        Azwandi

  2. Jan 27, 2009

    Anonymous says:

    I have a powerpoint presentation that contain mostly tables or pictures of table...

    I have a powerpoint presentation that contain mostly tables or pictures of tables.  When I attach the file and the use the viewfile macro - all of the colors and some of the gridlines in the table disappear.  Any suggestions?

    1. Feb 13, 2009

      Komathi Krishnan [Atlassian] says:

      Hi, Unfortunately, I can't seem to reproduce this problem in my local instance...

      Hi,

      Unfortunately, I can't seem to reproduce this problem in my local instance. Feel free to raise a support ticket at https://support.atlassian.com for further investigation. You might want to attach an example powerpoint slides to the ticket.

      Cheers,
      Komathi

    2. Feb 13, 2009

      Guillermo Chutrau says:

      I have a similar problem. I am never sure if a PowerPoint will be displayed corr...

      I have a similar problem. I am never sure if a PowerPoint will be displayed correctly by the viewfile macro, therefore we decided to convert all the PPT to Adobe PDF. It is very time consuming to go through each PPT (sometimes 10's or >100 slides) and compare with the original, to check if they are displayed right or wrong.

      But now, we are experiencing another, even worse, problem (look some posts below) displaying the files. They are not showing up at all.

      Good luck to us all!

  3. Feb 10, 2009

    Gary O'Brien says:

    Is it possible to allow this macro to view text attachment files. e.g. {vi...

    Is it possible to allow this macro to view text attachment files.

    e.g.

     
{viewfile:config.txt}

    would output the text with the {noformat} tags around it, so its framed and in a fixed pitch font.

    1. Feb 12, 2009

      Komathi Krishnan [Atlassian] says:

      Hi Gary, As far as I am concern the {viewfile} macro cannot render .txt file. F...

      Hi Gary,

      As far as I am concern the {viewfile} macro cannot render .txt file. Feel free to raise a future request here: http://jira.atlassian.com for future implementation.

      Cheers,
      Komathi

  4. Feb 10, 2009

    Ginil Fernandez says:

    Hi, Is it possible that I can control programatically when I change slides in t...

    Hi,

    Is it possible that I can control programatically when I change slides in the power point presentation?

    Any help would be greatly appreciated.

    Thanks

    1. Feb 18, 2009

      Komathi Krishnan [Atlassian] says:

      Hi Ginil, Unfortunately this feature is not implemented yet. Feel free to raise...

      Hi Ginil,

      Unfortunately this feature is not implemented yet. Feel free to raise a feature request at http://jira.atlassian.com. and describe more in details how you want this feature to work. Vote for it and add yourself as watcher. For further details on Implementation of New Feature and Improvement please browse to the attached link.

      Hope that helps.

      Cheers,
      Komathi

  5. Feb 12, 2009

    Guillermo Chutrau says:

    I have been having trouble displaying !xxxx.swf! I only get a blank space...

    I have been having trouble displaying 

    !xxxx.swf!

    I only get a blank space

    And

    {viewfile:xxxx.ppt} or {viewfile:xxxx.pdf}

    I get

    Alternate HTML content should be placed here. This content requires the Adobe Flash Player. Get Flash

    I recently installed Adobe Flash Player v10 , and thought that could be the cause, by I reverted to v9, and could not solve the problem.

    Have you heard any problems like these?

    Thanks.

    1. Feb 17, 2009

      Giles Gaskell [Atlassian Technical Writer] says:

      Hi Guillermo, Are you using Internet Explorer? If so, there is a known compatib...

      Hi Guillermo,

      Are you using Internet Explorer? If so, there is a known compatibility issue with Adobe Flash Player 10 and Internet Explorer, which was identified in Confluence 2.10.

      A fix for this has been implemented in Confluence 2.10.2 which is now available for download. Please see the Confluence 2.10.2 Release Notes for further information.

      Nevertheless, there should not be any problems viewing these objects with Adobe Flash Player 10 and Mozilla Firefox.

      If this is not the issue, then please feel free to log a JIRA issue.

      Best regards,

      Giles Gaskell
      Technical Writer
      ggaskell@atlassian.com
      ATLASSIAN - http://www.atlassian.com

      1. Feb 26, 2009

        John Forrest says:

        Upgrading to 2.10.2 solved my problem - thanks.

        Upgrading to 2.10.2 solved my problem - thanks.

        1. Mar 11, 2009

          Guillermo Chutrau says:

          Solved. Some problems are usually solved by rebooting the application or serve...

          Solved.

          Some problems are usually solved by rebooting the application or server, too.

          Thanks.

  6. Feb 16, 2009

    hajo van Ravenswaay says:

    Hi, At times the quality of a PDF shown with viewfile is dramatic; all text bec...

    Hi,

    At times the quality of a PDF shown with viewfile is dramatic; all text becomes blurry and detail is difficult to discern even on full-screen mode.

    The weird thing is that the PDF itself seems to be of good quality, if reading it with Adobe Reader. Any idea?

    1. Feb 16, 2009

      Azwandi Mohd Aris [Atlassian] says:

      It is known that PDF quality will decrease in the {viewfile} macro. Please see t...

      It is known that PDF quality will decrease in the {viewfile} macro. Please see the improvement request at http://developer.atlassian.com/jira/browse/WORDDV-219

  7. Mar 11, 2009

    Matt Boesch says:

    Is the view file macro (editing feature with hidden title bar specifically) and ...

    Is the view file macro (editing feature with hidden title bar specifically) and the Office Connector in general section 508 compliant (Section 508 of the Rehabilitation Act of 1973)?

    1. Mar 15, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hi, Matt. You might be interested in the following bug report, which discusses t...

      Hi, Matt. You might be interested in the following bug report, which discusses this requirement in general:

      Hope that helps!

  8. Mar 11, 2009

    Guillermo Chutrau says:

    Viewfile is not working with the new MS Office versions of powerpoint and word (...

    Viewfile is not working with the new MS Office versions of powerpoint and word (pptx, and docx).

    Viewfile is not displaying PDF's created from the new MS Office suite either

    Do you know if there is any work done to support those?

    Thank you

    1. Mar 15, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hi, In case you have not seen them, the following are related improvement reque...

      Hi,

      In case you have not seen them, the following are related improvement requests:

      Confluence uses Apache POI to extract the contents of the Microsoft Office documents. In the advent of support for Office 2007 (Office Open XML Support) files in the current beta version of the library, this might be possible in the near future. Please watch the bug reports to keep yourself updated. Hope that helps!

      Cheers,
      Azwandi

  9. Mar 24, 2009

    Michael Vescovo says:

    Hi. While the view file macro seems to work well, the performance is too slow t...

    Hi.

    While the view file macro seems to work well, the performance is too slow to be a practical feature. It might take 30 seconds to load an excel file into a webpage. Everything else seems to run nice and fast.

    Is it normal for it to take ages to load spreadsheets? I hate to imagine how slow it would be if multiple people tried to use it at the same time.

    Sometimes I also get an error which I think is related to memory as I ran the command to use 512RAM and that fixed the problem for one spreadsheet. Is it supposed to use lots of memory?

    If it is normal to be slow and performance hungry is there another way to be able to open, edit and save spreadsheets from confluence? The only other way I can find is with webdav (which has it's own problems and I don't want to make it available to everyone). How come when I open spreadsheets from the attachments page it can't just open it the same way it does from the view file macro? that is how come I can't save them? Is there a way to make this work? a plugin maybe? Or is this by design so you can keep track of versioning etc?

    1. Mar 30, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hello Michael, Some conversions will take longer, especially for documents cont...

      Hello Michael,

      Some conversions will take longer, especially for documents containing complex data, charts, images, figures, etc. Perhaps, the request WORDDV-126 - Conversion queue to optimize performance would be a relief for this issue. However, if you encounter an outstanding out of memory problem due to simple conversion, please do let us know.

      Opening the attachments from the attachments page will only ask your browser to download a copy of the attachment and place it in your machine's temp folder - your OS will then open that in an appropriate application.

      Cheers,
      Azwandi

  10. Apr 01, 2009

    Neeraj Jhanji says:

    Hello, When using the viewfile macro in Confluence 2.10.1 to display the conten...

    Hello,

    When using the viewfile macro in Confluence 2.10.1 to display the contents of a Powerpoint file with Japanese text,
    nothing was displayed.

    Is this a known issue with double-byte characters and is there a solution to this problem?

    thanks,

    Neeraj

    1. Apr 02, 2009

      Zed Yap [Atlassian] says:

      Hi Neeraj, I have reply through this link: http://confluence.atlassian.com/dis...

      Hi Neeraj,

      I have reply through this link:

      http://confluence.atlassian.com/display/CONFEXT/Office+Connector+plugin?focusedCommentId=182682317#comment-182682317

      Best rgds,
      Zed

  11. Apr 09, 2009

    Shawn Stepper says:

    Is there a way to specify a sheet number instead of a sheet name when using view...

    Is there a way to specify a sheet number instead of a sheet name when using viewfile with Excel files? I'm using scaffolding and reporting to allow end users to select the excel file they want to display, and to select which sheet to display. But I have no way to know the sheet names, so I want to use sheet numbers.

    Thanks!

    1. Aug 10

      Sashidaran Jayaraman [Atlassian] says:

      Hi Shawn, I am afraid that this is not currently possible in Confluence. Feel f...

      Hi Shawn,

      I am afraid that this is not currently possible in Confluence. Feel free to raise a feature request at http://jira.atlassian.com. and describe in detail how you require this feature to work. Please add yourself as a watcher, vote for this feature and add your own comments to this feature request. For further details on how we include new features and improvements, you might want to read this page

      Hope that helps.

      Cheers
      JSashi

  12. Apr 09, 2009

    Mark DeSimone says:

    Using this for Word documents does not always work when it has been created on a...

    Using this for Word documents does not always work when it has been created on a Mac with Microsoft Word 2008. The error is:

    Any ideas?

    If I take the same doc and open it up in Word on Windows, re-post it, the macro works.

    1. Aug 11

      Azwandi Mohd Aris [Atlassian] says:

      Hi Mark, Sorry if this comes in a little late - I stumbled across your comment ...

      Hi Mark,

      Sorry if this comes in a little late - I stumbled across your comment just now. As far as I know, the macro does not support files created in Microsoft Word 2008 (Mac) yet. This might be related to WORDDV-101, too.

      Cheers,
      Azwandi

  13. Apr 22, 2009

    Anonymous says:

    Hi, Can the Viewfile macro be made compatible with office 2007? i.e the ma...

    Hi,

    Can the Viewfile macro be made compatible with office 2007? i.e the macro should accept the following types of files:

    .pptx

    .xlsx

    .docx

    Thanks!

    Shampa Dasgupta

    1. Apr 22, 2009

      Mark Hrynczak [Atlassian] says:

      Hi Shampa, The issue for tracking this improvement request is at CONF-12006. Y...

      Hi Shampa,

      The issue for tracking this improvement request is at CONF-12006.

      You can add yourself as a watcher on the issue to be notified of progress.

      Cheers,
      Mark

  14. Apr 26, 2009

    Linden Hocking says:

    I'm running 2.8.2 and all staff had flash player 9 installed and the viewfile fo...

    I'm running 2.8.2 and all staff had flash player 9 installed and the viewfile for powerpoint files was working fine.  Everyone in the company has been upgraded to flash player 10 and now the viewfile for powerpoint files is giving a blank screen.

    Is there a reason why its not working with Adobe Flash player 10?

    Thanks

  15. Apr 27, 2009

    Linden Hocking says:

    I found uninstalled the office connector from the plugins repository and reinsta...

    I found uninstalled the office connector from the plugins repository and reinstalling it fixed the problem.

    1. May 07, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hello Linden, I am not sure if these are related, but you might want to check t...

      Hello Linden,

      I am not sure if these are related, but you might want to check them out:

      It might be probable that you were using older version of the Office Connector plugin. Then, re-installation has installed the latest version containing the fix.

      Cheers,
      Azwandi

  16. Apr 27, 2009

    Krzysztof Gabruk says:

    Would it be possible to render the content of the file (Excel) as a wiki text wh...

    Would it be possible to render the content of the file (Excel) as a wiki text whith links to the pages in confluence?

    Eg. I have a page called ABC. In the uploaded Excel I refer to the page ABC (by mens of plain text not by hyperlink). In viefile mode the link is not recognised.

    1. Jun 17, 2009

      Arie Murdianto says:

      Hi Krzysztof, Yes, you cant do that. Because the macro will only convert the co...

      Hi Krzysztof,

      Yes, you cant do that. Because the macro will only convert the content of your excel file to HTML directly without further processing in Confluence. Because the macro that you use in Confluence is actually a macro which needs Confluence's processing. While viewfile macro is macro outside Confluence core code. So, you need a complete URL address of the page so that you can click it.

      Cheers,

  17. May 01, 2009

    Marten Vanderheiden says:

    This is what we get in our environment when clicking on an excel spreadsheet nam...

    This is what we get in our environment when clicking on an excel spreadsheet name that is using the viewfile macro.

    Could not open 'http://confluence.atlassian.com/plugins/servlet/webdav/Global/DOC/Confluence Documentation Home/Confluence User Guide/Working with Macros/View Fiew Macro/my spreadsheet.xls'.

    Microsoft Office Excel cannot access the file 'http://confluence.atlassian.com/plugins/servlet/webdav/Global/DOC/Confluence Documentation Home/Confluence User Guide/Working with Macros/View Fiew Macro/my spreadsheet.xls'. There are serveral possible reasons:

    • The file name of path does not exist.
    • The file is being used by another program.
    • The workbook you are tryign to save has the same name as a currently open workbook.

    Has anyone else come across this issue? We can open the file if we go to the Attachments sections but not from the macro itself.

    1. Jun 17, 2009

      Arie Murdianto says:

      Hi Marten, Please raise a support ticket to https://support.atlassian.com, so ...

      Hi Marten,

      Please raise a support ticket to https://support.atlassian.com, so that your problem can be investigated.

      Cheers,

  18. May 03, 2009

    Kris Berden says:

    We played around with this macro using an Excel file and found that you risk ove...

    We played around with this macro using an Excel file and found that you risk overwriting each others work when 2 or more people change the Excel file at the same time.

    Is it possible to lock a file while it is beeing edited?

    If locking is not possible a warning sign that the file is beeing edited on the webpage containing the Office file would also be great.

    Thanks,

    Kris

    1. May 05, 2009

      Zed Yap [Atlassian] says:

      Hi Kris, As far as i know, the feature requested is not available yet. You migh...

      Hi Kris,

      As far as i know, the feature requested is not available yet. You might want to
      raised a feature request in JIRA.

      Also, you might want to try the Attachment Checkout Plugin.
      Where this plugin might fullfill some of your requirement.

      Best rgds,
      Zed

      1. May 05, 2009

        Kris Berden says:

        Hi Zed, thanks for the reply but  concerning the Attachment Checkout Plugin...

        Hi Zed, thanks for the reply but  concerning the Attachment Checkout Plugin, I read in the Known Issues that this macro is not compatible with the Viewfile macro  so i thought it makes no sense to use it but I will give it a try and see where we get.

        Best regards,

        Kris

  19. May 28, 2009

    Michael Kimber says:

    Just started trying to us the viewfile macro, however we have hit two issues: ...

    Just started trying to us the viewfile macro, however we have hit two issues:

    • When prompted for a username and password, it does not take any of our username and passwords. We have LDAP integration with Active Directory. Is there something we are missing
    • If we :
      • attach a excel document (would be nice if it supported URL links)
      • reference it from the page using viewfile
      • then open the Spreadsheet change it i.e. delete a load of cells and save it to the hard disk
      • then delete the attachment and re-upload, the Spreadsheet rendering on the Wiki page does not change. I tried purging the attachment cache but this did not help

    Again are we missing something?

    1. Aug 11

      Azwandi Mohd Aris [Atlassian] says:

      Hi Michael, Judging by your description, I would suggest you to raise a support...

      Hi Michael,

      Judging by your description, I would suggest you to raise a support ticket in case the problem remains unresolved.

      Cheers,
      Azwandi

  20. Jun 05, 2009

    Anna Si says:

    I am getting the error message " Error formatting macro: viewfile: java.lan...

    I am getting the error message " Error formatting macro: viewfile: java.lang.NullPointerException" when clicking the "view" link on the attachment page. Did anyone else have the same issue? Thanks.

  21. Jun 15, 2009

    Anonymous says:

    why can't i change height on word documents like i can do for powerpoint ?

    why can't i change height on word documents like i can do for powerpoint ?

    1. Jun 23, 2009

      Zed Yap [Atlassian] says:

      Hi, As far as I know, the height parameter only apply to view Powerpoint and PD...

      Hi,

      As far as I know, the height parameter only apply to view Powerpoint and PDF. You might want to
      raise an improvement request on this issue in JIRA:

      In the mean time, I have mere suggestion. You might want to try to use the HTML macro to control the height of the word
      document.

      I have created an example shown below, hopefully this will give you some idea on it:

      {html}
<table border='0' height='500' width='300' align='left'>
<tr>
<td valign='top'>
{html}
{viewfile:xxxx.doc}
{html}
</td>
</tr>
</table>
{html}

      Hope that helps.
      Best rgds,
      Zed

  22. Jun 16, 2009

    Linden Hocking says:

    I've found a bit of an issue with numbering being thrown out when using the...

    I've found a bit of an issue with numbering being thrown out when using the viewfile macro with word documents.
    If I have a word document with the following headings:

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

    1.  Heading one
               (a) Heading two
               (b) Heading three
    2.  Heading four
               (a) Heading five

    -------------------------------------
    It shows this
    ---------------------------------------

    1.  Heading one
               (a) Heading two
               (b) Heading three
    2.  Heading four
               (c) Heading five

    1. Jun 22, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hi Linden, Unfortunately, I was not able to reproduce this locally on a Conflue...

      Hi Linden,

      Unfortunately, I was not able to reproduce this locally on a Confluence 3.0 and 2.10.3 instance. You might want to check that the numbering in the Word document is correct (try closing and reopening it in Word).

      Cheers,
      Azwandi

      1. Jun 24, 2009

        Linden Hocking says:

        Hi Azwandi I've tried this with several documents and get the same result each ...

        Hi Azwandi

        I've tried this with several documents and get the same result each time.

        We use customised heading styles, which is what I think may be causing the problem.

        It would be good to give you one of the documents that's it happening with, but there's no option to attach files.

        Linden

        1. Aug 12

          Azwandi Mohd Aris [Atlassian] says:

          Hi Linden, Sorry if this is a little too late. However, if the problem remains ...

          Hi Linden,

          Sorry if this is a little too late. However, if the problem remains unresolved, feel free to raise a support ticket for further investigation. In the meantime, I would suggest you to temporarily disable the customisation and see if the problem persists.

          Cheers,
          Azwandi

  23. Jun 23, 2009

    Anonymous says:

    I want the wiki to display a word document attached to the page.  I attache...

    I want the wiki to display a word document attached to the page.  I attached the document and typed:

    viewdoc: The viewfile macro is unable to locate the attachment "rounds_visdev_5.11.09.doc" on this page

    However, I get this display:

    What am I doing wrong?  Or is there another macro command for displaying an attached document?

    1. Jun 24, 2009

      Sashidaran Jayaraman [Atlassian] says:

      Hi, Please raise a support ticket to https://support.atlassian.com, so that you...

      Hi,

      Please raise a support ticket to https://support.atlassian.com, so that your issue can be further investigated. Also provide the following:

      1. Wiki markup used for the above issue
      2. Word processor that you used and the version
      3. A sample of a word document that can reproduce the issue
      4. The exact error that you receive when you used the viewdoc macro
      5. A copy of your Confluence log files located at <confluence-home>/logs/atlassian-confluence.log
      6. A saved copy of System Info via Administration -> System Information

      Cheers,
      JSashi

  24. Jul 20, 2009

    Matt Johnson says:

    Hello, Is there a way to prevent the download option from being shown when usin...

    Hello,

    Is there a way to prevent the download option from being shown when using the viewpdf

    macro? Or is there some other way to display a PDF in a non-downloadable format?

    Thank you,

    MJ

  25. Jul 21, 2009

    Guillermo Chutrau says:

    I am using Adobe Pro v9, and none of the pdf's I am creating display with the vi...

    I am using Adobe Pro v9, and none of the pdf's I am creating display with the viewfile macro (confluence 2.9). Any clues? Should we reboot the server, re-install plug-in?

    Help needed

    1. Jul 28, 2009

      Azwandi Mohd Aris [Atlassian] says:

      Hi Guillermo, I'd suggest you to test the plugin with a PDF which is not create...

      Hi Guillermo,

      I'd suggest you to test the plugin with a PDF which is not created by Adobe Pro v9. Perhaps, you can try exporting this page to PDF and use it in your instance. If that works, there must be something wrong with the PDF you have created. Otherwise, please check that your browser can actually display Flash files.

      Cheers,
      Azwan

  26. Aug 05, 2009

    Anonymous says:

    I am using viewfile for displaying a excel files.  For the most part the fe...

    I am using viewfile for displaying a excel files.  For the most part the feature works as expected.  However, I have two problems.

    1) Excel graphs are not displaying at all.

    2) When I hide rows and columns in Excel the columns are hidden correctly in Confluence.  However the rows that are hidden in Excel are displayed in Confluence.

    Any suggestions on how to resolve these would be appreciated!

    Thanks,

    Chuck

    1. Aug 12

      Sashidaran Jayaraman [Atlassian] says:

      Hi Chuck, I am not able to reproduce your first problem. Excel graphs are displ...

      Hi Chuck,

      I am not able to reproduce your first problem. Excel graphs are displaying properly in Confluence. I would suggest you to raise a support ticket to https://support.atlassian.com, so that your issue can be further investigated. Also provide the following:

      1. Wiki markup used for the problem
      2. Word processor that you used and the version
      3. A sample of an Excel file that can reproduce the issue
      4. A copy of your Confluence log files located at <confluence-home>/logs/atlassian-confluence.log
      5. The system information page. You can obtain the page by accessing the http://<path-to-confluence>/500page.jsp

      As for your second issue, I could not even hide the columns in my instance. I would suggest you to raise a new feature request at http://jira.atlassian.com as for this issue.

      Cheers
      JSashi

      1. Aug 17

        Anonymous says:

        Jsashi, Thank you for your reply.  I just confirmed that I can in fact hid...

        Jsashi,

        Thank you for your reply.  I just confirmed that I can in fact hide columns but not rows.  I will enter a Jira ticket on this.

        As for the graph display, I did some more experimenting.  As long as the charts are on the same tab as the data used to generate them, they display.  If the charts on a different tab and I reference the tab with the charts on them, they are not displayed.

        Thanks again,

        Chuck

        1. Aug 18

          Sashidaran Jayaraman [Atlassian] says:

          Hi Chuck, I notice that you have raised a support ticket regarding this issue. ...

          Hi Chuck,

          I notice that you have raised a support ticket regarding this issue. We will get back to you as soon as we can. Kindly follow up from the support ticket.

          Cheers
          JSashi

  27. Sep 09

    Anonymous says:

    Hi, I would like to just list the attachments using viewfile, rather than viewin...

    Hi, I would like to just list the attachments using viewfile, rather than viewing them. 

    Viewfile creates a link that opens the file via webdav in word/excel/ppt etc.  This "link" is all I want to list.  T

    his seems like the best place to request this since viewfile leverages the document object calls correctly in both FF and IE.

    viewfile: The viewfile macro is unable to locate the attachment "MyDoc.doc" on this page

    "Click to Edit in Word The Attached File: MyDoc.doc"

    1. Oct 30

      Martin Stangenberg says:

      Hi, I absolutely agree with that. This is a feature I am missing as well. Editi...

      Hi,

      I absolutely agree with that. This is a feature I am missing as well. Editing documents using the viewfile's webdav launcher is so much easier compared to the conventional way, which is like: open an attachment, save a copy to disk, edit the doc, and finally upload it again as attachment.

      Is there any other way to open documents via webdav from within Confluence?

      Thanks,

      Martin

      1. Nov 23

        Azwandi Mohd Aris [Atlassian] says:

        Hi guys, I believe that this feature is being addressed in our current beta rel...

        Hi guys,

        I believe that this feature is being addressed in our current beta release of 3.1. You can try it on this instance; visit the Attachments of this page and you should see there is a direct link to edit Office documents. You can use the {attachments} macro in case you would like to display the list in a Confluence page.

        Hope that helps.

        Cheers,
        Azwandi

        1. Nov 23

          Martin Stangenberg says:

          Hi Azwandi, that sounds exactly like what I was looking for. I'll give it a try...

          Hi Azwandi,

          that sounds exactly like what I was looking for. I'll give it a try as soon as I have upgraded to 3.1

          Thanks a lot.

          Martin

  28. Nov 02

    Anonymous says:

    Can i use this with Version: 2.2.3

    Can i use this with Version: 2.2.3

    1. Nov 10

      Jack Low [Atlassian] says:

      Hi, Unfortunately, this plugin is not supported in Confluence 2.2.3. You can ref...

      Hi,
      Unfortunately, this plugin is not supported in Confluence 2.2.3. You can refer to Office Connector Product Compatibility to check it's compatibility.

      Meanwhile, confluence 2.2.3 had reached it's end of support life. Are you interested in doing an upgrade?

      Cheers,

  29. Nov 03

    Anonymous says:

    When using viewfile to view a word document, I am losing some formatting.  ...

    When using viewfile to view a word document, I am losing some formatting. 

    1. Extra spaces used for precise formatting are removed thereby messing up the formatting of the data.  Tabs do work, but because of the nature of what we are doing, are difficult to set up.
    2. text highlighting is not being displayed.

    Any suggestions?

    1. Nov 09

      Sashidaran Jayaraman [Atlassian] says:

      Hi, For 1, the reason why it seems to have stripped the extra spaces is due to ...

      Hi,

      For 1, the reason why it seems to have stripped the extra spaces is due to HTML treating multiple spaces as one. You can edit the same document and you will realise the formatting will still be retained in the Word Processor. As a workaround, you might want to use a hidden table (table without borders) to format your data.

      As for the text highlighting, I guess this is a limitation of the Office Connector plugin. Feel free to raise a feature request at http://jira.atlassian.com. and describe in detail how you require this feature to work. Please add yourself as a watcher, vote for this feature and add your own comments to this feature request. For further details on how we include new features and improvements, you might want to read this page

      Cheers
      JSashi

  30. Dec 16

    Christopher Christophorou says:

    Hi, I was wondering if it's possible to hide the contents of a document when us...

    Hi,

    I was wondering if it's possible to hide the contents of a document when using the viewfile macro, and just display the link that allows you to edit the file.

    Thanks,

    Chris

    1. Dec 17

      Royce Wong says:

      I haven't come across a case where my users want to do this. Won't the users vie...

      I haven't come across a case where my users want to do this. Won't the users view the file when they are editing the file anyway? Can you explain? Edit what file? Word, Excel, PDF?

      This might help: http://confluence.atlassian.com/display/DOC/Edit+in+Word+Link+Macro

      1. Dec 17

        Anonymous says:

        Hi Royce, They would like to have the link to edit the document, but not displa...

        Hi Royce,

        They would like to have the link to edit the document, but not display the content on the page itself. (Word, or Excel)
        I was just wondering if it was possible.

        Thank you for the link, I will take a look.

        Chris

  31. Dec 17

    Royce Wong says:

    The viewfile macro uses the temp directory: <confluence_home>/viewfile. I ...

    The viewfile macro uses the temp directory: <confluence_home>/viewfile. I am an admin, can I delete files in that directory directly? Any affect on Confluence indexing and such?

    1. Dec 22

      Royce Wong says:

      I deleted files older than 30 days in viewfile dir., no problem. # cd <confl...

      I deleted files older than 30 days in viewfile dir., no problem.

      # cd <confluence_home>/viewfile/
# find . -mtime +30 -exec ls -lst {} \; | more
# find . -mtime +30 -exec rm {} \;

  32. Dec 23

    kulls says:

    Hi, Is it possible to connect JIRA from Excel using macros. Please advise me i...

    Hi,

    Is it possible to connect JIRA from Excel using macros.

    Please advise me if there are any resources available for me to read and try out this.

    thanks,

    Kulls

    1. Jan 12

      Jack Low [Atlassian] says:

      Hi Kulls, The {viewxls:} will render whatever content in your excel file. In oth...

      Hi Kulls,
      The {viewxls:} will render whatever content in your excel file. In other words, if you wish to have links that link back to JIRA issues, you must provide the link in your excel file, for example:

      1. You can export your JIRA search result to Microsoft Excel, the issue key in search result will contain a link to corresponding JIRA issue (if you are using Confluence 3.1, make sure the excel file is in 2007 format by re-opening and re-saving the excel file into .xlsx format)
      2. Upload the excel file to desire page, render it with {viewxls:name=file_name.xlsx} macro
      3. By now, you should be able to see a page with JIRA links

      Hope my suggestions would help.

      Regards,
      Jack

      1. Jan 15

        Mike Naylor says:

        Is there any way to do this with internal Confluence links (such as [childpage])...

        Is there any way to do this with internal Confluence links (such as [childpage]) or do they have to be fully qualified?

        1. Jan 19

          Jack Low [Atlassian] says:

          Hi Mike, The links need to be provided in the excel file. I'm afraid we can't li...

          Hi Mike,
          The links need to be provided in the excel file. I'm afraid we can't link them via internal Confluence links.

          Hope my explanations would have cleared your doubts.

          Regards,
          Jack

  33. Dec 30

    Sally says:

    We just upgraded from Confluence 2.92 to 3.02 and for some reason the viewfile p...

    We just upgraded from Confluence 2.92 to 3.02 and for some reason the viewfile plug-in is no longer working for new pages.  I tried the

    viewfile: No attachment name specified

    macro as well as the

    viewxls: No attachment name specified

    macro and nothing will show up.  Anyone else have this problem?

    1. Dec 31

      Sashidaran Jayaraman [Atlassian] says:

      Hi Sally, Please raise a support ticket to https://support.atlassian.com, so th...

      Hi Sally,

      Please raise a support ticket to https://support.atlassian.com, so that your issue can be further investigated. Also provide the following:

      1. Wiki markup used for the above issue
      2. Word processor that you used and the version
      3. A sample of a document that can reproduce the issue
      4. The exact error that you receive when you used the viewxls macro
      5. A copy of your Confluence log file located at <confluence-home>/logs/atlassian-confluence.log
      6. The system information page. You can obtain the page by accessing the http://<path-to-confluence>/500page.jsp
      7. A screenshot of Dashboard > Administration > Plugins > Office Connector plugin
      8. Screenshots that illustrate the problem.

      Cheers
      JSashi

      1. Jan 20

        Anonymous says:

        Will do, thanks!

        Will do, thanks!

  34. Feb 03

    Lumina Purandare says:

    Hi Would it be possible to document a small note in the Viewfile macro section ...

    Hi

    Would it be possible to document a small note in the Viewfile macro section for displaying word documents. This note will be to indicate to the user that the fonts from the word document recognized by confluence are displayed as is, however if the word document contains a font that confluence does not recognize, then it will display it using the default font of the confluence page if there is such a notion.

    Thank you

    Cheers
    Lumina

Add Comment