Search Knowledge Base by Keyword

New Connector

< Back

From the Connector Library Management tab, you can create new connectors.  To create:

  1. Click the New Connector button to bring up the New Connector wizard
  2. Enter the properties of the new connector on the Connector Properties tab

    1. Image Preview – Upload image to display in the Connector Library (optional)
      1. Click the Change Image hyperlink and browse for an image to upload

      2. Click the Update button to upload the image. Click the Clear Selected File hyperlink to clear the file and browse for a new image.  Click the Cancel Changes hyperlink to cancel the operation.
    2. Identifier – Enter identifier of the connector (required)
    3. Name – Enter name of the connector (required)
    4. Description – Enter description of the connector (optional)
    5. Help URL – Enter help URL of the connector (optional)
    6. Order – Choose the order the connector is displayed in the Connector Library (optional)
    7. Enabled – Choose if the connector is enabled (required)
  3. Click the Create button when finished to create the connector. You will be redirected to the Connector Properties tab to continue creating the connector. Click the Cancel button to cancel the operation.
  4. Create authentication methods for the new connector on the Authentication Methods tab

    1. Click the New Authentication Method button to bring up the New Authentication Method dialog
    2. Enter the properties of the new authentication method

      1. Name – Name of the authentication method (required)
      2. Description – Description of the authentication method (optional)
      3. Script – Name of the authentication script (required)
      4. Order – Order of the authentication method in the menu (optional)
      5. Enabled – Choose if the authentication method is enabled (required)
    3. Click the Create button when finished to create the authentication method. You will be redirected back to the Authentication Methods tab. Click the Close button to cancel the operation.
      1. The new authentication method function is only available to users in the Administrator security group
  5. Associate fields with the authentication method for the new connector on the Fields tab
    1. Select a field (row) to edit
    2. Click the Edit Field button on the toolbar to bring up the Edit Field dialog

      1. The edit button is grayed out unless a field (row) is selected

      2. The edit function is only available to users in the Administrator security group
    3. Update the properties of the field

      1. Enabled – Choose if the field is enabled (required)
      2. Field Name – Name of the field (required)
      3. Field Type – Type of the field (required)
      4. Field Label – Label of the field (required)
      5. Placeholder – Placeholder of the field (optional)
      6. Tooltip – Tooltip of the field (optional)
      7. Input Data – JSON input data of the field (optional)
      8. Min Length – Minimum length (number of characters) of the field (optional)
      9. Max Length – Maximum length (number of characters) of the field (optional)
      10. Default Value – Default value of the field (optional)
      11. RegEx Pattern – Regular expression pattern to validate input values of the field (optional)
      12. RegEx Message – Message to display for input values that do not match the regular expression pattern (optional)
      13. Order – Order of the field in the Activate New Connection dialog (optional)
      14. Required – Choose if the field is required (required)
    4. Click the Update button when finished to update the field. You will be redirected back to the Fields tab. Click the Close button to cancel the operation.
  6. Define the job fields for the new connector on the Job Fields tab
    1. Select a job field (row) to edit
    2. Click the Edit Job Field button on the toolbar to bring up the Edit Job Field dialog

      1. The edit button is grayed out unless a job field (row) is selected

      2. The edit function is only available to users in the Administrator security group
    3. Update the properties of the job field

      1. Enabled – Choose if the field is enabled (required)
        1. The following job fields are enabled by default and cannot be disabled: Order, Fields to Index, Data Identify, Destination Table, Allow Empty Table, Enabled, Job Schedule, Job Description.
      2. Field Name – Name of the field (required)
      3. Field Type – Type of the field (required)
      4. Field Label – Label of the field (required)
      5. Placeholder – Placeholder of the field (optional)
      6. Tooltip – Tooltip of the field (optional)
      7. Input Data – JSON input data of the field (optional)
      8. Min Length – Minimum length (number of characters) of the field (optional)
      9. Max Length – Maximum length (number of characters) of the field (optional)
      10. Default Value – Default value of the field (optional)
      11. RegEx Pattern – Regular expression pattern to validate input values of the field (optional)
      12. RegEx Message – Message to display for input values that do not match the regular expression pattern (optional)
      13. Order – Order of the field in the New Job and Edit Job dialogs (optional)
      14. Required – Choose if the field is required (required)
    4. Click the Update button when finished to update the job field. You will be redirected back to the Job Fields tab. Click the Close button to cancel the operation.
  7. Create job templates for the new connector on the Job Templates tab

    1. Click the New Job Template button to bring up the New Job Template dialog
    2. Enter the properties of the new job template (available job template fields differ by connector)

      1. Job Description – Description of the job template (required)
      2. Job Schedule – Frequency the job template will run (Weekly, Daily, Hourly, Custom) (required)
      3. Enabled – Choose if the job template is enabled (required)
      4. Allow Empty Table  – Choose if an empty table is allowed (required)
      5. Destination Table – Name of the destination table (e.g., my_table_cm_computer) (required)
      6. Data Identity – Identity of the data for dashboards (e.g., cm_computer) (optional)
        1. AD – Identify data to query from a table
      7. CSV/JSON/XML File or Path – CSV/JSON/XML file or path (optional)
      8. Append Files to Same Destination Table – Choose if multiple files in the same path will append to the same destination table, or will create a new destination table for each file (optional)
      9. Data Selection – Connector specific data selection command of the job template (optional)
      10. Fields to Index – Fields to index (optional)
      11. Method Type – Method type of the job template (GET, POST) (optional)
      12. API End Point – API end point of the job template (optional)
      13. API Query Parameters – API query parameters of the job template (optional)
      14. API Data Node – API data node of the job template (optional)
      15. API Pagination Node – API pagination node of the job template (optional)
      16. API Error Node – API error node of the job template (optional)
      17. Pagination Type – Paging type of the job template (Records, Pages, Data Nodes) (optional)
      18. Pagination Offset Start – Request paging offset start or data node of the job template (optional)
      19. Request Unique Key Field – Request unique key field of the job template (optional)
      20. Request Filter – Fields to filter from the job template (optional)
      21. Request Sort By – Field to sort the job template by (optional)
      22. Pagination Limit – Request pagination limit of the job template (optional)
      23. Enumeration Keys End Point – Enumeration keys end point of the job template (optional)
      24. Enumeration Node – Enumeration node of the job template (optional)
      25. Enumeration Key – Enumeration key of the job template (optional)
      26. Data Node – Data node of the job template (optional)
      27. Data Processing – Future field to be used for running a process against data (optional)
      28. Order – Order of the job template in the Activate New Connection dialog (required)
    3. Click the Create button when finished to create the job template. You will be redirected back to the Job Templates tab. Click the Close button to cancel the operation.
      1. The new job template function is only available to users in the Administrator security group