Differences

This shows you the differences between two versions of the page.

--- dev:client_coding:javascript_api [2020/03/30 00:34] – [Batch Editing] Add creator editing example dstillman
+++ dev:client_coding:javascript_api [2020/10/17 21:03] – [Batch Editing] dstillman
@@ Line 11: / Line 11: @@
   - In the Tools → Developer menu, select Run JavaScript. Opening the Error Console, which appears in the same menu, will also be helpful.
-  - In the window that opens, enter JavaScript in the Code textbox and click Run or press Cmd-R/Ctrl-R.
+  - In the window that opens, enter some JavaScript in the Code textbox and click Run or press Cmd-R/Ctrl-R.
 When running **asynchronous** code containing ''await'', the entered code is wrapped in an [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function|async function]], allowing you to wait for the resolution of promises returned by functions. Most Zotero functions that access the database, disk, or network are asynchronous. In this mode, the value of a ''return'' statement will be displayed in the right-hand pane upon successful completion. E.g. returning the currently selected item(s)
@@ Line 20: / Line 20: @@
 </code>
-In **synchronous** mode, the value of the final line will appear in the right-hand pane. The same result as above could be achieved in synchonous mode with
+In **synchronous** mode, the value of the final line will appear in the right-hand pane. The same result as above could be achieved in synchronous mode with
 <code javascript>
@@ Line 356: / Line 356: @@
 Before proceeding, back up your [[:zotero_data|Zotero data directory]] and temporarily disable auto-sync in the Sync pane of the Zotero preferences.
+All examples operate on the currently selected library.
 ==== Example: Item Field Changes ====
@@ Line 367: / Line 369: @@
 var fieldID = Zotero.ItemFields.getID(fieldName);
 var s = new Zotero.Search();
-s.libraryID = Zotero.Libraries.userLibraryID;
+s.libraryID = ZoteroPane.getSelectedLibraryID();
 s.addCondition(fieldName, 'is', oldValue);
 var ids = await s.search();
@@ Line 397: / Line 399: @@
 var s = new Zotero.Search();
-s.libraryID = Zotero.Libraries.userLibraryID;
+s.libraryID = ZoteroPane.getSelectedLibraryID();
 s.addCondition('creator', 'is', oldName);
 var ids = await s.search();
@@ Line 422: / Line 424: @@
 return ids.length + " item(s) updated";</code>
-==== Example: Delete Tags By Name ====
+==== Example: Convert Manual Tag to Automatic ====
-<html><p id="zotero-5-update-warning" style="color: red; font-weight: bold">This example has not been updated for Zotero 5 and should not currently be used.</p></html>
+Replace "Foo" in the first line with the tag to change:
-<code javascript>var tags = ["foo", "bar", "baz"];
+<code javascript>var tag = "Foo";
-var ids = [];
+var s = new Zotero.Search();
-var allTags = Zotero.Tags.search();
+s.libraryID = ZoteroPane.getSelectedLibraryID();
-tags = tags.map(tag => tag.toLowerCase());
+s.addCondition('tag', 'is', tag);
-for (var id in allTags) {
+var ids = await s.search();
-    if (tags.indexOf(allTags[id].name.toLowerCase()) != -1) {
+if (!ids.length) {
-      ids.push(id);
+    return "No items found";
-    }
 }
-Zotero.Tags.erase(ids);
+for (let id of ids) {
-</code>
+    let item = Zotero.Items.get(id);
+    item.addTag(tag, 1);
+    await item.saveTx();
+}
+return ids.length + " tag(s) updated";</code>
 ==== Example: Delete Tags By Part of Name ====