Mindbreeze GmbH, A-4020 Linz, 2022.
All rights reserved. All hardware and software names used are brand names and/or trademarks of their respective manufacturers.
These documents are strictly confidential. The submission and presentation of these documents does not confer any rights to our software, our services and service outcomes, or any other protected rights. The dissemination, publication, or reproduction hereof is prohibited.
For ease of readability, gender differentiation has been waived. Corresponding terms and definitions apply within the meaning and intent of the principle of equal treatment for both sexes.
To enable the Mindbreeze Yammer Connector to access Yammer content, a Mindbreeze application needs to be registered in Yammer first. In principle, every Yammer user can register applications.. However, only content that the Yammer user can see will be indexed. It is recommended to create an own Yammer user for the Mindbreeze indexing. This user must then be added to all Yammer groups that are of interest in the indexing process. The result of the registration is an Authorisation Token, which is then used to configure the Mindbreeze Yammer Connector.
You can register a Mindbreeze application by following the steps below:
It is important that you select http://localhost/yammerredirect in the “Redirect URI” section, which will make it easier to call up the authorization token.
Click on “Continue”. Double-check to ensure that the information was entered correctly.
The token created during registration for the app (see section “Registering a Mindbreeze app in Yammer”).
Disable Message Title
If activated, no titles are set for message-(posts-)documents. If the title is not necessary, this can improve the search relevance compared to other data sources.
Max File Size (MB)
Determines the maximum size (in MB) of documents that are indexed. This applies to documents of type "Attachment". Attachments that are too large are skipped.
Full Crawl Page Size Time Span (Days)
The Yammer Export API is used for downloading the threads, where a time span can be specified in which period the exported messages / threads have been created. This option can be used to configure the number of days for this time span.
Include Creator Metadata For Groups
If name and email address of the creators of the Yammer groups should be indexed as metadata. Active by default. May result in slight performance improvements during indexing the groups if this option is disabled.
Messages Since (ISO 8601)
Messages older than the configured date are not indexed. The configured date must be in ISO 8601 format (with time zone), e.g. 2010-01-01T00:00:00+00:00
Read Timeout Minutes
Time in minutes, how long the crawler waits at maximum for API responses.
Log Paging Requests To CSV
When enabled, all API requests to Yammer that use paging are logged in a separate .csv log file. This option should only be used for troubleshooting in case of issues.
Enable Delta Crawling
If active, only new messages (including attachments) from Yammer are indexed during a crawl run. However, groups will still be crawled completely. Note that deleted messages cannot be detected during a delta crawl run. Please make sure that you activate a "Full Crawl Schedule" so that deleted messages are also handled.
Full Crawl Schedule
If the entered extended cron expression is triggered, the next crawl run will be a full crawl run (instead of a delta crawl run). Only effective if "Enable Delta Crawling" is active. Documentation and examples of Cron Expressions can be found .
The token created during registration for the app (see section Registering a Mindbreeze app in Yammer).
If you notice errors of this type in the crawler or principal resolution service log:
Error on requesting url: 'https://www.yammer.com/api/v1/groups/123456/members.json' status: 403 responseContent: 'Forbidden'
Then this indicates a permission problem with the Yammer user used for crawling. A possible solution to this problem is to change the "Content Mode". To do this, navigate to the "Network Admin" settings in Yammer under "Edit network admin settings" and then "Content Mode" under "Content and Security". Select "Private Content Mode". This allows the crawler to access all necessary APIs so that, for example, user groups and permissions can be mapped correctly. Repeat the crawl run or the Principal Resolution Service update, there should now be no more "403 Forbidden" errors.
Important note: The Mindbreeze Yammer Connector does not index private Yammer messages (regardless of the "Content and Security" setting). All messages are checked, private messages are explicitly ignored and not indexed.