Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

IMPORTANT NOTE: This example is not compatible with ETABS v22.0.0 , SAFE v22.0.0 , SAP2000 v26.0.0 , and CSiBridge v26.0.0 (or any later versions of these programs) . Please refer to the updated example here: NET 8 Plugin Example - All Products


On this page:

Table of Contents

Overview

CSI Sample Plugin 1 is a simple example, created using Visual Basic 2012, which demonstrates the development of SAP2000 plugins. The plugin creates a new model, converts a line of text into frame objects, then adds these objects to the model. For testing purposes, if the text 'crash' is entered, an error message will be generated.

The following sections provide the zipped plugin project file for different target CSI programs (SAP2000, ETABS) and for different plugin types (COM, .NET).

SAP2000 .NET Plugin

Note

Plugin zipped project file: SAP2000_Example_Plugin_NET.zip

SAP2000 COM Plugin

Note

Plugin zipped project file: SapPlugin1720_FramesFromText.zip (Microsoft Visual Studio 2012 Zipped Project)

To enable the COM plugin in SAP2000, necessary steps include:

FAQ

How is the plugin compiled?

Answer: The plugin is already compiled as the DLL library which follows:

Code Block
obj/Release/SapPlugin1720_FramesFromText.dll

Once compiled, does the plugin need to be registered with the operating system, and how is this done?

Answer: Please see the Registering COM plugins article for response.

How is the regsvr32 error, shown below, resolved when registering the plugin?


Image Added

Figure 1 - regsvr32 error


Answer: The plugin should be registered using regasm, instead of regsvr32, by running the following command:

Code Block
c:\windows\Microsoft.NET\Framework\v2v4.0.5072730319\regasm /codebase /tlb /verbose  Sap2000PluginSapPlugin1720_CSI_Sample1FramesFromText.dll
{code}


h2. Registering the plugin using regasm gives warning RA0000. Should I worry about this warning?

!Register_plugin_regasm_screen.png!

The warning message can be ignored and the plugin will still work.

h1. Attachments

* [Sample Plugin Zipped Microsoft Visual Studio 2005 Project|^Sap2000Plugin_CSI_Sample1.zip]

Warning RA0000, shown below, occurs when using regasm to register the plugin. How is this resolved?


Image Added

Figure 2 - RA0000 warning


Answer: The RA0000 warning may be ignored since the plugin will still function properly.

ETABS .NET Plugin

Note

Plugin zipped project file: ETABS_NETonly_ExamplePlugin.zip (Visual Studio 2012 VB.NET)

Please refer to the "Information for Plugin Developers" page in theĀ CSi API ETABS 2015.chm help file that is present in the ETABS 2015 program directory.