EPrints Technical Mailing List Archive

Message: #01064

[EP-tech] Re: How to customise Division listings

To: "'eprints-tech@ecs.soton.ac.uk'" <eprints-tech@ecs.soton.ac.uk>, "'Chew Bee Leng'" <blchew@wou.edu.my>
Subject: [EP-tech] Re: How to customise Division listings
From: John Salter <J.Salter@leeds.ac.uk>
Date: Wed, 12 Sep 2012 12:27:29 +0100

Hi Chew,

For your archive, there should be a directory in /usr/share/eprints/archives/ - this is the 'ARCHIVENAME'.

Is this called 'eprint'? If not, use the name in there.

The format of the subject export is described in here: http://wiki.eprints.org/w/EPrints_3_Organisation_Hierarchy

For the LOC node, does the link I sent work (http://your.server /cgi/users/home?screen=Subject%3A%3AEdit&dataobj=subjects - putting the correct server name in)?

The workflow looks OK.

Cheers,

John

From: eprints-tech-bounces@ecs.soton.ac.uk [mailto:eprints-tech-bounces@ecs.soton.ac.uk] On Behalf Of Chew Bee Leng
Sent: 12 September 2012 11:12
To: 'eprints-tech@ecs.soton.ac.uk'; John Salter
Subject: [EP-tech] Re: How to customise Division listings

Hi John

1. Yes, all the child nodes are depositable. Am still having trouble to name the LOC nodes, via the Admin editing. Unable to click the blank row and go beyond it to name the subject.

2. Can you show a sample of an exported subject tree? Our ITS tried to export as per attached, but I think this is incorrect.

Is our ARCHIVENAME refers to "eprint"?

So, the correct command to export that we should use is:

usr/share/eprints/bin/export eprint subject Subjects

3. Extracting from the workflow default.xml file content, is this script below <component><field ref="divisions"/></component> complete?

<epc:if test="type = 'performance'">
  <component collapse="yes"><field ref="producers"/></component>
  <component collapse="yes"><field ref="conductors"/></component>
  <component collapse="yes"><field ref="accompaniment"/></component>
  </epc:if>

  <component><field ref="divisions" /></component>

  <component type="Field::Multi">
  <title>Publication Details</title>
  <epc:if test="type != 'patent' ">
  <epc:if test="type.one_of('book_section', 'book', 'article', 'conference_item')">
  <field ref="refereed" required="yes" />
  </epc:if>
  <epc:if test="type != 'artefact' and type != 'exhibition'">
  <field ref="ispublished" required="yes" />

The script in the eprint_fields.pl is correct.

many thanks.

chew

>>> On Tuesday, September 11, 2012 at 10:40 PM, in message <7154BCBB8909D642AE6F44CA713DBC20056B9EB63142@HERMES7.ds.leeds.ac.uk>, John Salter <J.Salter@leeds.ac.uk> wrote:

Hi,

Sorry for the delay, I was on holiday for a few days.

All the subjects are stored in the database - so looking for them in /usr/share/eprints/... won't work ;o)

Firstly, it looks like you now have the subject tree correct. :o) There is a node called 'divisions', which has the correct child nodes.

I would check the child nodes are all 'depositable' (e.g. click the link for 'Educational Technology and Publishing' and check is has 'Yes' for depositable).

If this is all correct, I'm not sure what the issue is!

Firstly I would give the Library of Congress node a name (http://your.server /cgi/users/home?screen=Subject%3A%3AEdit&dataobj=subjects) - so we can see it easier.

You could email me the subject tree (off list might be appropriate). You can export it using the following command (replacing ARCHIVENAME with your archive name!):

/usr/share/eprints/bin/export ARCHIVENAME subject Subjects

The info below may help understand how a subject field is used in the workflow.

To go through how a subject field is used in the workflow, using 'divisions' as an example:

This is referenced in the workflow (/usr/share/eprints/archives/[ARCHIVENAME]/cfg/workflows/eprint/default.xml) - which can be viewed through the web admin interface Admin->Config Tools->View Configuration. Click workflows->eprint->default.xml) as:

This in turn comes from /usr/share/eprints/archives/[ARCHIVENAME]/cfg/cfg.d/eprint_fields.pl (again you can see it in the web interface):

