Visio plugin

Description | Installation | Usage | Compatibility | Documentation | Release history | Open Issues | Screenshots
Name Visio Plugin
Vendor Bob Swift and other contributors
Authors Bob Swift
Homepage http://confluence.atlassian.com/display/CONFEXT/Visio+Plugin
Issue Management http://developer.atlassian.com/jira/browse/CVP
Categories Content Macros
Version 1.0
Availability Confluence v2.5.2 to v2.10-m1
State Stable
Support Unsupported Plugins
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Visio+Plugin
Java API Docs n/a
Download Source http://svn.atlassian.com/svn/public/contrib/confluence/visio-plugin/trunk
Download JAR visio-plugin-1.0.jar

Description

Macro to display Visio diagrams on a Confluence page. This uses an IE Visio viewer control and needs Internet Explorer (IE) or Firefox IE tab for rendering. The Visio viewer browser control is required and will be installed on first use based on user acceptance.

Installation

Install using the Confluence Repository Client or upload it to Confluence. Installing Plugins Overview has more detailed instructions.

Usage

{visio:^diagram.vsd}

{visio:page^diagram.vsd|height=400|bgColor=silver}

{visio:space:page^diagram.vsd|page=true|pageTab=true|toolbar=true}

{visio:file=space:page^diagram.vsd|pageIndex=2|zoom=.5} 

Download statistics

Date 2008-Mar 2008-Apr 2008-May 2008-Jun 2008-Jul 2008-Aug 2008-Sep
Hits 286 273 232 260 235 229 37

Compatibility

Plugin 2.5 2.6 2.7 2.8 Tested releases
1.0.0 2.5.2, 2.7.1, 2.8

Documentation

See the external content section in the notation guide on your installation after you install the plugin.

Parameters

  • file - A required parameter that is equivalent to the default parameter. It specifies the location of the Visio file.
    • ^attachment - Data is read from an attachment to the current page.
    • page^attachment - Data is read from an attachment to the page name provided.
    • space:page^attachment - Data is read from an attachment to the page name provided in the space indicated.
  • width - The width of the Visio diagram in pixels or percent. Default is 100%.
  • height - The height of the Visio diagram in pixels. Default is 700.
  • bgColor - Background color of the diagram. Default is 'white'.
  • pageView - Show Visio page view. Default is 'false'.
  • pageColor - Page color shown in page view. Default is 'silver'.
  • grid - Grid is shown in page view. Default is 'false'.
  • pageTabs - Show Visio page tabs. Default is 'false'.
  • pageIndex - Page index to show initially. Default is '0' to show page when diagram was saved.
  • scrollBars - Show diagram scroll bars. Default is 'false'.
  • toolbar - Show toolbar. Default is 'false'.
  • contextMenu - Allows showing of viewer control menu with right click. Default is 'true'.
  • propertyDialog - Allows showing of the properties dialog from the context menu. Default is 'true'.
  • zoom - Zoom value. Default is '-1'. Specify a zoom percentage as a fraction (for example, 0.5 for 50% and 1.0 for 100%) or use any of the following values:
    • -1 = Whole page view
    • -2 = Page width view
    • -3 = Last zoom percentage
  • highQuality - Show diagram in highest quality (slower to display). Default is 'true'.
  • alerts - Show viewer control errors. Default is 'true'.

Release history

