Module:CommunityProjectList: Difference between revisions

From MaRDI portal
Created page with "-- Required module containing helper methods local helper = require('Module:HelperMethods') -- Required modules for SPARQL queries and HTML table generation local sparql = require('SPARQL') local mwHtml = require('mw.html') -- Main table to hold all functions local p = {} -- Function to build a HTML table from SPARQL query results function p.buildTableFromSparql(frame) -- Retrieve target1 from frame arguments or return error message if not set local target1 = f..."
 
No edit summary
(21 intermediate revisions by the same user not shown)
Line 9: Line 9:
local p = {}
local p = {}


-- Function to build a HTML table from SPARQL query results
-- Function to convert JSON results into a comma-separated string
function p.buildTableFromSparql(frame)
function p.convertJsonToCommaSeparatedList(jsonResults)
    local resultsString = ""
 
    if jsonResults and jsonResults.results and jsonResults.results.bindings then
        local bindings = jsonResults.results.bindings
        for i = 0, #bindings do
            local binding = bindings[i]
            if binding.workLabel and binding.workLabel.value then
 
                local name = binding.workLabel.value
                local projectURL = binding.work.value  -- URI of the item
               
                -- set project URL if it exists
                if binding.projectURL then
                projectURL = binding.projectURL.value
                end
 
                local nameAndLink = "<li>[" .. projectURL .. " " .. name .. "]</li>"
 
                resultsString = resultsString .. nameAndLink
            end
        end
    end
 
    return "<ul>" .. resultsString .. "</ul>"
end
 
 
-- Function to build the list
function p.buildProjectList(frame)
     -- Retrieve target1 from frame arguments or return error message if not set
     -- Retrieve target1 from frame arguments or return error message if not set
Line 18: Line 47:
     end     
     end     
      
      
    local height = frame.args[2] or '400px' -- Default height if not specified
    local width = frame.args[3] or '800px' -- Default width if not specified
   
    -- Get the current URL
    local baseUrl = mw.site.server
     -- Constructing the SPARQL query with dynamic entity target1
     -- Constructing the SPARQL query with dynamic entity target1
     local sparqlQuery = [[
     local sparqlQuery = [[
Line 31: Line 53:
PREFIX wd: <https://portal.mardi4nfdi.de/entity/>
PREFIX wd: <https://portal.mardi4nfdi.de/entity/>


SELECT
SELECT DISTINCT ?work ?workLabel ?projectURL
  ?publication_date ?work ?workLabel  
  ?workUrl
  (REPLACE(STR(?work), "^.*/", "") AS ?qid)
  ?item_type
  ?item_type_label
  ?internal_project_id
 
WHERE {
WHERE {
   ?work wdt:P1495 target1: .
   ?work wdt:P1495 target1: .
  VALUES ?allowedValues { wd:Q5976449 wd:Q5976450 wd:Q5984635 }
   ?work wdt:P31 wd:Q6205094 .  
   ?work wdt:P1460 ?allowedValues.
   OPTIONAL { ?work wdt:P104 ?projectURL }
 
   SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en". ?work rdfs:label ?workLabel. }
  OPTIONAL {
    ?work wdt:P28 ?publication_datetime .
  }
  OPTIONAL {
    ?work wdt:P1496 ?internal_project_id .
  }
  OPTIONAL {
    ?work wdt:P170 ?last_updated .
  }
  BIND(COALESCE(xsd:date(?publication_datetime), xsd:date(?last_updated), "N/A") AS ?publication_date)
 
   OPTIONAL {
    ?work wdt:P1460 ?item_type .
    BIND(REPLACE(STR(?item_type), "^.*/(Q[0-9]+)$", "$1") AS ?item_type_short)
    BIND(IF(?item_type_short = "Q5976449", "Paper",
        IF(?item_type_short = "Q5984635", "Dataset",
        IF(?item_type_short = "Q5976450", "Software", "Other"))) AS ?item_type_label)
    BIND(CONCAT(
      IF(?item_type_short = "Q5976449", "]] .. baseUrl .. [[/wiki/Publication:",
      IF(?item_type_short = "Q5984635", "]] .. baseUrl .. [[/wiki/Dataset:",
      IF(?item_type_short = "Q5976450", "]] .. baseUrl .. [[/wiki/Software:", "]] .. baseUrl .. [[/wiki/"))),
      REPLACE(STR(?work), "^.*/Q", "")
    ) AS ?workUrl)
  }
 
   SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en". }
}
}


ORDER BY DESC(?publication_date)
ORDER BY ?workLabel
     ]]
     ]]
 
   
    mw.log( sparqlQuery )
   
-- Executing the SPARQL query and retrieving results in JSON format
-- Executing the SPARQL query and retrieving results in JSON format
-- mw.log( sparqlQuery )
local jsonResults = sparql.runQuery(sparqlQuery)
local jsonResults = sparql.runQuery(sparqlQuery)
-- mw.logObject(jsonResults)  
mw.logObject(jsonResults)


