Create the Data Flow

This section describes how to build a dataflow to perform connector actions in response to HTTP requests.

A NiFi Ingest dataflow that listens for requests and performs multiple actions can be complex, so Micro Focus recommends building your dataflow from the following templates that are provided with NiFi Ingest:

To create a dataflow to handle connector actions

  1. Add the components required to handle HTTP requests.

    1. Drag the template icon from the components toolbar to the canvas.

      The Add Template dialog box opens.

    2. In the list, select Connector ACI Server and click ADD.

      The components necessary to handle requests are added to the canvas.

      TIP: The Connector ACI group and the ConnectorGroupRouter added by this template are designed to handle requests for any number of connectors. In a later step you will configure the ConnectorGroupRouter to route requests to the correct connector.

  2. Add a connector group. This is a group of processors that can handle all of the supported actions for a specific connector.

    1. Right-click the ConnectorGroupRouter processor, and click Configure.
    2. Click ADVANCED.

      A dialog box opens, showing every IDOL Connector that you have installed, along with the actions that it supports.

    3. (Optional) If you do not need to handle every action you can exclude the ones that you do not need. Click the check mark in the relevant column, so that it turns to a cross.
    4. Click INSTALL next to the relevant connector group. This example uses a File System Connector, so click INSTALL for the FileSystem Connector Group.

      A template is installed that contains the components required to handle the selected actions.

    5. Close the dialog boxes and return to the canvas.
    6. Drag the template icon from the components toolbar to the canvas.

      The Add Template dialog box opens.

    7. In the list, select FileSystem Connector Group and click ADD.

      The components are added to the canvas.

  3. Configure how to handle requests.

    1. Right-click the Connector ACI group and click Variables.

      The Variables dialog box opens.

    2. (Optional) You can choose the port to listen on by setting the variable connector.aci.port. The variable is set by default to use port 10000.
    3. Click APPLY.
    4. Right-click the Connector ACI group and click Configure.

      The Connector ACI Configuration dialog box opens.

    5. Click the Controller Services tab.

      An ACI Context Service already exists.

    6. (Optional) You can configure this service to customize how actions are handled.
    7. Enable the ACI Context Service (click Enable ).

      The Enable Controller Service dialog box opens.

    8. Click ENABLE, then CLOSE.
    9. Close the Connector ACI Configuration dialog box and return to the canvas.
  4. Configure the ConnectorGroupRouter to route requests to your FileSystem Connector Group, and route responses back.

    1. Right-click the ConntorGroupRouter and click Configure.
    2. Click the Properties tab.
    3. Click to add a new dynamic property.

      The Add Property dialog box opens.

    4. In the Property Name box, type FileSystemConnectorGroup. Then, click OK.

      The name that you choose becomes the name of an output relationship on the ConnectorGroupRouter processor. You could also create relationships for other connector groups, by creating properties such as WebConnectorGroup or ExchangeConnectorGroup.

    5. Set the value of the property to the name of the connector group, for example FileSystem.
    6. Click APPLY.
    7. Create a connection from the ConnectorGroupRouter processor to the "Request" input of the connector group. Select the "FileSystemConnectorGroup" relationship that you created.

    8. Create a connection from the FileSystemConnectorGroup "Response" output, back to the ConnectorGroupRouter. Hover the mouse pointer over the "Response" funnel until you see the connection icon - - and then drag the icon to the ConnectorGroupRouter. For this connection there is no need to select a relationship (just click ADD).

    The completed connections should look like those in the following image.

  5. Configure the FileSystem Connector Group.

    1. Right-click the FileSystem Connector Group and click Variables.
    2. Set the license.server.hostname variable to the host name or IP address or your IDOL License Server, and click APPLY followed by CLOSE.
    3. Right-click the FileSystem Connector Group and click Configure.

      The FileSystem Connector Group Configuration dialog box opens.

    4. Click the Controller Services tab.

      An IDOL License Service already exists.

    5. Configure the IDOL License Service as necessary (for example, you might need to specify SSL settings if your License Server only accepts requests over SSL). Then click Enable and enable the service.
  6. Open the FileSystem Connector Group and configure the connector processors as necessary.

    1. Double-click the FileSystem Connector Group (or right-click and choose Enter group).
    2. Configure the connector processors as necessary. For example, in a FileSystem Connector Group, you must set the Directory Paths property on the GetFileSystem processor, to set the starting point for the synchronize action. The other processors do not require any additional configuration.
    3. To return to the main dataflow, right-click a blank area of the canvas and click Leave group.
  7. Start all of the processors in the dataflow. (Go to the Operate palette and click Start ).

    You can now begin sending actions (see Send Actions to NiFi).


_FT_HTML5_bannerTitle.htm