Send Documents to Knowledge Engine

In the Knowledge Engine section of the navigation bar, you can upload documents and files, enabling AI-powered product creation and enrichment. Keep your product data up-to-date and accurate with minimal effort when you use the Knowledge Engine right inside your MDM. Files can be managed only by MDM Admins or MDM Editors within a tenant. 

In this article, you'll learn about how to upload files to the Knowledge Engine.

Note: MDM is available for purchase. Request a quick demo of MDM here.

 

Contents

SFTP vs Web Uploader

How to use Web Uploader

How to use SFTP 

Upload Details

Upload Status

Upload Report

Filter Uploads

 

SFTP vs Web Uploader

Secure File Transfer Protocol (SFTP) is a network protocol that provides secure file transfer capabilities over a secure shell connection. It’s designed to provide a high level of security while transferring files, ensuring that both the data and user credentials are encrypted during transit.

SFTP is used during implementation or needing to transfer a large volume of files. On the other hand, the Web Uploader is used for ongoing needs post implementation. Both SFTP and the Web Uploader can be used anytime when transferring files. If you have trouble with either option, contact us for assistance.

 

How to use Web Uploader

The Web Uploader can support up to 1GB per individual file and up to 20 files total per upload. A zipped file containing thousands of documents counts as 1 file. When uploading files, there is a progress indicator on the bottom right showing in real-time how many files have been uploaded. 

To upload files using Web Uploader:

  1. Navigate to Knowledge Engine in the left hand navigation bar
  2. Click Upload Files on the top right
  3. Optionally add Guidance or restrictions details and Restrict new product creation
    1. Enter Guidance in the textfield regarding what information should or should not be pulled from the documents to add or update attributes on products
    2. Check Restrict new product creation to only update existing products. New product records will not be created if new products are found in the documents provided.
  4. Click Select Files 
  5. Select files to upload 

Tip: For uploads greater than 100 files at a time, we recommend using SFTP to transfer files to the Knowledge Engine.

 

How to use SFTP

An SFTP can be used to transfer files on your local machine and a cloud storage provider. There are no limits of individual file size or total upload size using SFTP but your company may have SFTP restrictions. Once your document storage system is connected to the Knowledge Engine via SFTP, SFTP credentials last a full year.

Files are automatically sent to the Knowledge Engine every 24 hours for processing. When files are processed in the 24 hour window, a new row appears in File Uploads with "Integration" as the source and the file count in the SFTP row returns back to 0. 

To upload files using SFTP locally: 

  1. Navigate to Knowledge Engine in the left hand navigation bar
  2. Click Create SFTP Connection on the top right
  3. Click Generate SFTP Credentials in the modal
  4. Your SFTP Credentials are generated displaying the Host, Username, and Password
  5. Go to your SFTP application and enter the SFTP credentials 
  6. In your SFTP application, select files to transfer 

Note: After an SFTP connection is opened for 365 days, the credentials become inactive and the connection is closed.

 

To close an SFTP connection:

  1. Navigate to Knowledge Engine in the left hand navigation bar
  2. Click Details on the right of the specific upload row 
  3. Click SFTP Connection on the right of status
  4. Click Close Connection on the bottom of the modal

Note: Once you close an SFTP connection, you cannot reopen it. However, you can create a new connection at any time.

 

To transfer files using SFTP with a cloud storage provider (e.g., SharePoint), work with your IT team to use SFTP credentials provided to you. We’ve provided links below with SharePoint instructions from Microsoft.

SharePoint

  1. Use Power Automate to create a flow.
  2. Use the Power Automate flow to connect SFTP. Microsoft's how-to guide is here.

 

Upload Details

To view Upload Details:

  1. Navigate to Knowledge Engine in the left hand navigation bar
  2. Click Details on the right of the specific upload row 
  3. View details such as when it was created, who it was created by, ID, guidance or restrictions, new product creation, and upload status 
  4. View the files uploaded and their size in the Upload tab 

 

Note: If a row has document icon the right, the upload report is available to view processing statistics.

 

Upload Status

You can track the upload status as files are processed through the Knowledge Engine. The three upload statuses are Open, Processing, and Complete.

Status Description
Open Files have not been processed in the Knowledge Engine.
Processing Files are currently being processed in the Knowledge Engine.
Complete

Files have been processed in the Knowledge Engine. Product creation and enrichment are reflected in Approvals or MDM.

SFTP connections have a status of "Open" until the credentials expire or the connection is manually closed. Closing an SFTP connection changes the upload status from "Open" to "Complete".

Note: There are no notifications for when an upload status is completed. Check the File Upload grid to track upload status.

 

Upload Report

The Upload Report is generated after files have been submitted for processing. This may take up to 48 hours. If a row has document icon on the right, the upload report is available to view processing statistics.

Statistic Description
Uploaded Files Files that were uploaded to the Knowledge Engine.
Processed Files Files that were successfully processed in the Knowledge Engine.
Unprocessed Files File that were unable to be processed in the Knowledge Engine due to errors opening or reading the documents.
Unique Files Files that are unique in a batch.
Duplicate Files  Files that are duplicates within a batch.
Blank Files Files that are empty.
Image-based Files Files that are image-based.
File Types File types present in the files uploaded.
Non-PDF Files Files that are in non-PDF format.
Total Languages Languages present in files uploaded.
Languages Language names present in files uploaded.

 

Filter Uploads

In the Knowledge Engine, you can apply filters to segment your upload based on your business needs and to display your uploads in a view that helps you easily digest the information.

To filter uploaded files:

  1. Navigate to Knowledge Engine in the left hand navigation bar
  2. Click the Filter icon above the uploads grid
  3. Select an option to Filter by such as Uploaded, Uploaded by, Source, and Upload Status 
  4. Click Show Results 

Note: You may select multiple filter options at once.

 

Still need help?

Submit a Request

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.

Articles in this section