Welcome

Welcome to the Domino AppDev Pack.

The AppDev Pack primarily adds Node.js support to HCL Domino Server. It includes these components:

• The Proton Domino server add-in task. An administrator installs and configures Proton on one or more Domino servers. If you are a Domino administrator, start with the Administration Overview page.
• The @domino/domino-db Node.js module. A developer uses this module from a Node.js application. This module uses Proton to perform operations on documents in a server database. If you are a developer, start with the API Documentation page.
• The com.hcl.domino.db Java API. A developer uses this API from a Java application. The API uses Proton to perform operations on documents in a server database. If you are a developer, start with the java-docs jar provided in AppDev pack kit.
• The Node.js based Identity and Access Management service, IAM. An administrator deploys IAM aside Domino. For more information, start with the IAM Overview page. A developer uses the IAM client library in their Node.js application to build applications that access Domino resources through:
  • RESTFul APIs with standard OAuth2.0 authorization flows
  • Act-as-User requests in @domino/domino-db

What's New in Release 1.0.6

Release 1.0.6 includes the following changes:

• New Java API documentation. See here and here.
• New Java API support for rich text, agent and Act-as-User operations.
• New Exclusive OAuth2 scopes for calendar API access. See here and here.
• Removed support for Domino V10.0.1 FP5.
• New Node.js API to export a Domino database as DXL. For details see exportDXL.

Release 1.0.6 supports:

• Domino server V11.0.1 or later
• Node.js V12
• (Preview) Java 1.8 or later

What's New in Release 1.0.5

Release 1.0.5 includes the following changes:

• Support for the following:

  • Domino server V10.0.1FP5 or later
  • Domino server V11.0.1 or later
  • Node.js V12
  • (Preview) Java 1.8 or later

• (Preview) A new JAR file with the com.hcl.domino.db API. This API is similar to the Node.js @domino/domino-db API, but does not yet support, rich text, agents, and Act-as-User operations. See install kit for information about the Java Doc.

• (Preview) Support for working with rich text content. See here and here for more details.

• A new way to configure the Domino server AppDev pack components. The AppDev Pack kit contains a new database template from which the Domino administrator creates the configuration database, adpconfig.nsf. For installation details see here.

• Improved reliability for long running Proton applications.

• Instructions for the make_certs.* and make_keyring.* scripts.

• @domino/domino-db support for duplicate items using the duplicateItems property. Use this optional property to read and write items in a document with the same name. See here for more details.

  • Support for a related property, canonicalFormat. Use this property to request that item data be provided in a canonical format. See here for more details.

What's New in Release 1.0.4

Release 1.0.4 includes the following changes:

• Support for Domino 11.01 or later and Domino 10.0.1FP4 or later. The AppDev Pack install kit includes separate archives for each major Domino release. See installation instructions for more details.
• domino-db support for rich text items in Notes documents. See here for more details.
• domino-db support for running agents in a Notes database. See here and here for more details.
• Proton request rate limiting for rogue applications. See here for more details.
• Proton console log messages are now written to log.nsf on the Domino server. See the PROTON_USE_LOGNSF Notes.ini in Proton Administration to revert to the old behavior of only writing to the console.log file.

What's New in Release 1.0.3

Release 1.0.3 includes the following changes:

• Bug fix to a corruption bug for some attachments uploaded using Proton on Windows.
• A Step-by-Step Setup Guide to configure the AppDev Pack components.
• Requires either Domino Server 10.0.1 Fix Pack 4 or Domino Server 11. Note that Domino 11 will be available before Domino 10.0.1 Fix Pack 4.

What's New in Release 1.0.2

Release 1.0.2 includes the following new features:

• (Preview) A domino-db application may now request the ability to make Proton requests on behalf of a user. The feature, collectively named Act-as-User is implemented across multiple components from the AppDev pack. For details, see:

  • IAM Service: the Domino Database Access section and related sections on other pages.
  • Act-as-User Administration in Proton Configuration and Database Configuration
  • Act-as-User in domino-db

• IAM service

  • Efficiently leverage multiple CPU cores on the server.
  • The ability to configure token expiration. See Configure Token Expiration.
  • Support 3rd party statistics server integration through 'StatsD' protocol. See IAM statistics.

• The ability to create and read Names, Readers and Authors items.

• The ability to create, read and delete attachments. See Attachments for details.

• The ability for Proton to update the Domino directory with an application's certificate. See details here.

What's New in Release 1.0.1

Release 1.0.1 includes the following new features:

• IAM service is officially released.
• Microsoft Windows support. Both Proton and IAM can now be deployed to Windows.
• Compute with form support for create, read and update operations. See Compute with form for details.
• The ability to read and write $REF items. For more information, see NOTEREF_LIST.
• A test script for verifying your connection to Proton. For more information, see Proton Test Script.
• Node.js 10.x support. This version of domino-db was tested with Node.js 10.x. Previous versions of Node.js are deprecated, and subsequent versions are not yet supported.