Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

 

Aspire CEWS Listener Configuration


Step 1. Launch Aspire and open the Services Management Page

Launch Aspire (if it's not already running). See:

Step 2. Add and configure a new CEWS Service Service

  1. In the selector dialog click on SharePoint 2013 CEWS Listener
  2. In the Service endpoint enter http://0.0.0.0:62028/CEWebService.svc to let the service listen on all available network interfaces or a specific IP address if desired
  3. Check the Filter return box and add the names of the Properties to be returned by this Content Enrichment service. These must be the same fields as configured with SharePoint's Set-SPEnterpriseSearchContentEnrichmentConfiguration cmdlet. If this is not configured, the default return values are returned with any custom properties populated in the workflow.
  4. An application tag is added to the settings.xml file, for example:

    Code Block
    languagexml
    themeFadeToGrey
    <application config="com.searchtechnologies.aspire:app-sp2013-content-enrichment" id="13">
    	<properties>
    		<property name="debug">false</property>
    		<property name="endpoint">http://0.0.0.0:62027/CEWebService.svc</property>
    		<property name="filterReturn">true</property>
    		<property name="returnProperties">Author,Title</property>
    		<property name="contentSource">CEWSWorkflow</property> <!-- only required in versions before 2.2 -->
    		<property name="workflowReloadPeriod">15s</property>
    		<property name="workflowErrorTolerant">false</property>
    	</properties>
    </application>


Image Removed

Step 3.

Add a new Publish to aa to the Workflow

To add a Publish to aa drag from the Publish to aa rule from the Workflow Library and drop to the Workflow Tree where you want to add it. This will automatically open the Publish to aa window for the configuration of the publisher.

Step 3a. Specify Publisher Information

 In the Publish to aa window, specify the connection information to publish to the asdf.

Configure data enrichment through a groovy script in the workflow

Once the SP2013 Content Enrichment service has been created, you can modify the workflow responsible for populating the properties/fields returned to SharePoint. Only the onProcess workflow is available, but all Aspire workflow functions may be used.

For more information on groovy scripting go here.


Image Added

Step 4. Populating return values

CEWS allows different types of return values. These must be defined when adding them to the Aspire object, for example an array of strings:

import java.util.Arrays;
 
def CEWSString = doc.add("CEWSString").setAttribute("type""PropertyOfArrayOfstring");
CEWSString.setContent(Arrays.asList("External SharePoint""External SharePoint|External Teamsites"));


Integer values should be handled as the following example suggests:

def CEWSInteger = doc.add("CEWSInteger").setAttribute("type""PropertyOfint");
CEWSInteger.setContent(11);


Numeric arrays (Integer and Double) should be handled as the following example:

def CEWSArrayInteger = doc.add("CEWSArrayInteger").setAttribute("type""PropertyOfArrayOfint");
Arrays.asList("750""850").each() { val ->
    CEWSArrayInteger.add("value", val);
}
 
def CEWSArrayDouble = doc.add("CEWSArrayDouble").setAttribute("type""PropertyOfArrayOfdouble");
Arrays.asList("750.8888""850.4444").each() { val ->
    CEWSArrayDouble.add("value", val);
}


Possible value types are:

  • PropertyOfArrayOfdouble
  • PropertyOfArrayOfint
  • PropertyOfArrayOfstring
  • PropertyOfboolean
  • PropertyOfdateTime
  • PropertyOfdouble
  • PropertyOfint
  • PropertyOfstring

Default Return Values

The Aspire CEWS service returns those fields by default:

Name

Type

Value

aspireCEEndpointPropertyOfstringAddress of Aspire CEWS endpoint, e.g. http://dehensve79.henkelgroup.net:62028/CEWebService.svc
aspireCESchemaPropertyOfstringhttp://schemas.microsoft.com/office/server/search/contentprocessing/2012/01/ContentProcessingEnrichment
aspireFeederLabelPropertyOfstringceWebService

Additionally, all fields passed into the service are returned as well.

Those fields must be defined when configuring SharePoint.

ExampleExample


Once you've clicked on the Add button, it will take a moment for Aspire to download all of the necessary components (the Jar files) from the Maven repository and load them into Aspire. Once that's done, the publisher will appear in the Workflow Tree.

Info

For details on using the Workflow section, please refer to Workflow introduction.