This section contains information on the following subjects:
When submitting assets to ALER, the WorkSpace Studio plug-ins for Eclipse determine whether or not the project can be transformed into an assembly model or if the referenced Eclipse project is an existing ALER project, and then renders the appropriate wizard to submit the asset to the enterprise repository.
The Archive Submission wizard maintains support for legacy ALER functionality by allowing you to submit single and/or compound-payload assets to ALER via an archive ZIP file, as explained in Submitting Archived Assets.
An Assembly Model is a set of related assets representing the structure of a WorkSpace Studio integration project in terms of the SCA standard. When a project is submitted from WorkSpace Studio, an Assembly Model is automatically created. The model consists of a root asset, of type AssemblyModel, that logically contains all the other assets in the model. The model assets represent Components, Services, Interfaces, and Bindings defining a WorkSpace Studio project, as well as Composites that define a hierarchical composition structure. The relationships used to connect the assets in the Assembly Model are ALER system-supplied relationships.
See Submitting Assembly Models to the Repository.
Projects are the primary means of gathering metrics in ALER. ALER tracks assets produced by projects, as well as assets consumed by projects. Projects are also a channel for governance practices, with ALER Compliance Templates (usually taking the form of Architecture Blueprints or Project Profiles) being applied to projects.
The ALER plug-in for Eclipse allows projects in ALER to be synchronized with projects in the Eclipse IDE by supporting governance rules. If compliance templates have been applied to a project, the list of assets in the compliance templates will appear in the Eclipse IDE. If SFID/automatic usage detection has been enabled, the assets that are used in the developer's project will be compared to the assets in ALER, and if a match is found, it will be recorded in ALER as reuse. This process streamlines the development experience, making ALER almost transparent to development teams. It also facilitates compliance reporting, allowing ALER to determine whether project teams have actually used the assets specified in the compliance templates.
See Submitting Eclipse Project Files to ALER.
When you right-click an Eclipse project and select the Submit to AquaLogic Enterprise Repository from the shortcut menu, the Workspace Studio plug-ins first determine if connectivity has been established to ALER. If a connection is not yet established, the Connect to Enterprise Repository wizard is launched to establish connectivity.
Once connectivity is established, the Workspace Studio plug-ins determine whether or not the project can be transformed into an assembly model or an ALER project (see Submitting Eclipse Project Files to ALER.). If it can be transformed into an assembly model, the Submit Assets to Enterprise Repository wizard enables you to submit the project's associated assets to the enterprise repository.
For example, if the referenced project is an integrated external endpoint, such as AquaLogic Data Services Platform or AquaLogic Service Bus, the wizard rendered represents the information required to submit the assets associated with the AquaLogic project.
Tip: | In order to submit assembly models to the repository, you must be assigned to an Advanced Submitter role. If you are unsure of your role status, check with your ALER system administrator. |
When submitting assembly models, WorkSpace Studio plug-ins capture metadata associated with the submitted asset, such as model and associated Artifact Store information.
<Default>
string and can only be edited under certain conditions, as described in Resubmitting an Existing Model.Note: | The Model Name, Version, and Namespace fields reflect the values used during the initial submission and cannot be edited when resubmitting a project. For more information, see Resubmitting an Existing Model. |
If an AquaLogic project contains unresolved external service references, you may want to resolve any unresolved references before submitting the project to the Enterprise Repository; however, this is not required.
The following guidelines may apply when submitting assembly models to ALER.
In the event an asset name/version collision occurs against an existing ALER non-deleted asset during an assembly model submission, the name will be augmented with a dash and number as follows: assetname-1
, assetname-2
, assetname-3
, etc. In the event name trimming needs to occur, such as where the name uses all the available characters for an asset name, the name will be trimmed at the end to make room for the name modification.
Projects submitted as assembly models will include a reference to the producing project. This project is applied to all assets in the import bundle and are additive in nature. For any assets in the bundle that already exist in ALER and have producing projects applied, the existing producing projects will remain intact and the new producing project will be added to the asset.
A WSDL imported using the ALER Plug-in for Eclipse cannot subsequently be imported directly using the ALER import/export tool. Any attempt to import such a WSDL using the import/export tool will fail, throwing the following "Unsupported WSDL" error message:
Error [10,001]: Unsupported WSDL - Specified WSDL can be imported only using ALSync tool as previous version of this WSDL was imported via ALSync.?
When initially submitting a model, the Model fields reflect the values used during the initial submission and cannot be edited when resubmitting a project. This is because they uniquely identify the assets of an assembly model, and changing any of these fields would result in a new model being created instead of an existing model getting updated.
The only time any Model fields can be modified is when an error occurs when resubmitting (e.g. a naming conflict) or when a model is locked, which will require entering a new model name, version, and namespace. A model can become locked under two conditions:
If either of these conditions is detected by ALER when a model is being resubmitted, a message will be displayed and the user can change any or all of the following fields: Model Namespace, Model Name, or Model Version. The user can then continue submit the model, but that model will now be a new model, and will not overwrite the original model (since that model is locked).
When you right-click an Eclipse project and select the Submit to AquaLogic Enterprise Repository from the shortcut menu, WorkSpace Studio plug-ins first determine if connectivity has been established to ALER. If a connection is not yet established, the Connect to Enterprise Repository wizard is launched to establish connectivity.
Once connectivity is established, the ALER plug-in determines whether the associated project is an Assembly Model (see Submitting Assembly Models to the Repository.) or an existing ALER API project. When it is an ALER project, the Submit Project Files wizard allows you to select and update an existing archive with assets to submit to ALER.
.zip
file extension. The project will appear as an asset in the Submitted - Pending Review folder in the ALER Asset Editor file tree. You can also refresh the data in the Enterprise Repository View's Results pane to view the asset in Pending Review status. You can also click the asset to view more details. For more information, see The Results Pane.
The Archive Submission wizard maintains support for legacy functionality for ALER 2.x or earlier releases. This allows you to submit single and/or compound-payload assets to AquaLogic Enterprise Repository by creating an asset archive ZIP file.
To build an archive to submit to ALER:
The asset will upload to the installed registry, and will appear in the Submitted - Pending Review folder in the file tree in AquaLogic Enterprise Repository's Asset Editor. You can also refresh the data in the Enterprise Repository View's Results pane to view the asset in Pending Review status. You can also click the asset to view more details. For more information, see The Results Pane.