{
name => 'divisions',
type => 'subject',
multiple => 1,
top => 'divisions',
browse_link => 'divisions',
},

The 'top' element is the id of the node to use as the base of the input.

So, if you have a subject with an id of 'divisions', an eprint field of type 'subject' with 'top' set to 'divisions', and a workflow component with a field ref="divisions", everything should be OK.

Hope some of that helps!

Cheers,

John

From: Chew Bee Leng [mailto:blchew@wou.edu.my]
Sent: 10 September 2012 07:33
To: 'eprints-tech@ecs.soton.ac.uk'; John Salter
Subject: [EP-tech] Re: How to customise Division listings

Hi John

Firebug is so useful. The default node was entitled "Library of Congress Subject Areas". Somehow I can't trace the page source file for it, can you guide on the directory path as I've checked through the folders/sub folders. (usr/share/eprints/cgi/users/home)

Pending the update of the unnamed node, the Division listing of our University Structure is still not showing the correct listings, can't figure out why though. Only displayed "Chancellory", this could be from old structure listing. How to do the linking to the latest listing? Is there a source page to edit this as well?

thanks.

chew

>>> On Tuesday, September 04, 2012 at 5:52 PM, in message <EMEW3|c77313f906f85017670f1a3bb955c824o83AyR14eprints-tech-bounces|ecs.soton.ac.uk|7154BCBB8909D642AE6F44CA713DBC20056B9EB63114@HERMES7.ds.leeds.ac.uk>, John Salter <J.Salter@leeds.ac.uk> wrote:

From the image, if you click the link 'University Structure', are there any child-nodes listed?

If there are, unlink these first, and then go back to the top level screen (as shown on the right of your image) and click the unlink next to 'University Structure'.

I'm not sure what the node without a name is (with the five children).

If you know how to use Firebug (extension for Firefox), you may be able to look at the structure of the html and there might be be empty link in the table cell to the left of the '5' value. You can add some text to it in Firebug and click it to edit it.

If not, you could look at the page source and search for:

Just before this in the source code look for a link like:
<a href=""> (XXX will be something else!)

You can paste this URL into a browser and add a title to the node so you can edit it.

Again, let em know if there are more questions!

Cheers,

John

From: eprints-tech-bounces@ecs.soton.ac.uk [mailto:eprints-tech-bounces@ecs.soton.ac.uk] On Behalf Of Chew Bee Leng
Sent: 04 September 2012 02:53
To: 'eprints-tech@ecs.soton.ac.uk'; ".Salter"@leeds.ac.uk
Subject: [EP-tech] Re: How to customise Division listings

Hi John

Thanks, we were closed for few days for our National Day. I've completed till step 4 below, wasn't sure of step 5 onwards, hope you can help again.

For Step (5) to remove the old "University Structure" refers to clicking at the Unlink, then click unlink on all the existing old sub-nodes? Is this correct.

The Eprint box column value should always be a zero value? I attached herewith the latest configuration for your perusal.

Is there a need to restart server after completing all the steps?

Regards

Chew

>>> On Thursday, August 30, 2012 at 9:33 PM, in message <EMEW3|13d3dc89d34be1d9539b5214a4069763o7YEYn14eprints-tech-bounces|ecs.soton.ac.uk|7154BCBB8909D642AE6F44CA713DBC20056B9EB630FA@HERMES7.ds.leeds.ac.uk>, John Salter <J.Salter@leeds.ac.uk> wrote:

Hi Chew,

You can view the configuration files in the admin interface - without going to the command line:

Admin -> Config Tools -> View Configuration (and then select the file). It's good to understand this a little bit.

To solve your divisions issue, I would do the following:

1. From the top-level of the subjects, enter 'divisions' as a Subject ID string, and click 'create'.

2. Enter a name for it ('new university structure' - so you can tell which one is which - you can edit the name later!)

3. From the new node ( URL should be ...dataobj=divisions), link each of your new nodes: Link existing subject -> choose 'LI' for 'Learning and Library'.

4. After linking all the divisions to the 'new university structure', you should be able to unlink them from the top-level.

5. Remove the old 'University Structure'

6. Rename the 'new university structure' to 'University Structure'.

7. :o)

Hopefully that will sort thinks out.

Cheers,

John

