SUNScholar/Metadata/Batch Edit/SAFBuilder - Revision history

Ivdl: /* Using this guide */

2018-05-16T09:32:54Z

Using this guide

Ivdl: /* SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018) */

2018-05-16T09:32:44Z

SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018)

Ivdl: /* Using this guide */

2018-05-16T09:32:35Z

Using this guide

Ivdl: /* SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018) */

2018-05-16T09:32:25Z

SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018)

Ivdl: /* Install the JDK */

2018-05-16T09:27:23Z

Install the JDK

Ivdl: /* SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018) */

2018-05-16T09:18:30Z

SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018)

Ivdl: /* Install the JDK */

2018-05-16T09:16:15Z

Install the JDK

Ivdl: /* Run SAFBuilder */

2018-05-16T09:15:56Z

Run SAFBuilder

Ivdl: /* Run SAFBuilder */

2018-05-16T09:14:47Z

Run SAFBuilder

Ivdl: /* Install SAFBuilder */

2018-05-16T09:08:14Z

Install SAFBuilder

@@ Line 12: / Line 12: @@
 === Using this guide ===
 This guide refers to values which may change as time passes. E.g., the version number of the JDK. Since this version number is used in a number of places, it has instead been replaced by the word 'version' in angle brackets, i.e. <version>. Please replace all values referenced using angle brackets with the actual values.
 === Install the JDK ===

← Older revision		Revision as of 09:32, 16 May 2018
Line 10:		Line 10:

	The instructions given on the [https://github.com/DSpace-Labs/SAFBuilder/wiki repository page] is sufficient for use on Linux, but the Windows procedure is more involved, and not well documented. The following instructions provide the exact steps needed to get SAFBuilder running on Windows.		The instructions given on the [https://github.com/DSpace-Labs/SAFBuilder/wiki repository page] is sufficient for use on Linux, but the Windows procedure is more involved, and not well documented. The following instructions provide the exact steps needed to get SAFBuilder running on Windows.
		+
		+	=== Using this guide ===
		+
		+	{{ Quote \| Conventions for referenced values \| This guide refers to values which may change as time passes. E.g., the version number of the JDK. Since this version number is used in a number of places, it has instead been replaced by the word 'version' in angle brackets, i.e. <version>. Please replace all values referenced using angle brackets with the actual values. }}

	=== Install the JDK ===		=== Install the JDK ===

@@ Line 4: / Line 4: @@
   '''[[SUNScholar/Interoperability|Back to Interoperability]]'''
 </center>
 ==SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018)==

@@ Line 4: / Line 4: @@
   '''[[SUNScholar/Interoperability|Back to Interoperability]]'''
 </center>
 ==SAFBuilder guide to convert CSV files to SimpleArchiveFormat in order to import to DSpace (2018)==

@@ Line 14: / Line 14: @@
 {{ Quote | JDK vs JRE | Note that the Java Development Kit (JDK) is required, and includes the Java Runtime Environment (JRE). The JRE on its own is not sufficient to compile SAFBuilder. }}
