Creating Zotero Flows

Data-Intensive Technologies and Applications,National Center for Supercomputing Applications,

University of Illinois at Urbana-Champaign

Outline

• Zotero Flow• SEASR Configuration File• VUE-SEASR Configuration File

SEASR Plugin Preferences

• Configuration files are managed in a list

• Each configuration file can be enabled or disabled

• Reload will refresh the plugin with the flows in the configuration files

Extensible to Analysis that You Create

• You can deploy the flows we have on your server or request your university to host this analysis

• You can modify these flows and redeploy• You can create new flows

– Perhaps you want to see only nouns or verbs– Perhaps you want to see a list of extracted entities

• You can share these flows back to the community

Configuration File (XML or json)• Contains 2 attribute-value pairs

– name: label to use in the Zotero drop-down display– url: url for where to send the post

• XML<seasr_analytics> <flows> <flow name="Author Centrality Analysis"

url="http://services.seasr.org:10000/http://seasr.org/flows/zotero-social-network/instance/service-head-post/1"/>

</flows></seasr_analytics>• json{"seasr_flows":[{"name":"Author Centrality Analysis",

"url":"http://services.seasr.org:1718/meandre://seasr.org/components/zotero/service-head-post/instance/shp" } ,

{"name":"Flesch-Kincaid Readability Test", "url":"http://services.seasr.org:1721/meandre://seasr.org/components/zotero/service-head-post/instance/shp" }

]}

What does a Web Service Flow Look LikeCommon components used for creating a web

service flow• Service Head Post

– Receives the http post and sends the data to the rest of the flow

• Service Tail Text– Send the results back to the http request

Another Zotero Service Flow

Components that read Zotero data from the web service

• Zotero Author Extractor (previous slide)– Extracts the author-coauthor from each item

• Zotero URL Extractor– Extracts the url from each item

VUE-SEASR Configuration File (XML)<?xml version="1.0" encoding="UTF-8"?><seasr_analytics> <flow_group label="Create New Nodes" input="one"

output="map”><flow label="Resource Word Count" uri="http://vue.tufts.edu/word-counts-vuetokenizer/word-counts-for-vue-using-vue-tokenizer/" url="http://vue-dl.tccs.tufts.edu:1719/service/ping" duplicate="false" >

<input>location</input> </flow> </flow_group> <flow_group label="Add Metadata" input="one" output="map" >

<flow label="Resource Word Count" uri="http://vue.tufts.edu/word-counts-vuetokenizer/word-counts-for-vue-using-vue-tokenizer/" url="http://vue-dl.tccs.tufts.edu:1719/service/ping" duplicate="false”>

<input>location</input></flow>

</flow_group> <flow_group label="Add Notes" input="one" output="map" > <flow label="Resource Word Count" uri="http://vue.tufts.edu/word-

counts-vuetokenizer/word-counts-for-vue-using-vue-tokenizer/" url="http://vue-dl.tccs.tufts.edu:1719/service/ping" >

<input>location</input></flow>

</flow_group></seasr_analytics>

Demonstration • We will go through an example of what a Zotero-

enabled flow looks like and what's special about it • We will show how to modify an existing Zotero-

enabled flow and how to "deploy" it so that it can be leveraged within Zotero

Local Setup

• Copy config file to your machine from–

http://repository.seasr.org/Zotero/config/seasr.config

• In Zotero, – Select Preferences from Menu– Go to SEASR

• Click Add– Specify a Provider Name– Specify a URL for the config file (

file:///Users/lauvil/Sites/zotero.config)– Click box for Enabled

• Note: In the future, after editing the config you only need to click “Reload”

Learning Exercises

1. Create a new flow (or adapt an existing flow) using the Meandre Workbench that performs some simple analysis and "deploy" it for access by Zotero

1. We can use the flow we constructed in an earlier session as a base

2. Execute this flow 3. Change the configuration of SEASR plugin so that it

knows how to access this flow4. From Zotero, refresh the configuration file5. Select some data to process through the updated

SEASR flow

Discussion Questions

• What kinds of data assets would you be creating in Zotero?

• What other analysis would you like to use against this data?