From: Chew Bee Leng [mailto:blchew@wou.edu.my]
Sent: 30 August 2012 13:52
To: 'eprints-tech@ecs.soton.ac.uk'; John Salter
Subject: RE: [EP-tech] Re: How to customise Division listings

Hi John

As per your request. Our Eprint 3 is currently for in-campus access only:

Top-level

http://eprint.wou.edu.my/cgi/users/home?screen=Subject%3A%3AEdit

University Structure

http://eprint.wou.edu.my/cgi/users/home?screen=Subject%3A%3AEdit&dataobj=UA

Learning and Library Services

http://eprint.wou.edu.my/cgi/users/home?screen=Subject%3A%3AEdit&dataobj=LI

I'm not too good with programming language, but I'll try to understand the command line belows. Yes, you're right, I've done it incorrectly. I think I have actually deleted the University Structure and sub-divisions by clicking the Unlink and remove each of them.

Many thanks for your assistance and time to assist me on this.

Chew

>>> On Thursday, August 30, 2012 at 5:20 PM, in message <7154BCBB8909D642AE6F44CA713DBC20056B9EB630EB@HERMES7.ds.leeds.ac.uk>, John Salter <J.Salter@leeds.ac.uk> wrote:

Hi Chew,

Can you email me the URL of the page when you are editing the top-level of the subjects. It doesn't matter if I can not get to the server - the URL should be enough to help.

E.g.

Admin-> Edit Subjects: http://your.server.name/cgi/users/home?screen=Subject%3A%3AEdit

-> University Structure: http://your.server.name/cgi/users/home?screen=Subject%3A%3AEdit&dataobj=divisions

and

-> Library Services: http://your.server.name/....?

A fresh install of EPrints has two (if I remember correctly) default subject trees: 'Library of Congress' and 'University Structure'. I think what you have done is added items at the same level as these, instead of adding the divisions to the 'University Structure'.

In the eprint workflow (~/archives/[ARCHIVEID]/cfg/workflows/eprint/default.xml), you should be able to see a component like:

(Compare this with the 'subject' component in the workflow too).

If you look at the definition of the 'divisions' field in ~/archives/[ARCHIVEID]/cfg/cfg.d/eprint_fields.pl:

{
name => 'divisions',
type => 'subject',
multiple => 1,
top => 'divisions',
browse_link => 'divisions',
},

the value of 'top' shows where in the subject tree (both divisions and subjects) it will render from. I suspect that you have added items alongside 'divisions' instead of beneath it.

If you want to see a fresh install of the EPrints, you can use http://demoprints.eprints.org - if you register, you can make yourself an admin and edit the subject tree on there too.

Cheers,

John

From: Chew Bee Leng [mailto:blchew@wou.edu.my]
Sent: 30 August 2012 05:16
To: eprints-tech@ecs.soton.ac.uk; John Salter
Subject: [EP-tech] Re: How to customise Division listings

Hi John

Many thanks for the clear explanation. The listing is still not being updated, can view 1 of 10 only. I applied the same setting for all. I've actually redo and assigned subject ID string for each divisions created. Currently our divisions are a unit by itself, so we are not using the Link Existing Subject. I've actually added 9 other divisions and did the Depositable settings to "Yes" for all. Can you have a look at the attached print screens, probably the Top Level setting is incorrect. The first row header which is blank refers to the "Library of Congress Subject Areas" (Eprint 5), which I'm unable to reedit it.

I've tried Config Tool--> Update Database step as well, no luck.

Thanks again.

Chew

>>> On Wednesday, August 29, 2012 at 6:42 PM, in message <EMEW3|9c2269f132bb06813820b031e23694e1o7SBi314eprints-tech-bounces|ecs.soton.ac.uk|7154BCBB8909D642AE6F44CA713DBC20056B9EB630E5@HERMES7.ds.leeds.ac.uk>, John Salter <J.Salter@leeds.ac.uk> wrote:

Hi,

For the nodes that don't display, check that 'Depositable' is set to 'Yes', or that there are some child-nodes to the item.

E.g. In admin (from the screen shot you attached), click the 'Learning & Library Services' link.

Either add children, or make it depositable.

The 'Subject ID string' is required - and is used as the key in the database. If your institution already has a identifiers for divisions, you may be able to use them (makes joining EPrints to a central systems easier).

