How to create an Amazon S3 Feed

Introduction

Here are the steps to add a new Amazon S3 feed to your inbox. The Amazon S3 provides effortless data flow between InfoDesk and your folders and buckets on Amazon: Enables seamless enterprise data integration. Create, filter and connect the feed based on your content preferences. 

Connect an Amazon S3 Feed

To connect an Amazon S3 Feed to your Inbox, follow these steps. The data will need to be in a specific document format which can be found here.

1. Navigate to Inboxes and open your Inbox. Select InfoLab from the More menu on the far right in the top menu of the inbox.
2. Click the New Feed button and select the Amazon S3 feed in the drop-down menu. This will open a new form called "New Amazon S3 Feed".
3. A window will appear and ask you to fill in credentials and specific information from your Amazon S3 Account. This will only read JSON files
   • Access Key
   • Secret Key
   • Bucket Region
   • Bucket Name
   • Folder Path
   • Checkbox – “Include files in sub-folders
   • Name of Feed
   • Select Target Inbox

When you are satisfied with your setup information, click the Save button to save your new feed. You can click Next to proceed to the Settings page.

• On the Settings page, you can change the feed name, add a description of the feed, and change the target inbox.
• Optionally: Check the Restricted checkbox to prevent others from updating the feed. When restricted a padlock icon will be shown on the Feed in InfoLab.
• Click Save to save your changes.

Preview and Filter Options

This section contains detailed information about the Filter options for Amazon S3 feeds.

The filter menu offers two search options that can be combined to optimize your search results.

These options include free text search and Amazon S3 specific filters. Most of the filters provide predefined facet options that you can select from to specify your filter. Note that filters and facets are only enabled when content matches the filters.

Use the AND, OR, and NOT operators to further refine your search.

• Use the OR operator to include one or the other facet within a filter category. This gives a wide search.
• Use the AND operator to require that both facets are included within a filter category. This gives a narrow search.
• Use the NOT operator to exclude specified facets within a filter category.

Your search result will be displayed above the bar chart to provide an overview of your chosen filters. With more than four filter buttons, click the Show more button to view all filters.

If the post list view is empty, no content matches your search within the set time period or filters. Change the Time period or adjust the filters and preview the result. The default period is “Past week”.

Advanced Query

Text Filter

The Text filter allows for free text searches. You can use a single keyword, combine several keywords, or create a complete search string.

You can choose to search in the Title, Description, or Content depending on how wide or narrow you want your filter to be.

Title: Only include content matching your search query in the article title. This is the narrowest text search.

Description: Search in the article Description for a broader search.

Content: Search in the full Content for the broadest search

Predefined Filters and facets

The Amazon S3 Filter menu includes a range of predefined filter and facet options. Use the filter search bar and then click on the facet buttons to set your filter.

Facet will be dynamic based on the client content

Source Name: Search source names or use the predefined facets to filter by source names. Click on “Show more” to view all the options. Use this filter when you know which sources you want to include in your filter.

Publisher Country: Search publisher country or use the predefined facets to filter by publisher country. Click on “Show more” to view all the options. Use this filter to limit your search within a specific country.

Organization: Search for an organization or use the predefined organization facets to filter by organization. Click on “Show more” to view all the options. This filter is commonly used and a good start when creating a filter.

Topics: Search topics or use the predefined facets to filter by topic. Click on “Show more” to view all the options. Use this filter to limit your sources within a specific topic area,

Date: Search by fetched date, using the drop-down menu to delimit the search to include only the last 24 hours, the last week, or the last month.

Best Practices

This section contains best practices and commonly used filter options in the Amazon S3. Read the Filter options section above for more information about the filter options.

The list of posts that appears when you are adding filters allows you to preview the filters before applying them. Preview the post list to make sure that the posts retrieved by the filter meets your expectations.

Note that the categories shown on the posts in the preview post list are only used in InfoLab and are not the same categories that appear on the posts in Inboxes.

Text Query

A good start when filtering content is to start with a text query.

You can use one single keyword, several keywords or create a complete search string. You can read more about how to combine keywords and create search strings in Help.

Depending on how wide or narrow the search you would like to do, you can search in only Title, in the Description or the full Content.

Preview the result and then use additional filters and facets to refine your search.

Good to Know

Time Period

When choosing the Time Period for the preview post list, you have the option of selecting from the last 24 hours, the past week, or the previous month. The default time period is the last week.

Posts will be kept for a maximum of 30 days and will then be deleted.

Max Number of Posts

If your filter retrieves more posts, the chart bars will turn red, and you will be prompted to adjust your filter.

Note that the maximum number of posts accepted in Inboxes is 100 posts per day. 

Categories Displayed on Posts

Categories shown on the posts in the preview post list are only used in InfoLab and will only appear on the posts in Inboxes when the same categories are available in the portal taxonomy.

Text Query Highlights

Words from the query text are highlighted in the title and article content in the preview post list to assist you in reviewing the articles and their relevance.

Preview and filter an Amazon S3 Feed

All your connected feeds are available in InfoLab Feeds.

You can open an Amazon S3 feed in InfoLab to preview the feed and add more filters on top of the original search criteria.

To preview and filter an Amazon S3 Feed, follow these steps:

1. Navigate to InfoLab from the main navigation bar.  
   You can also start from your Inbox and select InfoLab from the More menu on the far right in the top menu of the inbox.
2. To find your feed, simply use the search bar at the top of the InfoLab Feed page.  
3. Click on the feed name to open the Preview and add filter page, where you can access the filter menu and a list of posts that allow you to preview the filters before applying them.
4. The filter menu offers three search options that can be combined to optimize your search results. These options include a free text search, publication date, and Amazon S3 specific filters and facets.
   • To search for specific keywords or phrases, use the search bars under the Text section, which includes Title, Description, and Content.
   • To narrow down search results by Date, use the Publication Date dropdown at the bottom of the Filter menu and select the desired time period.
   • Finally, you can use the facets under the Amazon S3 filters along with the AND, OR, and NOT operators to further refine your search. Note that the filters and facets are only enabled when content matches the filters.
5. Review the filter result and adjust your filter options until you are satisfied with the result available in the preview post list. When ready click Next or the Settings tab.
6. On the Settings page you can change the name and description of your updated feed and select another target inbox.

Optionally: Check the Restricted checkbox to prevent others from updating the feed. When restricted a padlock icon will be shown on the Feed in InfoLab.

Press Save to save the updated feed.

Manage Amazon S3 Feeds

You can manage all your feeds from the InfoLab Feeds page.

To manage an Amazon S3 Feed, follow these steps:

1. Navigate to the InfoLab Feeds page from the main menu or start from your Inbox and select InfoLab from the More menu.
2. Use the search bar at the top of the page to find your feed.
3. Click the Menu button to the far right on the feed row to open the menu.

4. Select Edit to open the Preview and add Filter page and edit the feed. In the "Preview and filter a Amazon S3 Feed" section, you can find more instructions on how to edit a feed.

• Select Set Automatic Categorization to tag all posts from this feed automatically. Use the search bar or open the taxonomy to find and select categories. Press Save.
• Select Deactivate to pause your feed. A pause button will appear on the feed, and the feed will stop retrieving posts to your inbox.  
  Clicking Activate in the feed menu will reactivate the feed.
• To change the inbox where the feed is directed, click on Select inbox and select another inbox.
• Select Delete to delete the feed from InfoLab.