How to load NetServer document plugin SuperOffice 7.5

Hi, 

I have a working COM based document plug-in for SuperOffice 7.5 SR2.

On the SuperOffice community I read that the maillink for SuperOffice 7.5 SR2 does not support the COM based document plug-in but that it has to use the NetServer based plug-in.

In this article there is an code example attached of the SoArc.NetServer plug-in (DocumentPlugins-WinWeb-7.5.zip):

https://community.superoffice.com/en/content/content/client-sdk/how-to-create-a-managed-document-plu­gin/

I have changed the SoArc.NetServer plug-in, other plug-in name and plug-in id to see if I can get this plug-in loaded in SuperOffice.

I have a TestNetServerPlugin.dll and loaded it using the SOLoader (under options menu) in SOAdmin.

I expect to see this document plug-in in SOAdmin when adding a document template. But my test plug-in is not in the list. Is loading the DLL with SOLoader enough for SuperOffice 7.5? Or should I register this NetServer plug-in somehow?

My first goal is to load the NetServer plug-in in SuperOffice and after that see if it will work with the maillink, how to load the NetServer plug-in?

Best regards, 
Bas Knol

RE: How to load NetServer document plugin SuperOffice 7.5

Just a guess:
have you tried adding your dll to the <DynamicLoad>....</DynamicLoad> section of your local SuperOffice.config file?

/conrad

Af: Conrad Weyns 24. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Hi Conrad, 

Yes, I have tried to add the dll to the <DynamicLoad> section. But it still does not work.

DynamicLoad

Are there other steps that have to be taken to load the dll?

Kind regards, 
Bas

 

Af: Bas Knol 26. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Hi Bas,
not at all sure about this but can you just try to eliminate one possible issue and move your dll into the directory where socrm.exe & all the netserver dlls live. Then change the dynamicload entry.
Just in case the loader does not like the full path...
(probably a shot in the dark but worth a try!)
Conrad

Af: Conrad Weyns 26. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Hi Conrad,

Thanks for thinking along. I have tried your suggestion, moved the dll's to the SuperOffice folder and changed the DynamicLoad statement, but still no luck.

Did you/someone ever get the NetServer plugin working in SuperOffice v7.5 SR2? Or only the COM based?

Kind regards,
Bas

Af: Bas Knol 26. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Ah! I think you are on to something.
It is the netserver config file used by the maillink installation that needs the dynamicload entry.
And no, the SoCrm docplugin netserver port is not in 7.5 but in 8, actually 8.1 I think. I need to check that in tfs but definately not in 7.5.

Conrad

Af: Conrad Weyns 26. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Hi Conrad, 

Thanks! Finally, I'm getting somewhere.

The steps I have taken:

  1. A working COM based document plugin with pluginid: 315700003
  2. Grabbed the SoArc NetServer example (DocumentPlugins-WinWeb-7.5.zip) from the earlier mentioned article.
  3. Changed the example NetServer plugin and gave it the same pluginid as the COM based plugin: 315700003.
  4. Place the TestNetServerPlugin.dll in the SuperOffice client folder.
  5. In SOAdmin -> Options -> SoLoader selected the TestNetServerPlugin.dll
  6. Removed the netserver.config located here: C:\Users\<user>\AppData\Roaming\SuperOffice\MailLink.
  7. Restarted outlook, the netserver.config was created automatically with a DynamicLoad entry: <add key="1" value="c:\Users\<user>\AppData\Local\SuperOffice\SOCache\TestNetServerPlugin.dll" />
  8. In outlook selected an e-mail and used the maillink to archive in SuperOffice. In the code I added a debugger statement, Visual Studio was launched and the e-mail file written to disk.

The only challenge remaining is that I have to set some user defined fields on the document before the document is archived. In the documentation I found that an interface ICustomUIProvider can be implemented with a function GetCustomUi that returns a View. Where can I find standard SuperOffice controls to add to the View?

Kind regards,
Bas

Af: Bas Knol 26. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Sorry Bas, I can't help with that.
(I am surprised there would be a UI interface in the netserver DocPlugin api...)
Try and draw the attention of Tony perhaps?
Conrad

Af: Conrad Weyns 28. feb 2018

RE: How to load NetServer document plugin SuperOffice 7.5

Tonys attention drawn.... :-)

When you say "after archived", I assume you referred to via maillink. In that case, there are only a couple known methods to do what you want. 

The first option is to create a vbs file the executes when a person archives an email. This is documented in a blog post by Hans Oluf Waaler (still valid in 8.2):

https://community.superoffice.com/en/blog/superoffice-mail-link-71/

The benefit of this approach is that it is only executed when an item is archived.

Another approach, since MailLink depends on NetServer web service APIs, is to create a NetServer Script. The complexity with this approach is determining where to place your script. In a Windows environment, maillink is either configured in windows or web more. In windows mode, it uses the same SuperOffice.config file as the windows client itself, and therefore it is where you would configure your NetServer script definitions. 

In web mode, there is a local domain web server that has NetServer web services configured to process all mail link requests. In this case, the NetServer web application is where the scripts are configured. 

There is no API to add UI components to the SuperOffice Windows Client Document dialog, or TrayApp dialog. 

Hope this helps, best regards!

Af: Tony Yates 1. mar 2018