-To start, download the latest JDK (not JRE) from [http://www.oracle.com/technetwork/java/javase/downloads/index.html the Oracle website]. This guide was tested using jdk-10.0.1_windows-x64_bin.exe. Install the JDK, and once the installation has completed, '''copy the C:\Program Files\Java\jdk-<version> directory to C:\jdk-version'''. Some tools do not handle spaces in paths well, which is why we move everything to C:\ to reduce the chances of running into this incompatibility.
+To start, download the latest JDK (not JRE) from [http://www.oracle.com/technetwork/java/javase/downloads/index.html the Oracle website]. This guide was tested using jdk-10.0.1_windows-x64_bin.exe. Install the JDK, and once the installation has completed, '''copy the C:\Program Files\Java\jdk-<version> directory to C:\jdk-<version>'''. Some tools do not handle spaces in paths well, which is why we move everything to C:\ to reduce the chances of running into this incompatibility.
 === Install Maven ===

@@ Line 14: / Line 14: @@
 {{ Quote | JDK vs JRE | Note that the Java Development Kit (JDK) is required, and includes the Java Runtime Environment (JRE). The JRE on its own is not sufficient to compile SAFBuilder. }}
-To start, download the latest JDK (not JRE) from [http://www.oracle.com/technetwork/java/javase/downloads/index.html the Oracle website]. This guide was tested using jdk-10.0.1_windows-x64_bin.exe. Install the JDK, and once the installation has completed, copy the C:\Program Files\Java\jdk-<version> directory to C:\jdk-version. Some tools do not handle spaces in paths well, which is why we move everything to C:\ to reduce the chances of running into this incompatibility.
+To start, download the latest JDK (not JRE) from [http://www.oracle.com/technetwork/java/javase/downloads/index.html the Oracle website]. This guide was tested using jdk-10.0.1_windows-x64_bin.exe. Install the JDK, and once the installation has completed, '''copy the C:\Program Files\Java\jdk-<version> directory to C:\jdk-version'''. Some tools do not handle spaces in paths well, which is why we move everything to C:\ to reduce the chances of running into this incompatibility.
 === Install Maven ===
-Now download Maven 3 from your local [http://apache.saix.net/maven/maven-3/ Apache mirror]. Choose the latest binary version, it will contain -bin in the filename. This guide was tested using apache-maven-3.5.3-bin.zip. Now extract the zip and move the contents to C:\maven.
+Now download Maven 3 from your local [http://apache.saix.net/maven/maven-3/ Apache mirror]. Choose the latest binary version, it will contain -bin in the filename. This guide was tested using apache-maven-3.5.3-bin.zip. Now '''extract the zip and move the contents to C:\maven'''.
 === Set the required environment variables ===
@@ Line 24: / Line 24: @@
 {{ Quote | Setting the environment variables | To learn how to set environment variables on Windows, see the following [https://www.computerhope.com/issues/ch000549.htm guide]. }}
-Once Java and Maven have successfully been installed, create the following system wide [https://msdn.microsoft.com/en-us/library/windows/desktop/ms682653(v=vs.85).aspx environment variables]:
+Once Java and Maven have successfully been installed, '''create the following system wide [https://msdn.microsoft.com/en-us/library/windows/desktop/ms682653(v=vs.85).aspx environment variables''']:
 * JAVA_HOME: C:\jdk-<version>
@@ Line 39: / Line 39: @@
 === Install SAFBuilder ===
-Download the [https://github.com/peterdietz/SAFBuilder/zipball/master source code] and extract the contents to C:\SAFBuilder
+Download the [https://github.com/peterdietz/SAFBuilder/zipball/master source code] and '''extract the contents to C:\SAFBuilder'''
 Edit the contents of safbuilder.bat to be as follows:
@@ Line 55: / Line 55: @@
 }}
-Now open a command prompt in the same directory and run:
+Now open a command prompt ''in the same directory'' and run:
   safbuilder.bat -c <filename.csv>

@@ Line 52: / Line 52: @@
 === Run SAFBuilder ===
 Now open a command prompt in the same directory and run:
@@ Line 58: / Line 61: @@
 Ensure that the csv file is in the same directory as your bitstreams. SAFBuilder will create a SimpleArchiveFormat directory, which can be zipped and uploaded to DSpace. You can also request that SAFBuilder zips the file for you, by adding the -z flag.
 ==Additional Documentation==

← Older revision		Revision as of 09:14, 16 May 2018
Line 58:		Line 58:

	Ensure that the csv file is in the same directory as your bitstreams. SAFBuilder will create a SimpleArchiveFormat directory, which can be zipped and uploaded to DSpace. You can also request that SAFBuilder zips the file for you, by adding the -z flag.		Ensure that the csv file is in the same directory as your bitstreams. SAFBuilder will create a SimpleArchiveFormat directory, which can be zipped and uploaded to DSpace. You can also request that SAFBuilder zips the file for you, by adding the -z flag.
		+
		+	{{ Quote \| How to format your csv file \| The metadata csv needs to have 'filename' (case sensitive) as the first column, followed by all the other metadata columns you wish to include. For more information, see the [https://github.com/DSpace-Labs/SAFBuilder/wiki SAFBuilder documentation].
		+	}}

	==Additional Documentation==		==Additional Documentation==

@@ Line 50: / Line 50: @@
 call mvn exec:java -Dexec.mainClass="safbuilder.BatchProcess" -Dexec.args="%1 %2"
 echo "Done. "</nowiki>
 Now open a command prompt in the same directory and run: