ISDF Function on ICA-AtoM

[josepm...@gmail.com]

Hello,

My name is José and I'm trying to see if I can implement Ica-AtoM on an archival belonging to a public institution. If you could help me I would be very grateful.

One of the things it was requested to me was to implement a functional classification scheme on the documents to be described in Ica-AtoM.

I know you have ISDF standard in Ica-atom, but I'm having difficulties in classifying the documents (in item level), that is to say I just don´t know how to associate the item to the respective function classification classe, since there is no field to do so in the archival description of the item.

How was the system designed to use functions? How can we associate them to items?

Thank you for your help. Best regards.

[JBushey, ICA-AtoM Product Manager]

Dear José,

Have you reviewed the ICA-AtoM user manual section on Functions?
Here is a link to the main page: https://www.ica-atom.org/doc/Add/edit_functions.
One area you might want to review is the section on ISDF relationships: https://www.ica-atom.org/doc/ISDF_relationships_area.
The Manitoba Archival Information Network is using ICA-AtoM and has a very good example of functions. Here is their browse functions page: http://nanna.lib.umanitoba.ca/icaatom/index.php/;function/browse and here is a view page for a function: http://nanna.lib.umanitoba.ca/icaatom/index.php/student-administration-and-support-services;isdf. I hope these examples help.

Regards,
Jessica Bushey

[JBushey, ICA-AtoM Product Manager]

Dear Jessica,

Thank you for your reply, and thank you for your article on ICA-AtoM. It was one of the first I read on this software.

I already had study the information you linked me with, except the one of Manitoba.
Regarding Manitoba, I don't understand to what end do they use the functions. They don't relate them to the descriptions or the authority records...
They really describe and relate them very well, but I don't find the link between them and anything else. Sorry for my ignorance.

I think I'm grasping the main problem with applying ICA-AtoM to my project, in this regard:
Designing a functional classification scheme (FCS)  and do the input into the ICA-AtoM is not an issue. The problem is that the ICA-AtoM system is strictly based on the metainformation included in each of the standards you use to design the page itself (ex. ISAD(G), ISDF).
My problem is that in applying the FCS I don't have a metainformation field in the archival description page in which I can link the document/item to the corresponding functional class. I have to link it using the relationship area of the function description page, using related resources. That is to say I need to edit the function itself (or activity, process or whatever class I'll be using). This makes it very difficult to relate the items to the functions, and makes it almost impossible since the list of related resources to each function will be huge...

Was this possibility (using FCS) addressed when introducing/developing the ISDF in the software? Or am I trying to do something that the software doesn't really support?

My english is not the best, so I apologize if the ideas are not clear. I just want to see if I can understand this.

Thank you very much. I really appreciate your help and the software itself (congratulations for it. It is very intuitive and useful). 

Best regards,
José Santos

[Jessica Bushey]

Dear José,

The ICA-AtoM workflow for Functions is to create a function and then create relationships to existing Authority Records and Archival Descriptions. The software does not currently support adding functions to archival descriptions "on the fly", or in the same manner that access points can be added. Part of the reason behind this is that Functions are a intended to describe the activities of records creators and other actors linked to records creation and maintenance. It may help to review the ISDF standard we have available on our documentation wiki: https://www.ica-atom.org/doc/RS-4#Nature_of_relationships_2. 

That being said, I do understand your frustration. And I will ask one of the developers to review your question and provide an answer based on the functionality of the software, as that may explain our workflow further.

Regards,

Jessica Bushey

---

Jessica Bushey, MAS
ICA-AtoM Product Manager

Systems Analyst
jes...@artefactual.com

Artefactual Systems Inc.
www.artefactual.com

--
You received this message because you are subscribed to the Google Groups "ICA-AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To post to this group, send email to ica-ato...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msg/ica-atom-users/-/q730Kn5ytw8J.
For more options, visit https://groups.google.com/groups/opt_out.
 
 

[José Santos]

Dear Jessica,

I understand your reply.

According to the ISDF (english version), page 7, item 1.3, “Functions are therefore well suited to act as:  a basis for the arrangement, classification and description of records”. So I thought their usage as a classification scheme would be intended.

Since this is not the case, I’m trying to adapt.

The solution I’m exploring is using the access point “places” taxonomy, and incorporating there the functional classification scheme.

In using this solution some questions/difficulties arise, for which I ask your help:

1.     1- Changing the taxonomy name visible to the users – I go to Admin/menus and change the taxonomy name to “classification”. Nevertheless, the taxonomy browse page, the taxonomy list page and some titles that the software creates automatically still use “places”. How do I change these elements/names?

      2- In the “places” taxonomy, when we enter in a place, a google map is displayed. I need to take out the map. How can I do it?

Regards,

José Santos

[Jessica Bushey]

Dear Jose,

