|
<< Click to Display Table of Contents >> Navigation: 4. Additional Features > 4.10 Importing and Exporting Data in ShipWeight > 4.10.10 NAPA Integration |
NAPA Integration is an unfinished proof-of-concept developed during a workshop with NAPA. Further development is pending. It exchanges selected weight, volume and reference-parameter data with NAPA Designer through the NAPA Integration Service. Configure the connection in View > Options > Integration, then use Project > Integration > Napa for the available commands. The current limitations below describe the prototype implementation.
This service-based connection is separate from the older Import NAPA window described in 4.10.7. The older window is currently unavailable pending 64-bit NAPA API files; that restriction does not describe the service-based integration documented here.
Set up Options > Integration
Use Napa Integration Service: Enable the NAPA Integration Service connection for the current project. The NAPA commands are enabled when this option is selected. The service must also be installed, running and reachable from this workstation; selecting the checkbox does not start or install it.
URL: Enter the base address supplied for your NAPA Integration Service, including the protocol, server name and port where applicable. For example, a site may provide an HTTPS address for its integration server. Use the base service address, not an individual API endpoint. Connectivity, certificates and service access must match the local installation.
Napa Project: Enter the NAPA project identifier associated with this project. Read Parameters uses this identifier. Some other commands still use the service project named default; see Current limitations before relying on the configured project for a transfer.
Napa Project Revision: Record the intended NAPA project revision. The value is saved with the integration settings, but is not currently passed to the service requests. It therefore does not by itself select or protect a revision during transfer.
Click OK in Options to save the settings. Check the integration status in the main window status bar and confirm the intended NAPA service and project with the person responsible for the integration before sending or applying data.
For the Options fields, see 5.1.16 Integration.
Commands in Project > Integration > Napa
Check Lightship Weight: Request the service lightship weight and compare it with the current project lightship weight. The result is recorded as a notification, including whether the weights match, differ or a service value is missing. This is a comparison command, not a command to overwrite project weight data. The request currently addresses the service project default.
Send Lightship Weight: Prepare a lightship weight and centre-of-gravity message from weight group LW and send it to the service. The outgoing coordinates are longitudinal X, transverse Y and vertical Z, corresponding to LCG, TCG and VCG when those names are used in the project. This command still contains installation-specific assumptions and should be used only in a verified integration setup.
Send Volume Definitions: Prepare volume extents from weight-group bounds and send the definitions to the service. The current command uses the fixed weight groups H1.1, H1.2, H1.3 and H1.4 rather than the selected groups. Required minimum and maximum bounds must be defined. It is not a general export of every project volume.
Read Volumes: Read volume values from the service. The current menu command requests the service project default and maps H1.1 to parameter va, H1.2 to ve, H1.3 to vc and H1.4 to vf. After confirming that the returned data should be applied, matching existing project parameters are updated. Review the parameter values afterwards.
Read Parameters: Read reference parameters for the configured Napa Project. The current mappings are TDWL to dCW, LREF to lPE, BREF to bm, TMAX to dm, LOA to lm and HMD to hDM. Only mapped parameters already defined in the project can be applied. Review the updated parameters and units before using them in an estimate.
Test API Call...: Open an advanced diagnostic API request. This is intended for troubleshooting with knowledge of the service endpoints. A manually chosen request can change remote data; it is not required for routine configuration.
Status and notifications
The integration field in the status bar displays Status: online or Status: offline with a coloured indicator. Use it as connection feedback, then check the actual response to the command you run; an online indication alone does not confirm that a transfer used the correct project or revision.
Results and errors from integration operations can be recorded in Notifications. Click the notification field immediately after the integration status. Unread notifications show a gold bell and New notification; otherwise the field is blank but still clickable. Earlier read messages are available under Archive.
Current limitations
The integration is still partly installation-specific. The two Send commands use a fixed demonstration service address instead of the URL in Options. Several commands address the service project default, and Napa Project Revision is stored but not used to select a revision. Changing Options alone therefore does not retarget every command. Verify the installed integration before sending data to a production service.
Read Parameters asks whether to apply the retrieved values to the current project. Choose Yes to apply the mapped parameters, or No to leave the project parameters unchanged.
The read operations record imported parameter information for the current project. Check the messages, resulting values and project calculation results after an exchange. Do not assume that importing a volume or reference parameter recalculates all estimates automatically.