The 'Link Existing Subject' allows you to make a complex tree with cross-links between branches. E.g. if you have a division that belongs in both 'Learning & Library Services' and 'Chancellory', create the child in one place, and link it from the other place (don't know if I have explained that well enough?).

Hope that helps more!

Cheers,

John

From: eprints-tech-bounces@ecs.soton.ac.uk [mailto:eprints-tech-bounces@ecs.soton.ac.uk] On Behalf Of Chew Bee Leng
Sent: 29 August 2012 10:49
To: 'eprints-tech@ecs.soton.ac.uk'
Subject: [EP-tech] Re: How to customise Division listings

Hi John

Tq..somehow the edited output doesn't display correctly, showed only one out of 3. Can you advise what's wrong?

Is the subject ID string and link existing subject compulsory and related to each divisions created? What does the value "0" represent in the Eprint column box under each "children". I attached the latest configuration made for your understanding. Thanks for the assistance.

Chew

>>> On Wednesday, August 29, 2012 at 4:55 PM, in message <EMEW3|428afa77722a0ffe5f4459808d6d11f8o7S9vB14eprints-tech-bounces|ecs.soton.ac.uk|7154BCBB8909D642AE6F44CA713DBC20056B9EB630E1@HERMES7.ds.leeds.ac.uk>, John Salter <J.Salter@leeds.ac.uk> wrote:

Hi (and welcome to EPrints :o),

The 'Divisions' is a subject-tree, and can be edited using the 'Edit Subjects' link (below the 'Phrase Editor' button in Admin->Edit Config).

Choose the 'University Structure' to edit the divisions.

Cheers,

John

From: eprints-tech-bounces@ecs.soton.ac.uk [mailto:eprints-tech-bounces@ecs.soton.ac.uk] On Behalf Of Chew Bee Leng
Sent: 29 August 2012 03:40
To: eprints-tech@ecs.soton.ac.uk
Subject: [EP-tech] How to customise Division listings

Dear Sir

Our library s a new user to Eprint 3. We would like to seek assistance on how administrator can customize the Divisions drop-down listings as per attached.

Please advise how to do this and which server configuration file to access to. Going through the Admin --> Configuration Tools --> Phrase Editor doesn't help with the editing.

Appreciate your technical advise. Thank you very much.

Regards

Bee Leng

Chew Bee Leng

Assistant Library Manager | Learning & Library Services

T +60 4 2180 180 | F +60 4 227 9214

E blchew@wou.edu.my

54 Jalan Sultan Ahmad Shah

10050 George Town, Penang, Malaysia

With WOU's Open & Distance Learning model, you have easy access to one of the most flexible and affordable quality higher education in the country. Enrol now for WOU's new Master of Education. And check out our new Ph.D and Master of Phil. (in Arts & Humanities) and Post-Graduate Diploma in Business Administration. With WOU, you are in control of your future

DISCLAIMER: This email, together with any attachments, is intended for the named recipient(s) only and is confidential. Any views or opinions presented in this email are solely those of the author and do not necessarily represent those of Wawasan Open University. If you are not the intended recipient, you may not copy or disclose its contents to anyone. Please notify the sender immediately and delete this message and any attachments from your system. While this email has been scanned for the presence of computer viruses, you are advised to perform your own virus scan. Wawasan Open University accepts no liability whatsoever that may arise from or in connection with this email and/or its attachments.

References:
- [EP-tech] Re: How to customise Division listings
  - From: John Salter <J.Salter@leeds.ac.uk>
- [EP-tech] Re: How to customise Division listings
  - From: "Chew Bee Leng" <blchew@wou.edu.my>
- [EP-tech] Re: How to customise Division listings
  - From: John Salter <J.Salter@leeds.ac.uk>
- [EP-tech] Re: How to customise Division listings
  - From: "Chew Bee Leng" <blchew@wou.edu.my>
- [EP-tech] Re: How to customise Division listings
  - From: John Salter <J.Salter@leeds.ac.uk>
- [EP-tech] Re: How to customise Division listings
  - From: "Chew Bee Leng" <blchew@wou.edu.my>

Prev by Date: [EP-tech] Re: Eprints System Error- Can't open to write to XML
Next by Date: [EP-tech] Re: Citation import plugin errors
Previous by thread: [EP-tech] Re: How to customise Division listings
Next by thread: [EP-tech] import "feature"
Index(es):
- Date
- Thread