-- Handle error in SPARQL query execution
-- Handle error in SPARQL query execution
Line 91: Line 80:
         return "Could not fetch data."
         return "Could not fetch data."
end
end
 
if helper.countElementsInBindings(jsonResults.results.bindings) == 0 then
if helper.countElementsInBindings(jsonResults.results.bindings) == 0 then
         return "No records found."
         return "No records found."
end
end


-- Extracting headers from the SPARQL query results
local describedByList = p.convertJsonToCommaSeparatedList(jsonResults)
-- local headers = {}
-- if jsonResults and jsonResults.head and jsonResults.head.vars then
-- headers = jsonResults.head.vars
-- end
-- Convert the JSON results into a Lua table
-- mw.log(describedByList)  
    local fieldOrder = {"workUrl", "workLabel", "work", "publication_date", "qid", "internal_project_id", "item_type", "item_type_label"}
local dataTable = helper.convertJsonToTableOrdered(jsonResults, fieldOrder)
     -- Create and return HTML table from the data
     return describedByList
    local headers = {"Publication", "Date of Publication", "Project", "Type"}
    local htmlTable =  helper.createHtmlTableWithMergedCols(dataTable, headers, {{1, 2}, {4}, {6}, {7, 8}})
 
-- Generate histogram data
    local histogramChart = helper.generateHistogramChartFromTable(dataTable, 4)
    local histogramChartJson = mw.text.jsonEncode(histogramChart)
   
    -- mw.log(histogramDataJson)
   
    -- Create a parent container for both the table and the chart
local parentContainer = mw.html.create('div')
    :addClass('parent-container')
    :css('width', width) -- Set the width as needed
 
    -- Create chart container
    local chartContainer = mw.html.create('div')
        :addClass('wikiChartContainer')
        :css('height', height)
        :css('width', width)
        :attr('data-chartdata', histogramChartJson)
 
local heading = mw.html.create('h2')
    :wikitext('Research outcomes over time')
 
    -- Add the table and chart to the parent container
parentContainer
    :node(htmlTable)
        :node(heading)
    :node(chartContainer)
 
    return tostring(parentContainer)
end
end


-- Return the created html table
-- Return the created html table
return p
return p

Revision as of 19:49, 7 May 2024

Documentation for this module may be created at Module:CommunityProjectList/doc

-- Required module containing helper methods
local helper = require('Module:HelperMethods')

-- Required modules for SPARQL queries and HTML table generation
local sparql = require('SPARQL')
local mwHtml = require('mw.html')

-- Main table to hold all functions
local p = {}

-- Function to convert JSON results into a comma-separated string
function p.convertJsonToCommaSeparatedList(jsonResults)
    local resultsString = ""

    if jsonResults and jsonResults.results and jsonResults.results.bindings then
        local bindings = jsonResults.results.bindings
        for i = 0, #bindings do 
            local binding = bindings[i]
            if binding.workLabel and binding.workLabel.value then

                local name = binding.workLabel.value
                local projectURL = binding.work.value  -- URI of the item
                
                -- set project URL if it exists
                if binding.projectURL then
                	projectURL = binding.projectURL.value
                end

                local nameAndLink = "<li>[" .. projectURL .. " " .. name .. "]</li>"

                resultsString = resultsString .. nameAndLink
            end
        end
    end

    return "<ul>" .. resultsString .. "</ul>"
end


-- Function to build the list
function p.buildProjectList(frame)
	
    -- Retrieve target1 from frame arguments or return error message if not set
	local target1 = frame.args[1]
    if not target1 or target1 == '' then
        return "No records found"
    end    
    
    -- Constructing the SPARQL query with dynamic entity target1
    local sparqlQuery = [[
PREFIX target1: <https://portal.mardi4nfdi.de/entity/]] .. target1 .. [[>
PREFIX wdt: <https://portal.mardi4nfdi.de/prop/direct/>
PREFIX wd: <https://portal.mardi4nfdi.de/entity/>

SELECT DISTINCT ?work ?workLabel ?projectURL
WHERE {
  ?work wdt:P1495 target1: .
  ?work wdt:P31 wd:Q6205094 . 
  OPTIONAL { ?work wdt:P104 ?projectURL }
  SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en". ?work rdfs:label ?workLabel. }
}

ORDER BY ?workLabel
    ]]
    
    mw.log( sparqlQuery )
    
	-- Executing the SPARQL query and retrieving results in JSON format
	local jsonResults = sparql.runQuery(sparqlQuery)
	
	mw.logObject(jsonResults)

	-- Handle error in SPARQL query execution
	if jsonResults and jsonResults.error then
    	mw.log("Error in SPARQL query: " .. tostring(jsonResults.error))
    	return nil
	end

	if not jsonResults then
        return "Could not fetch data."
	end
	
	if helper.countElementsInBindings(jsonResults.results.bindings) == 0 then
        return "No records found."
	end

	local describedByList = p.convertJsonToCommaSeparatedList(jsonResults)
	
	-- mw.log(describedByList) 
	
    return describedByList
end

-- Return the created html table
return p