Version Date State License Price
Show description 1.0 (#2) 09 Mar 2008 Stable Freeware / Open Source (BSD) Free

Release Notes
Initial release.

Contributors

  • Bob Swift — Developer

Show description 1.0-b1 (#1) 20 Jan 2008 Beta Freeware / Open Source (BSD) Free

Release Notes
Initial release.

Contributors

  • Bob Swift — Developer

Open Issues

Atlassian Developer Network JIRA (1 issues)
T Key Summary Reporter Assignee Pr Status
Bug CVP-2 pageIndex parameter has no effect Erik de Wildt Bob Swift Minor In Progress

Screenshots

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jan 21, 2008

    P. Payette says:

    Tks Bob much needed, long time overdue. I would suggest Atlassian buy owner...

    Tks Bob - much needed, long time overdue. I would suggest Atlassian buy ownership and bundle this with Confluence because it's the kind of tool that greatly improves user adoption. Cheers, PP.

  2. Jan 23, 2008

    Chris Paquin says:

    Excellent\!\! Thanks, very much works perfectly. Could I make one suggestion, th...

    Excellent!! Thanks, very much - works perfectly. Could I make one suggestion, though? Would it be possible to build in a "sorry, you need IE to view this diagram!" message, for those of us working in other browsers?

    Any way, much obliged... Chris 

    1. Feb 29, 2008

      RefuX Zanzeenbarr says:

      \1\\
  3. Jan 23, 2008

    oye says:

    I have tried this plugin and it works well thanks. Any chance the status will ch...

    I have tried this plugin and it works well thanks. Any chance the status will change to stable soon?

    Thanks

    Nana

    1. Jan 25, 2008

      Bob Swift says:

      Looking for feedback on parameter names and defaults as changes would not be upw...

      Looking for feedback on parameter names and defaults as changes would not be upward compatible. Except for that, there is nothing else preventing it being declared stable.

  4. Jan 30, 2008

    Adam says:

    Looks very good on the screen, unfortunately when you try to export as PDF you g...

    Looks very good on the screen, unfortunately when you try to export as PDF you get a blank page.

    I would guess that as this uses the IE visio viewer there is no fix for this?

    Adam

    1. Jan 30, 2008

      Bob Swift says:

      Not that I am aware of :(

      Not that I am aware of

  5. Feb 01, 2008

    Michael S. Kelly says:

    Bob, very nice. This makes versioning simple. I attach and display the VSD and c...

    Bob, very nice. This makes versioning simple. I attach and display the VSD and call it done, instead of exporting to an image and attaching both files to the page. The one thing I'm struggling with is that I wish the diagram wasn't drag-able. Is it possible to make the diagram fixed positionally?

    Thanks,

    -=michael=-

    1. Feb 01, 2008

      Bob Swift says:

      I agree that would be the best default, but I don't see any parameter on the con...

      I agree that would be the best default, but I don't see any parameter on the control that prevents from being drag-able.

  6. Feb 02, 2008

    Jon Nermut says:

    Hey Bob, I was just thinking of the need for for a visio plugin on the weekend, ...

    Hey Bob,
    I was just thinking of the need for for a visio plugin on the weekend, and I managed to get a Visio2Png.exe working to convert visio diagrams on the server to png so they can be displayed (by painting the activex viewer to a bitmap then saving it). The intention was to produce a servlet plugin and a macro to render the png files automagically in a confluence page, using the Visio2Png.exe .
    I went to create a plugin dir in svn.atlassian.com and lo and behold there was already a visio plugin.
    Are you interested in merging this functionality into the one plugin?

    The trade off is that my method requires Windows and the Visio Viewer on the server, but renders as a straight png so will work in all browsers and in PDF exports.

    1. Feb 03, 2008

      Bob Swift says:

      Yes, that would be very useful for us since we just moved to a Windows server ba...

      Yes, that would be very useful for us since we just moved to a Windows server back end. With the two approaches, it would give users more flexibility. I think it would be good idea to merge the support under one plugin, so go ahead and add it to what is out there in SVN. Would you propose a macro for each approach?

      1. Feb 03, 2008

        Jon Nermut says:

        Ok, will try and get something working this week. I was thinking of a type attr...

        Ok, will try and get something working this week.

        I was thinking of a type attribute or something similar, on the same macro, as several of the other attributes (width, height, zoom) are the same. eg type=png, default is type=object.
        If type=png, then instead of the <object> html, it renders an <img> that points to the servlet, which in turn will generate the image on the back end and serve it.

  7. Feb 04, 2008

    OzFoss says:

    Nice plugin thx. &nbsp;Is there anyway to be able to use wiki notation within th...

    Nice plugin - thx.

     Is there anyway to be able to use wiki notation within the visio diagram for linking purposes, etc (like the output=wiki switch in the excel plugin)

    1. Feb 04, 2008

      Bob Swift says:

      No :(
  8. Feb 22, 2008

    Richard Ruggieri says:

    I'm getting an error with the plugin (well actually with the viewer) and I wonde...

    I'm getting an error with the plugin (well actually with the viewer) and I wonder if anyone has seen it or could help me out.  I have the vsd file attached to the page where I have the visio:^test1.vsd tag located.  When I load the page I get the following: "The Micosoft Office Visio Viewer cannot load the specified URL or file."

     I know for a fact that the visio viewer can load the vsd file (when openning it directly and not through confluence).

     Any ideas?

    1. Feb 22, 2008

      Richard Ruggieri says:

      See, you spend 2 hours troubleshooting and as soon as you post for help...BAM yo...

      See, you spend 2 hours troubleshooting and as soon as you post for help...BAM you figure it out.

      For some reason my base URL was incorrect.  I corrected it and now everything is good.

      GREAT plugin!

  9. Mar 05, 2008

    Tom Moore says:

    Maybe it's just me, but I attach a visio diagram, put in and when I access it...

    Maybe it's just me, but I attach a visio diagram, put in

    {visio:^diagram.vsd}
    

    and when I access it with IE7, I first get a popup saying "This page contains both secure and nosecure items" and I click "yes", Then I get a popup from the "Microsoft Visio Viewer" that says "This page is accessing information that is not under its control. This poses a security risk. Do you want to continue?" I say yes as well. Then I get another popup from the visio viewer that says "The Microsoft office Visio viewer cannot load the specified URL or file" And the visio area is just a blank square. I accessing confluence through an apache SSL proxy server.  I also tried directly to port 8080 on the confluence server with same results.

    1. Mar 17

      Mark Otting says:

      Got the same problem here. It looks like the plugin tries to load things over ht...

      Got the same problem here. It looks like the plugin tries to load things over http. We hid Confluence behind an apache server so our customers can only access the wiki over https://.

      1. Mar 17

        Bob Swift says:

        It uses the base url configured by the administrator.

        It uses the base url configured by the administrator.

  10. Mar 06, 2008

    Jean-Baptiste Catté says:

    Nice plugin, but inusable if a large part (or even one) of your users are not us...

    Nice plugin, but inusable if a large part (or even one) of your users are not using IE...
    And Visio2Png.exe will not be a solution if your server is on Linux.

    1. Mar 06

      Bob Swift says:

      We mostly use Firefox on Windows, so IE tab works fine for this. If you are more...

      We mostly use Firefox on Windows, so IE tab works fine for this. If you are more Linux based (client or server) then you are stuck with publishing a png every time you change your visio. Perhaps getting away from Visio would be better and going with Gliffy.

  11. Mar 17

    Tom Moore says:

    &nbsp;Bob, our site's base url is configured already to use https:// and the iss...

     Bob, our site's base url is configured already to use https:// and the issue still shows.  We are using Confluence behind an apache server using the mod_jk connector, using standalone confluence 2.7.2

    It uses the base url configured by the administrator.

    1. Mar 17

      Bob Swift says:

      Please verify

      Please verify http://support.microsoft.com/kb/885877/en-us?spid=2529&sid=global is not the problem. Next, view the source of the page and find the visio control html. Try this outside of Confluence. If it still looks like a plugin problem, please open an issue.

  12. Sep 04

    Richmond-rae Dalisay says:

    Salutations, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&...

    Salutations,

                      This is a great plugin. Anyways, After I attached the file and wriiten the macro code, I tried opening the file in Visio by right clicking the diagram and choose the Open in Microsoft Visio option and an error prompted:

    http://10.132.129.140:8083/download/attachments/10944547/Drawing1.vsd
    
    Visio cannot open the file because it's not a Visio file or it has become corrupted.

    What do you think is the problem?

    Thanks in Advance.