6. Complete the setup form

After you create the connector database, you’re prompted to complete the System Setup form while setting up Google Calendar Connector for HCL Notes (GCCHN).

Complete the tabs in the setup form

Expand all  |  Collapse all

Step 1: General tab

Polling service

Turn on the polling service on all servers.

Free/busy service

Turn on the server's web service. If you’re installing multiple instances of GCCHN, turn on the service for only one server.

Domino directory file name

Enter the name of the HCL Domino directory.

Locate Notes users named in a Google-to-Notes request

When a Google user requests availability information for a Notes user, the system locates the user in the Domino directory before the request is fulfilled. The system has 2 ways to locate the Notes user:

• View lookup–The system locates each Notes user with the address supplied by referring to the directory's ($Users) view.
• Named field–This option should only be used if the addresses used by the Google Calendar user are not shown in the ($Users) view. If you select Named field, enter the name of the field to use in the Lookup field box.

Generate the Gmail username from the Person document

This field is used by the polling agent to locate the correct calendar for each Google Calendar user listed in the Domino directory. You can enter a field name or use a formula.

• Enter field name—Enter the field name from the Person document that contains the Google Workspace username of each user who has moved to Google Workspace. Usually, the username is found in the InternetAddress field of the Person document, but any field can be used.
• Enter a formula—Use a formula to automatically generate the entry.

  Example: @LowerCase(ShortName)+"@example.com"

  In this example to create the Gmail username, the formula takes the first value in each user’s ShortName field, converts it to lowercase, and appends it with @example.com.

  Tip: Click Check Formula to validate your formula before you continue.

Step 2: Google Workspace domain tab

Domain name

Enter your Google Workspace domain name.

Domain administrator full email address

Enter the full email address of a super administrator for the Google Workspace domain.

Authorize using a service account

Upload the JSON file: 

1. Click Upload Key File and upload your JSON key file (created earlier).

   When the upload is complete, you can view and authorize the service account's client ID and scopes at the bottom of the form.

2. Copy the Client ID.

Authorize your client ID:

1. Sign in to your Google Admin console.

   Sign in using an account with super administrator privileges (does not end in @gmail.com).

2. In the Admin console, go to Menu  SecurityAccess and data controlAPI controlsManage Domain Wide Delegation.
   You must be signed in as a super administrator for this task.
3. Click Manage Domain Wide Delegation.
4. Click Add new and enter your service account client ID.

   You can find the ID (also known as the Unique ID) in the JSON file that you downloaded when you created the service account or in Google Cloud (click IAM & AdminService accountsthe name of your service account).

5. For OAuth scopes, copy and paste the following scopes:

   https://www.googleapis.com/auth/admin.directory.user
   https://www.googleapis.com/auth/calendar

6. Click Authorize.
7. Point to the new client ID, click View details, and make sure that every scope is listed.

   If a scope is not listed, click Edit, enter the missing scope, and click Authorize. You can't edit the client ID.

Step 3: Advanced tab

Detailed event logging

A log database is automatically created from the gccin-log.ntf template. The database can be found in the same folder as the connector database. Basic polling activities are added to the database.

Under normal circumstances, you set the field to Disabled. Later, if you need to resolve configuration issues, you can set the field to Enabled to view detailed polling activity and web service events in the log.

Google free busy feed size

Enter the number of days that you want to collect for each user in Google Calendar. A smaller value is typically faster to process.

Use an allowlist

If your connector server is available from the internet, use an allowlist to help prevent external attacks. If your connector server is on an internal network, you don't need to use an allowlist.

Don't change the default allowlist values unless advised to do so by Google Workspace support.

Fall back protocol and Fall back URL

These settings are for backwards compatibility only. Don't change these values unless advised to do so by Google Workspace support.

OAuth endpoints

The endpoints are the Google URLs used by the connector. Don't change these values unless advised to do so by Google Workspace support.

Notes availability response elements

Don't change these values unless advised to do so by Google Workspace support.

Google support

Trace tokens allow an extra level of debugging in the connector. Don't enter a value unless advised to do so by Google Workspace support.

Next steps

Once you complete the steps, click SaveExit to close the form.

Move to Create a Server Group document.

_{Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.}