Unfortunately the User Interface only allows you to change the browse menu name [Admin -> menus] and label name [Admin -> Site settings -> User interface labels].

I don't know if you have considered creating a New Taxonomy, or what your level of skill and comfort is with working on a more technical level with the software… but here is a link to "How to create a new taxonomy": https://www.qubit-toolkit.org/wiki/How_to_create_a_new_taxonomy. This might be useful. 

If you are still interested in pursuing the Places taxonomy as your Classification taxonomy, and need to remove the google map, please let me know and I will ask one of the developers to respond.

Regards,

Jessica

To view this discussion on the web visit https://groups.google.com/d/msg/ica-atom-users/-/b1DaRSnPg28J.

[José Santos]

Dear Jessica,

I haven´t thought in that solution (new taxonomy) but it may be the best one if I don't solve the "Places" taxonomy name change.

Thank you. I'm no expert in programming but I think I can manage the instructions you linked to me.

As a last attempt to solve the name change can you please ask a developer if this is possible: since I'm working in portuguese language, isn't it possible to change the text string that corresponds to the "Places" translation to portuguese? If so where do I do it (in which file(s))?

I assume that the code is all in english, and the software only gets a string to display in different languages, so changing the portuguese translation itself shouldn't be a problem...It's just an idea.

If it isn't too much of a trouble I would apreciate if you send me some instructions to disable the maps.

Thank you very much for your important help.

Regards,

José Santos

[Jesús García Crespo]

Hi José,

On Wed, Feb 27, 2013 at 3:57 AM, José Santos <josepm...@gmail.com> wrote:

As a last attempt to solve the name change can you please ask a developer if this is possible: since I'm working in portuguese language, isn't it possible to change the text string that corresponds to the "Places" translation to portuguese? If so where do I do it (in which file(s))?

I assume that the code is all in english, and the software only gets a string to display in different languages, so changing the portuguese translation itself shouldn't be a problem...It's just an idea.

You could edit the database, tables taxonomy and taxonomy_i18n. But I wouldn't recommend that to any user without some experience in MySQL and PHP applications. Also, don't forget to do a backup before you start playing with it, you can get your database corrupted very easily!

We could add some code to make taxonomies customization possible, but unfortunately we don't have any funds for that.

 

If it isn't too much of a trouble I would apreciate if you send me some instructions to disable the maps.

You can do that easily: 

https://github.com/artefactual/atom/blob/1.x/apps/qubit/modules/term/templates/indexSuccess.php#L22 

Files 22, 23, 24. Remove these lines to get rid of the map.

--
Jesús García Crespo,
Software Engineer, Artefactual Systems Inc.
http://www.artefactual.com | +1.604.527.2056

[José Santos]

Hi Jesús,

Thank you for your quick reply. I made the changes in the database tables and they worked. I know it isn't the best solution, but know I already have a possible solution.

Now I will try to create a new taxonomy, and link it to the an access point in the ISAD description page. I will post the result of that.

Regarding the maps, your solution also worked. Thank you very much.

I have 2 other questions, but I will post them in a separate topic since they are about exporting descriptions in EAD.

Regards,

José Santos

[Jesús García Crespo]

That's great news.

Regards,

--

You received this message because you are subscribed to the Google Groups "ICA-AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To post to this group, send email to ica-ato...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msg/ica-atom-users/-/tB2lrKd_75MJ.

For more options, visit https://groups.google.com/groups/opt_out.
 
 

[José Santos]

Hi Jesús,

Sorry to bother you again, but I wasn't able to create a new taxonomy following the instructions that Jessica linked me with.
One of the reasons was that they were for qubit and the folder structure I have on Atom is different.

Nevertheless I tried to adapt and modified icaatom-1.3.0\lib\model\QubitTaxonomy.php and icaatom-1.3.0\data\fixtures\TaxonomyTerms.yml according to the instructions. The last part of the instructions, regarding the update of the sotware, I didn't understood what I was supose to do.

As a result of these modifications, the software "crashed" the taxonomies. I wasn't able to access them at all.

Can you help me?

Thanks. Regards,
José Santos

[Jesús García Crespo]

Hi José,

The documentation is a bit too old. You may want to check out the latest commits and see how we are doing schema modifications.

Regards,

To view this discussion on the web visit https://groups.google.com/d/msg/ica-atom-users/-/enWB7oM9Jg0J.

For more options, visit https://groups.google.com/groups/opt_out.
 
 

[José Santos]

Where can I see those commits Jesús?

Thank you. Regards,

José Santos

[Jesús García Crespo]

Hi there,

On Wed, Mar 6, 2013 at 11:38 AM, José Santos <josepm...@gmail.com> wrote:

Where can I see those commits Jesús?

It's in github.com/artefactual/atom.

If you show me your code I can take a look, ok? Do you have your code hosted somewhere?

Regards,