誕生の瞬間:標本と記録
Born Twice: Specimen and Record at the Moment of Collection (tjid3.org)
要約
この記事は、生物標本の採集時にその場で記録を作成する「インディペンデントファイル(IF)」という新しいシステムを提案しています。IFは単一のHTMLドキュメントで、UUIDとQRコードを用いて標本、写真、採集者、場所、日付を紐付け、Darwin Core標準に準拠したデータを採集と同時に記録します。これにより、標本がコレクションに収まるまでの数ヶ月から数年かかるデータ統合プロセスを不要にし、データの信頼性と永続性を高めることを目指しています。
全文翻訳
二度生まれる:採集の瞬間における標本と記録
行番号は配布されている ironfist911.html (11,943行) を参照します。関数名はソースコードに表示されるとおりです。先頭のアンダースコアは、マークアップから呼び出されることを意図していないヘルパー関数を示します。セクション番号(1.1、5.11など)はファイル固有のもので、1182行にあるモジュールマップにリストされており、番号でソースを検索するとそのセクションにジャンプします。
B.1 アーキテクチャ
ファイルレイアウト。 外部リクエストなしの単一のHTMLドキュメントです。1行目から23行目はドキュメントメタデータ(Dublin Core、引用、正規DOI)です。27行目から634行目はCSSで、ライトテーマとダークテーマがCSSカスタムプロパティとして定義されています。636行目から1132行目はマークアップで、3つのペイン(フィールドフォーム、保存済みレコードリスト、オフィスツール)とコンパイラドロワーが含まれます。1133行目から1173行目はQRジェネレーターが独自のプレーンスクリプトとして配置されています。1174行目から10706行目はメインプログラムで、パート1から8です。10707行目から10936行目はダイアログです。10937行目から11689行目はコンパイラドロワー(パート9)で、独自のクロージャ内にある2番目のスクリプトです。11691行目から11938行目はペインシェル(パート10)で、3番目のスクリプトです。
ランタイムレイヤー。 4つの要素が状態を保持し、それ以外はそれらを読み取ります。
FIELD_DEFS (1312行) はスキーマです。各エントリは内部キーをCSV/Darwin Coreの列名と人間が読めるラベルにマッピングし、オプションでブール値または数値の型を持ちます。すべてのエクスポーター、インポータ、フォームリーダー、およびHTMLテーブルはこの単一の配列をイテレートします。_coerceFieldValue() (1461行) は、フラットな形式から入力される際に型付き値が変換される唯一の場所です。
Store (1599行) は永続化カーネルです。単一のlocalStorageキー (fieldVoucherRecords_v1, 1573行) に、型付きリスト(voucher、addendum、uiState、list、bundle)のオブジェクトが保持されます。操作は all, get, put (IDによる更新), remove, replaceAll, mutate, filter, lastWriteOk, invalidateCache です。すべての書き込みは最初にディスクを再読み込みするため、1つのワークスペースで2つのタブが開いていても互いに上書きされることはありません。mutate (1715行) は読み取り-変更-書き込みの形式です。書き込みが拒否されるとフラグが設定され、ストレージ障害レポーターにルーティングされます。IDによる更新は、マージモデルの基盤となるプロパティです。異なるUUIDを生成する2つのデバイスは、衝突なしにエクスポートを結合でき、同じファイルを再インポートしても冪等です。
Bus (1797行) は on と emit を持つ最小限のパブリッシュ/サブスクライブシステムです。リスト、ギャラリー、問題ノート、ワークスペースバーは vouchers:changed で再描画されます。addenda:changed と draft:restore も同様に機能します。リスナーはラップされているため、1つのリスナーが失敗しても他のリスナーを停止させることはありません。
Draft (5074行) はフォームをミラーリングするプレーンなオブジェクトです。委譲された入力および変更リスナーがユーザーの入力に応じて更新します。バルクライター(リセット、リストア、複製、GPS、EXIF)は、値の設定直後に _draftSyncFromDOM() (5076行) を呼び出します。これは、プログラムによる .value の代入では入力イベントが発火しないためです。voucherFromForm() (5384行)、セーブゲート、オートセーブはDOMではなくDraftを読み取ります。
ワークスペース。 単一のURLパラメータ ?ws=name (1296行) により、ファイルは個別のデータセットに分割されます。すべてのストレージキーは _wsKey() を通じてワークスペース名でサフィックス化されます。デフォルトのワークスペースはキーをそのまま保持するため、以前のビルドからのデータは常にあった場所にあります。既知のワークスペースのリストとインストールのデバイスタグは意図的に共有されています。
識別子。 3つのUUIDと3つの有効期間があり、すべて uid() (1873行、crypto.randomUUID によるRFC 4122 v4、フォールバックは getRandomValues、その後 Math.random) によって生成されます。occurrenceID は標本ごとに1つで不変であり、ドラフト開始時に voucherOccurrenceUUID() (2777行) によって生成され、アディンダの外部キーおよびマージの重複排除キーとなります。Voucher ID (id) はラベルとQR番号であり、ドラフトごとに生成されますが、事前に印刷されたシートで置き換えられる可能性があり、写真もIDが変更されると再キーイングされます。sessionId() (2016行) はブラウザのインストールごとに1つで、レガシー名 deviceTag の下に保存され、すべてのバウチャーとアディンダに保存時にスタンプされます。compileBatchId はコンパイラクリアごとに1つで、コンパイルされたエクスポートにのみスタンプされます。
ストレージキー。 レコード: fieldVoucherRecords_v1 (1573行)。ドラフトオートセーブ: fieldVoucherDraftAutosave_v1 (5115行)。URL形式のIDの移行前バックアップ: fieldVoucherreport_redirect_backup_v1 (2896行)。写真: IndexedDBデータベース fieldVoucherPhotos_v1、ストア photos (3299~3300行)。写真IDをキーとするBlobsとvoucherIdインデックスを保持します。これら4つすべてにワークスペースサフィックスが付きます。ワークスペース間で共有: fieldVoucherWorkspaces_v1 (1303行) と fieldVoucherDeviceTag_v1 (2006行)。レガシーキーは移行時に一度読み取られ、その後無視されます: fieldVoucherreport_v1 (1304行)、fieldVoucherCollectors_v1 (4159行)、fieldVoucherDwcExtraFields_v1 (4318行)。レコードスキーマバージョン定数: RECORD_SCHEMA_VERSION = "v2" (1579行)。
アディンダモデル。 修正は独自のStoreタイプ (addendum) であり、それぞれ独自のUUID、parentOccurrenceID、parentVoucherId、georeference または redetermination のタイプ、ペイロード、作成者、デバイスタグ、タイムスタンプを持ちます。バウチャー行は書き換えられません。computeCurrentStateFields() (2159行) は、現在の名前、決定者、座標を、配列順ではなく優越順(_geoHeads(), 2259行)で、現在の優越決定および優越地理参照を導き出します。装飾はエクスポート時およびレンダリング時に行われ、書き込み時には行われません。DERIVED_STATE_KEYS (2219行) は同じ関数から計算されるため、両者が乖離することはありません。
唯一のエントリポイント。 canonicalRecord() (2522行) は、すべての保存済みおよびインポートされたレコードの単一のエントリです。FIELD_DEFSキーに加えて4つの名前付き追加フィールドがあるため、認識されない列はストアに乗り込むことができません。addRecords() (2631行) は、JSON、CSV、およびテイクホームバンドル用の単一のインポートパスです。コンパイラドロワーも同じ canonicalRecord() を使用します。
エクスポートとインポートの対称性。 JSONはアディンダ配列をネストします。CSV、XLSX、HTMLは同じ配列を addenda_json 列にシリアライズします。parseAddendaField() (2137行) はどちらの形状も受け入れるため、フラットな往復はチェーンセーフです。
出力方法。 ファイル: CSV、JSON、XLSX、写真ZIP、HTMLテーブル、メール、ラベル、QRシート、QRタグ(パート5)。テイクホーム(セクション5.5b、7131行)は、ビューアページ、JSONおよびCSVエクスポート、写真、各ファイルのSHA-256を含むマニフェスト、およびREADMEを含むZIPを1つ作成します。GitHubルートはGitHubのブラウザ制限(7171行)の下でパートをカットします。インポートバンドル(セクション5.5c、7713行)はバンドルを戻し、各写真をマニフェストハッシュと比較してから再アタッチします。Symbiota、Specify、DiSSCo用のコレクションエクスポートは、単一のリーダー _csPrepare() (8820行) を共有します。
初期化シーケンス(10625~10705行)。 トレーサーのインストール、レガシーキーからのカーネル移行、テーマ、日付、王国、初期スナップショット、フォームリスナー、Voucher IDとoccurrenceID、Darwin Coreフィールド、コレクター、オートフィルガード、セクション状態、オートセーブチェック、トリップストリップ、タイマーアームリスナー(クリック、入力、変更、キャプチャフェーズ)、レガシーURL-ID移行とその後の vouchers:changed、ストアの調整とスナップショットオファー、ストレージ耐性チェック、要求された場合のセルフテスト、セッションバッジ、トップスタンプ、ワークスペースバー、2タブプレゼンス、および関連バウチャー読み出し。
サードパーティコード。 1項目:Kazuhiko Arase氏のQR Code Generator for JavaScript、MITライセンス、1133~1173行にバンドルされています。これは独自のスクリプトとして実行され、window.QR を設定します。_ensureQR() (2747行) はそれが存在することを確認するだけです。ZIPリーダー/ライター、XLSXライター、EXIFリーダー/ライター、JPEG再エンコーダー、ブラウザの crypto.subtle を介したSHA-256など、その他すべてはファイル内にあります。
B.2 関数リファレンス
ファイル内の全488関数をソース順に、ファイル固有のセクションごとにグループ化しています。各説明はソースコード内の関数直上の1行コメントです。
1.1 ワークスペース(1278~1306行)
_wsSanitize(v), 1295行。ワークスペース名を小文字の英字、数字、ハイフンに折りたたむ。最大24文字。
_wsKey(k), 1300行。このワークスペースのストレージキー。デフォルトワークスペースはキーをそのまま保持します。
_wsFileName(n), 1302行。このワークスペースのダウンロードファイル名:pests_field_vouchers_2026-09-19.csv。
1.2 フィールド定義(1307~1526行)
_coerceFieldValue(def, value), 1461行。生のセル値を、そのFIELD_DEFSエントリが宣言する型(ブール値、数値、テキスト)に変換します。
_boolTrue(v), 1481行。true、「true」、1、または「1」の場合はtrue。それ以外はfalse。
_mergeAddendumCopies(kept, incoming), 1493行。同じアディンダの2つのコピー(同じID)で isCurrentIdentification が異なる場合。
1.3 カーネル:ストアとバス(1527~1756行)
_load(fresh), 1621行。キャッシュが変更されていない場合はそれを使用し、localStorageからレコードストア全体を読み込みます。
_save(), 1648行。キャッシュをlocalStorageに書き込み、飲み込むのではなく拒否された書き込みを報告します。
all(type), 1664行。1つのタイプのすべてのレコード(変更可能なコピー)。
get(type, id), 1666行。タイプとIDによる1つのレコード、またはnull。
put(type, id, data), 1671行。1つのレコードを追加または置換し、保存します。
remove(type, id), 1683行。タイプとIDで1つのレコードを削除し、保存します。
replaceAll(type, records), 1704行。単一の書き込みで1つのタイプのすべてのレコードを置き換えます。801行:これはディスクを再読み込みしてから、その再読み込みを破棄します。
mutate(type, fn), 1715行。ディスク上の現在の状態に対して読み取り、変更、書き込みを行います。fnは現在のリスト(変更可能なコピー)を受け取り、保存するリストを返します。何も返さない場合は、渡されたコピーを保持します。
filter(pred, type), 1726行。1つのタイプまたはすべてのタイプで、テストをパスしたすべてのレコード。
lastWriteOk(), 1737行。最後のlocalStorage書き込みは成功しましたか?
invalidateCache(), 1743行。解析されたコピーを破棄するため、次の読み取りはディスクに戻ります。
1.4 ストレージ障害報告(1757~1811行)
storageWriteFailed(), 1768行。localStorageが書き込みを拒否している間、true。
reportStorageWriteFailure(err, what), 1770行。書き込み失敗を記録し、ユーザーに一度警告します。
noteStorageWriteRecovered(), 1789行。書き込みが再び成功すると、ストレージ警告をクリアします。
on(evt, fn), 1800行。関数を名前付きイベントにサブスクライブします。
emit(evt), 1802行。イベントにサブスクライブされているすべての関数を呼び出します。1つのリスナーの失敗が他のリスナーを停止させることはありません。
1.5 ユーティリティ(1812~1889行)
esc(s), 1816行。HTML内で安全に使用するためにテキストをエスケープします。
_forceLowercase(el), 1822行。種小名は植物命名法で大文字にされることはありませんが、autocapitalize="off" だけではすべてのモバイルキーボードで尊重されないため、属性を信頼するのではなく、入力中に値自体を小文字に強制します。
todayISO(), 1841行。ローカルカレンダー部分から今日のUTCではない日付を取得します。これにより、夕方の記録が翌日の日付になるのを防ぎます。
fullName(first, last), 1849行。姓と名を結合して1つの表示名にします。
_isoDateInputFilter(el), 1857行。ユーザーが数字を入力する際に、入力された日付をYYYY-MM-DD形式に保ちます。
uid(), 1873行。古いブラウザ用のフォールバックを備えた、ランダムなv4 UUID。
1.6 レガシーからストアへの移行(1890~1948行)
_kernelMigrateLegacyIfNeeded(), 1897行。古い機能ごとのストレージキーをStoreに一度だけ移動します。
2.1 アディンダ(1949~2320行)
_sharedDeviceTag(), 2008行。インストール全体のタグのコピー、または空文字列(存在しない場合や読み取れない場合)。
_rememberSharedDeviceTag(tag), 2012行。インストール全体のタグのコピーを書き込みます。空の場合のみ。
sessionId(), 2016行。インストールごとのセッションタグ。読み取り、共有コピーを借りる、または初回呼び出し時に生成します。
createAddendum(parentOccurrenceID, parentVoucherId, addendumType, payload, authorFirst, authorLast), 2038行。保存されたバウチャーに対して新しいアディンダ(再決定、地理参照、注記)を記録します。
getAddendaFor(occurrenceID), 2081行。1つのoccurrenceIDに対するすべてのアディンダ。古い順。
deleteAddendaForOccurrences(occurrenceIDs), 2094行。削除されるバウチャーのアディンダを削除します。これにより、存在しないoccurrenceIDを指すものが残らなくなります。カウントを返します。
deleteAllAddenda(), 2103行。このワークスペースのすべてのアディンダを削除します。削除された数を返します。
countAddendaForOccurrences(occurrenceIDs), 2110行。これらのoccurrenceIDのいずれかを指すアディンダの数をカウントします。
deleteAddendum(id), 2116行。確認後に1つのアディンダを削除します。バウチャー自体は変更されません。
_normalizeAddendum(a), 2130行。受信したレコードからアディンダチェーンをプルします。JSONは実際の配列を .addenda の下にネストし、フラット形式は addenda_json 列にシリアライズされた同じ配列を保持します。
parseAddendaField(src), 2137行。インポートされたレコードからアディンダチェーンを読み取ります。ネストされたJSONまたは addenda_json セルのいずれか。
computeCurrentStateFields(rec, addenda), 2159行。バウチャーとそのアディンダから現在の名前、決定者、座標を計算します。
decorateWithCurrentState(rec), 2223行。保存されたバウチャーに、ライブのアディンダと現在の状態フィールドを追加します。
decorateAllWithCurrentState(recs), 2228行。リスト全体に decorateWithCurrentState() を適用します。
decorateWithNestedAddenda(rec), 2234行。レコードに既に存在するアディンダからの現在の状態フィールド(ストア検索なし)。
decorateAllWithNestedAddenda(recs), 2239行。リスト全体に decorateWithNestedAddenda() を適用します。
_geoHeads(addenda), 2259行。1つの標本に対する現在の地理参照。何も上書きされていないもの。1つが現在のものですが、複数ある場合は競合です。
_geoLineage(head, addenda), 2278行。現在の地理参照と、それが作成されたすべての基盤となるもの。最も新しいものから順に、_geoHeads() と同じ優越ルールを使用します。
findAddendumProblems(vouchers, addenda), 2295行。孤立したアディンダと、ゼロまたは複数の現在の決定を持つ標本を見つけます。
findLocalAddendumProblems(), 2317行。このワークスペース自身の保存済みデータに対して findAddendumProblems() を実行します。
2.2 保存済みリストとインポートチェック(2321~2486行)
load(), 2325行。このワークスペースのすべての保存済みバウチャー。
persist(arr), 2327行。保存済みバウチャーリストを置き換えます。
persistUpdate(fn), 2332行。persist() の読み取り-変更-書き込み形式。現在のセットを編集する(追加、削除、複数削除)ものにはこれを使用してください。persist() は、真の全体置換のために残されています。fnは画面が最後に描画された時点ではなく、その瞬間のディスク上のリストを受け取ります。
_uniqueList(arr), 2334行。重複しない非空の値、ソート済み。
_shortIdList(arr, max), 2336行。メッセージ用のIDの短いカンマ区切りリスト。長い場合は「+N件」と表示されます。
_existingVoucherIdSet(records), 2341行。レコードリストに既に存在するVoucher IDのセット。
_voucherIdInUse(id, records), 2347行。このVoucher IDは既に使われていますか?
_freshUniqueId(used), 2349行。指定されたセットに含まれない新しいUUID。セットに追加します。
_findIncomingIdClashes(items, existingRecords), 2356行。保存済みのものと衝突する、またはインポート内で繰り返されるVoucher IDのリスト。
_blockDuplicateImportIfNeeded(items, existingRecords), 2369行。Voucher IDが衝突する可能性がある場合、メッセージを表示してインポートを停止します。
ingestAddendaFor(item, rec), 2400行。アディンダ修正のインポート側、および実際のバグ:エクスポートはチェーンをネストしていましたが、インポートは各レコードをFIELD_DEFSに通してネストされた配列を捨てていました。
_malformedAddendaCell(src), 2424行。addenda_json セルが存在するが、読み取り可能なリストではない場合、true。
_addendaIntegrityIssues(src), 2436行。ファイルに到着したアディンダは一度もチェックされなかったため、緯度999の地理参照がクリーンにインポートされて現在のものになりました。ここでは、各アディンダのフォーマット問題(無効な座標、無効な日付)をチェックします。
_recordIntegrityIssues(src), 2448行。1つのレコードのフォーマット問題(無効な座標、無効な日付)をインポートフラグ用にチェックします。
_joinImportIssues(existing, added), 2480行。2つのインポート問題リストを重複なしで「; 」文字列にマージします。
2.3 カノニカルレコード(2487~2742行)
canonicalRecord(raw, opts), 2522行。FIELD_DEFSを通じてフィールドごとに、任意の入力からクリーンなレコードを1つ構築します。
_fingerprintSource(rec), 2591行。すべてのフィンガープリントが取得される正確な文字列。
_recordFingerprint(rec), 2602行。1つのレコードのコンテンツフィンガープリント。インポート時の完全な重複を検出するために使用されます。
_recordFingerprintLegacy(rec), 2615行。801より前の低バイトハッシュ。古いスタンプがまだ検証できるように保持されています。
_fingerprintMatches(rec, stamp), 2625行。保存されたフィンガープリントが古い形式または新しい形式で一致するかどうかをチェックします。
addRecords(items), 2631行。インポートされたレコードを保存済みリストに追加します。マージ、重複排除、アディンダの取り込みを行います。
2.4 バウチャーIDとQRエンジン(2743~3135行)
_ensureQR(cb), 2747行。QRライブラリはページロード時に独自のプレーンスクリプトとして実行され、window.QR を設定します。これは存在を確認してからコールバックを実行します。
voucherId(), 2756行。ドラフトの現在のVoucher ID(QR値)。
generateVoucherQR(optId), 2758行。ドラフトのVoucher IDを設定し、QRコードを描画します。
voucherOccurrenceUUID(), 2777行。ドラフトのoccurrenceID。初回使用時に生成されます。
_draftIdentityKey(), 2784行。画面上のドラフトはどれか。occurrenceIDは新しいドラフトごとに新しく生成され、復元されたドラフトとともに復元されます。再ラベル付け(新しいVoucher ID)はそのままにしておくため、標本が変更されたときにのみ変更されます。
newDraftOccurrenceUUID(), 2786行。新しいドラフトのために新しいoccurrenceIDを開始し、それを表示します。
queuePhotoIdMigration(oldId, newId), 2808行。ドラフトの写真を新しいVoucher IDに移動します。一度に1つずつ。
refreshVoucherQR(), 2824行。ドラフトの新しいVoucher IDを生成し、QRコードを再描画します。
downloadVoucherQR(), 2833行。ドラフトのQRコードをPNGとして保存します。
makeCardQR(id, px), 2845行。カードや印刷用のPNGデータURLとしてのQRコード。
_voucherQrMode(mode), 2854行。QRパネルを生成されたIDと印刷済みシートIDの間で切り替えます。
_cleanVoucherId(id), 2868行。Voucher IDから制御文字とスペースを削除します。
_voucherIdIsUrl(id), 2891行。Voucher IDが解決可能なWebアドレスまたはその他のリンクである場合(許可されていません)。
async migrateLegacyRedirectVoucherIds(), 2898行。一度限りの修復:古いビルドからのURL形式のVoucher IDをUUIDに置き換えます。バックアップを保持します。
_assignPreprintId(id), 2966行。スキャンまたは入力された印刷済みIDをドラフトのVoucher IDとして受け取ります。
async startVoucherScan(), 2997行。カメラを開き、QRコードの検索を開始します。
_doScanFrame(), 3019行。1つのビデオフレームでQRコードをチェックし、次のフレームをスケジュールします。
_stopScanStream(), 3036行。カメラとフレームループを停止します。
_qrModalSetTarget(t), 3054行。スキャンダイアログのテキストをそのジョブ(印刷済みシートまたは関連バウチャー)に合わせて設定します。
openQRModal(mode, target), 3063行。スキャン/ID入力ダイアログを開きます。
closeQRModal(), 3074行。スキャン/ID入力ダイアログを閉じ、カメラを停止します。
_qrModalKeydown(e), 3090行。Escapeキーでスキャンダイアログを閉じます。
_qrModalBackdropClick(e), 3092行。ボックスの外側をクリックするとスキャンダイアログが閉じます。
qrModalTab(mode), 3094行。スキャンダイアログをスキャンタブと入力タブの間で切り替えます。
voucherManualIdPreview(), 3114行。入力中に、入力されたIDをQRコードとしてプレビューします。
voucherAssignManualId(), 3121行。入力されたIDをドラフトまたは関連バウチャーリンクとして受け入れます。
3.1 座標(3136~3260行)
_setNoFixFromGPS(reason, displayReason), 3140行。座標を消去せずに、GPSの失敗を記録します。
useCurrentLocation(), 3180行。GPSボタン:場所のプロンプトがここで表示され、それ以外は何もプロンプトされません。
markManualCoordEntry(), 3246行。座標を手入力としてマークし、ソースを記録します。
_coordNoFixClean(), 3256行。GPSが失敗し、座標ボックスがまだ空の場合、true。
3.2 写真ストア(3261~3924行)
_openPhotoDB(), 3305行。写真データベースを開きます(または作成します)。
_photoId(), 3335行。保存された写真の一意のID。
async resizeImageFile(file, maxDim, quality, stampId), 3349行。写真をJPEGに縮小・再エンコードし、Voucher IDをスタンプします。
_stampPhotoId(ctx, w, h, id, coverId), 3400行。Voucher IDを写真のピクセルに焼き付けます。長いIDが小さな写真に収まるようにサイズ調整されます。
async _restampPhotoBlob(blob, oldId, newId), 3431行。バウチャーIDが変更された後、写真のスタンプIDを再描画します。
sanitizeFilename(s), 3461行。テキストをファイル名として安全に使用できるようにします。
_asciiBytes(s), 3475行。テキストをnull終端ASCIIバイトとして、EXIFフィールド用。
_buildVoucherExifSegment(id), 3483行。Voucher IDを運ぶEXIFブロックを構築します。
entry(tag, type, count, value), 3507行。1つのEXIFディレクトリエントリを書き込みます。
_isExifApp1(bytes, off), 3533行。これらのバイトがEXIF APP1セグメントを開始する場合、true。
_stripExifApp1(bytes), 3538行。JPEGから既存のEXIFセグメントを削除します。
async _jpegWithVoucherExif(blob, id), 3558行。Voucher ID EXIFブロックをJPEGに挿入します。
async _jpegHasVoucherExif(blob, id), 3569行。このJPEGは既にこのVoucher IDをEXIFに持っていますか?
_photoExt(p), 3600行。実際に保存されているものと一致するファイル拡張子。
photoFilename(idVal, index, p), 3611行。エクスポート中の写真の <voucherId>_<番号>.<拡張子>。
stablePhotoNames(voucherIdVal, photos, rec), 3625行。バウチャーの写真のVoucher IDからファイル名へのマッピング。写真は最初に出力された名前を保持します。新しい写真は、未使用の最小番号を取ります。
async addPhotosToVoucher(voucherIdVal, files), 3647行。写真を1つのVoucher IDの下にデータベースに保存します。
async getPhotosForVoucher(voucherIdVal), 3687行。1つのVoucher IDに対するすべての保存済み写真。
async photoVoucherIdCounts(), 3745行。少なくとも1つの写真レコードを持つすべてのvoucherIdと、そのカウント。
async deletePhoto(photoId), 3766行。1つの保存済み写真を削除します。
async deletePhotosForVoucher(voucherIdVal), 3775行。1つのVoucher IDのすべての写真を削除します。
async clearAllPhotos(), 3787行。このワークスペースのすべての保存済み写真を削除します。
async migratePhotosVoucherId(oldId, newId), 3799行。写真を古いVoucher IDから新しいものに移動し、それぞれを再スタンプします。
async renderPhotoGallery(), 3829行。写真フィールドの下のサムネイルストリップを描画します。
async deletePhotoUI(photoId), 3853行。確認後に1つの写真を削除します。
onPhotoSkipToggle(), 3859行。「写真なし」の理由ボックスを表示または非表示にします。
openPhotoInput(which), 3888行。実際のユーザーのプレスからカメラまたはピッカーを開きます。
async handlePhotoInput(inputEl), 3897行。フォームで選択された写真を処理します:保存、スタンプ、GPSチェック。
3.3 EXIF GPS(3925~4078行)
async extractExifGPS(file), 3944行。JPEGのEXIFからGPS座標を読み取ります。nullの場合もあります。
_parseExifGPS(view, tiffBase), 3967行。EXIFディレクトリをGPSタグまで歩き、10進数の緯度/経度を返します。
_haversineMeters(lat1, lon1, lat2, lon2), 4027行。2つの緯度/経度ポイント間の距離(メートル)。
async reconcileExifGPS(files, draftKey), 4034行。写真のGPSとフォームの座標を比較します。必要に応じて埋めるかフラグを立てます。
3.4 バウチャータイマー(4079~4146行)
beginVoucherTimer(), 4113行。ドラフトのタイマーを開始します。
disarmVoucherTimer(), 4117行。ドラフトのタイマーをクリアします。
_isDraftSurface(el), 4126行。要素がドラフト(フォームまたはQRブロック)の一部である場合、true。
_armVoucherTimerOnFirstAction(ev), 4131行。最初の実際の編集時にタイマーを開始します。
3.5 コレクター(4147~4305行)
_collectorsLoad(), 4165行。保存されたコレクターリスト。
_collectorsPersist(), 4170行。コレクターリストを保存します。
_collectorsSyncFromDOM(), 4175行。フォームから入力されたコレクター名をメモリにコピーします。
_collectorsSyncAndSave(), 4183行。コレクターの変更を読み取り、保存し、トリップストリップと「同定者」に渡します。
_syncDetFromCollector(), 4196行。プライマリコレクターの名前を「同定者」(det)フィールドにミラーリングします。コレクターは発見時のデフォルトの同定者です。
renderCollectorRows(), 4209行。コレクター行を描画します。
addCollectorRow(), 4241行。空のコレクター行を追加します。
removeCollectorRow(id), 4250行。コレクター行を削除します(Undo付き)。
moveCollectorRow(id, dir), 4268行。コレクターを行リストで上下に移動します。
getCollectorNamesList(), 4281行。すべてのコレクターのフルネーム。プライマリが先頭。
getPrimaryCollectorFirst(), 4286行。プライマリコレクターの名。
getPrimaryCollectorLast(), 4288行。プライマリコレクターの姓。
getAdditionalCollectorsFromForm(), 4290行。追加のコレクターを「 | 」で結合します。
_restoreExtraCollectorValues(), 4294行。コレクター行をメモリから再描画します。
initCollectors(), 4298行。起動時に保存されたコレクターを読み込み、行を描画します。
3.6 追加のDarwin Coreフィールド(4306~4572行)
_dwcLoadSchema(), 4321行。追加されたDarwin Coreタームの保存済みリスト。
_dwcSaveSchema(), 4326行。追加されたDarwin Coreタームのリストを保存します。
_dwcSafeId(term), 4330行。要素IDで使用するために安全化されたDarwin Coreターム。
_dwcCategoryFor(term), 4332行。Darwin Coreタームが属するピッカーリストのカテゴリ。
_dwcAllTermsFlat(), 4337行。ピッカーリストのすべてのDarwin Coreタームとそのカテゴリ。
filterDwcTerms(), 4344行。ユーザーが入力するにつれてDarwin Coreピッカーリストをフィルタリングします。
hideDwcTermDropdown(), 4365行。Darwin Coreピッカーリストを非表示にします。
selectDwcTerm(term), 4367行。選択されたDarwin Coreタームをフォームに追加します。
_dwcAddRow(term, value), 4379行。追加されたDarwin Core行を、オプションの値とともに描画します。
removeDwcExtraField(term), 4395行。追加されたDarwin Core行を削除します(Undo付き)。
getDwcExtraObjectFromForm(), 4412行。フォームからの追加Darwin Core値 {term: value}。
packDwc(obj), 4422行。{term: value} を "term: value | term: value" としてパックします。
getDwcExtraFieldsFromForm(), 4426行。フォームからの追加Darwin Core値。パックされています。
_parsePackedDwc(str), 4453行。パックされた extraDwcFields 文字列をターム/値オブジェクトとして解析します。
dwcShapeConflicts(rec), 4462行。レコードのdwcオブジェクトとそのパックされた文字列が一致しないターム。
parseExtraDwc(rec), 4473行。レコードの追加Darwin Coreターム。どちらかの形状または両方から。
dwcColumnsFor(recs, opts), 4499行。エクスポート用の追加Darwin Core列。安定した順序:このワークスペースの設定済みタームが先、次にレコードが持つ他のターム。
exportFieldDefs(recs, opts), 4520行。エクスポート列リスト:FIELD_DEFSに、追加されたDarwin Core列が配置されています。
flattenDwc(rec), 4528行。追加Darwin Core値が独自の列に展開された単一レコード。
flattenAllDwc(recs), 4535行。リスト全体に flattenDwc() を適用します。
dwcTermForHeader(h), 4541行。インポート列ヘッダーをDarwin Coreタームに一致させます。大文字小文字を区別しません。
dwcFromColumns(headers, cells, taken), 4549行。他のものが主張しなかったインポート列からDarwin Core値を収集します。
attachDwc(rec, src, fromCols), 4561行。レコードにDarwin Core値をアタッチします。オブジェクトとしてもパックされた形式でも。
initDwcExtraFields(), 4568行。起動時に追加Darwin Core行を復元します。
3.7 関連バウチャー(4573~4773行)
_dwcEnsureTerm(term), 4600行。Darwin Core行がフォームにない場合に追加し、その入力を返します。
_assocParts(v), 4605行。「 | 」リストをパートに分割します。
_assocSet(el, parts), 4607行。DwC行の値を、入力があったかのように書き込みます。これにより、Draftとオートセーブがそれを認識します。
invalidateWorkspaceIndex(), 4636行。ワークスペース間インデックスを破棄するため、次のルックアップで再構築されます。
_workspaceIndex(), 4638行。他のすべてのワークスペースのバウチャーの解析済みインデックス。一度構築され、再利用されます。
unreadableWorkspaces(), 4667行。現在レコードストアを読み取れなかったワークスペース。
findVoucherAnywhere(idOrOcc), 4669行。任意のワークスペースでVoucher IDまたはoccurrenceIDでバウチャーを見つけます。
_assocRel(), 4677行。関係性を整理します。括弧やバーは削除します。これらはDwC文字列を壊す可能性があります。
linkAssociatedVoucher(raw), 4683行。リンク自体:スキャンされたIDを検索し、DwC行を書き込み、表示します。
unlinkAssociatedVoucher(i), 4709行。1つのリンクとその関連Taxaエントリ(存在する場合)を削除します。
renderAssocReadout(), 4727行。リンクごとの1行:関係性、名前、および場所。
toggleOtherTaxa(force), 4756行。追加Darwin Coreフィールドの下にある「その他のTaxa」バー。関連バウチャーブロックを開閉します。
initAssociatedVoucher(), 4765行。起動時に関連バウチャーコントロールを復元します。
3.8 サジェスト(4774~4936行)
renderOptionDropdown(box, items, rowHtml), 4784行。サジェストボックスを行で埋めるか、空の場合は非表示にします。
hideDropdown(boxId), 4791行。サジェストボックスを非表示にします。
_recentValuesFor(key, max), 4804行。保存されたバウチャー全体での1つのフィールドの最近のユニークな値。
showRecentSuggestions(fieldId, boxId, key), 4813行。フィールドの下に最近の値を示します。
hideRecentSuggestions(boxId), 4826行。最近の値を非表示にします。
_recentPick(fieldId, idx), 4828行。選択された最近の値を選択されたフィールドに入力します。
_familyCandidates(), 4862行。提案するファミリー名:このワークスペース自身のものが先、次にシードリスト。
showFamilySuggestions(), 4875行。ユーザーが入力するにつれてファミリーの提案を表示します。
_familyPick(i), 4889行。選択されたファミリーをフィールドに入力します。
_familyKey(e), 4899行。矢印キーでリストを移動し、EnterまたはTabでハイライトされた行を選択します(ハイライトがない場合はトップ行を選択)。Escapeで閉じます。
updateRecentCollectorNames(), 4919行。保存されたバウチャーからコレクター名のサジェストを更新します。
3.9 トリップストリップ(4937~4955行)
renderTripStrip(), 4943行。トリップストリップを描画します:コレクターとこのセッションの機関。
3.10 このサイトの複製(4956~5059行)
_legacyAdminKeys(o), 4982行。古い「State/Province」と「County/Parish」のドラフトキーを現在の名前にマッピングします。
_siteFromForm(), 4992行。フォームからのサイトフィールド(場所、座標、生息地)。
_siteHasContent(site), 5004行。サイトに場所または座標がある場合、true。
rememberSite(site), 5009行。このサイトの複製のために最後のサイトを記憶します。
lastRememberedSite(), 5013行。最後に記憶されたサイト、またはnull。
_applySite(site), 5018行。サイトをフォームに書き戻します。
_draftHasSpecimenContent(), 5030行。ドラフトに標本レベルのコンテンツがある場合、true。
async duplicateForThisSite(), 5034行。最後のサイトと同じサイトで新しいドラフトを開始します。
3.11 ドラフト状態(5060~5086行)
_draftSyncFromDOM(), 5076行。すべてのフォームフィールドをDraftにコピーします。
draftVal(id), 5085行。1つのドラフト値:Draftから、そうでなければフォームから。
3.12 ドラフトオートセーブ(5087~5294行)
_draftIdentitySnapshot(), 5121行。ドラフトのID、写真の選択、追加フィールド。オートセーブ用。
_draftAutosaveNow(), 5142行。ドラフトのオートセーブを今すぐ書き込みます。
scheduleDraftAutosave(), 5161行。入力停止後すぐにドラフトをオートセーブします。
clearDraftAutosave(), 5166行。ドラフトのオートセーブを削除します。
capturePristineDraft(), 5184行。空のフォームの外観を記録します。これにより、オートセーブが実際の編集を識別できます。
_draftHasContent(data), 5189行。ドラフトが空のフォームと異なる場合、true。
formHasUnsavedContent(), 5215行。フォームに保存されていない作業が含まれている場合、true。
checkForDraftAutosave(), 5230行。起動時に保存されたドラフトを復元するかどうかを提案します。
_showDraftRestoreBanner(data, photoCount), 5249行。保存されたドラフトの復元バナーを表示します。photoCount > 0 は写真が理由であることを示します。
restoreDraftAutosave(), 5278行。所有権:Storeがレコード状態を所有します。これは一度だけ宣言されるため、次にこれを読む人は呼び出しサイトから推測する必要はありません。
discardDraftAutosave(), 5285行。保存されたドラフトを破棄し、バナーを非表示にします。
dismissDraftRestoreBanner(), 5290行。復元ドラフトバナーを非表示にします。
3.13 復元されたドラフトの適用(5295~5381行)
applyDraftSnapshot(data), 5301行。復元されたドラフトをフォームに書き戻します。
3.14 フォーム(5382~5441行)
voucherFromForm(), 5384行。フォームからバウチャーレコードを構築します。
3.15 セーブゲート(5442~5844行)
isNotRecorded(v), 5487行。値が「記録なし」プレースホルダーの場合、true。
recordedOrBlank(v), 5489行。値、または「記録なし」の場合は空。
fillNotRecorded(v), 5491行。空のオプションフィールドを「記録なし」で埋めます。どれを埋めたか返します。
clearFieldHighlights(), 5500行。フォームフィールドから赤いハイライトを削除します。
_isRealISODate(s), 5514行。ゲートは空でないことをテストして停止しました。そのため、緯度=banana、経度=x、2026-99-99はすべて通過してレコード、エクスポート、GBIFに到達しました。
_coordProblem(raw, limit, name), 5524行。座標が無効な10進数で範囲外の場合のメッセージ。それ以外は空文字列。
validateFieldFormats(), 5533行。保存前に座標と日付のフォーマットをチェックします。
validateRequiredFields(), 5559行。空の必須フィールドをリストします。
async validatePhotoRequirement(voucherIdVal), 5599行。保存時の写真ルール:写真があるか、「写真なし」がチェックされているかのどちらかであり、両方同時にではありません。
showIncompleteVoucherModal(missing), 5615行。不完全なバウチャーダイアログを表示し、問題のあるセクションを開きます。
async saveVoucher(ev), 5660行。フォームの送信ハンドラー。独自の処理を1つ行います。それは、最初の保存がまだ実行中の場合に2回目の保存を拒否することです。その後、_saveVoucherBody に処理を渡します。
async _saveVoucherBody(), 5671行。上記の saveVoucher によって一度に実行される、実際の保存処理。
rememberKingdom(v), 5784行。王国は標本ではなく、セッションに属します。
lastKingdom(), 5788行。最後に使用された王国、またはPlantae。
resetVoucherForm(), 5793行。セッションレベルの値は保持して、次のバウチャーのためにフォームをクリアします。
async clearVoucherDraft(skipConfirm), 5830行。必要に応じて確認後、ドラフトとその写真を破棄します。
3.16 オートフィルスピルガード(5845~5982行)
_suppressBrowserAutofill(root), 5860行。ブラウザ自身の住所オートフィルがフォームに誤って書き込まれるのを防ぎます。
spillGuardedIds(), 5897行。オートフィルスピルガードが監視するフィールドIDのライブリスト。
_spillSnapshot(), 5912行。オートフィルが触れる前の監視対象フィールドの値。
_installAutofillSpillGuard(), 5918行。ブラウザのオートフィルが他のフィールドにスピルするのを元に戻すガードをインストールします。
4.1 リストのレンダリング、検索、ソート、バルクセレクト(5983~6189行)
onVoucherSearchInput(), 5990行。検索ボックス入力:保存済みリストをフィルタリングします。
onVoucherSortChange(), 5996行。ソートメニュー変更:保存済みリストを再ソートします。
toggleSelectAllVouchers(checked), 6002行。現在表示されているすべてのバウチャーを選択または選択解除します。
toggleVoucherSelected(id, checked), 6009行。1つのバウチャーを選択または選択解除します。
updateBulkControls(), 6014行。バルクボタンを有効にし、選択されている数を表示します。
bulkDeleteSelected(), 6029行。選択されているすべてのバウチャーを、その写真とアディンダとともに削除します。
renderVouchers(), 6047行。リストの再描画を80ミリ秒後にスケジュールします。これにより、変更のバーストが一度だけ描画されます。
_renderVouchersNow(), 6052行。保存済みバウチャーリストを今すぐ描画します:フィルタリング、ソート、カード。
async renderCardPhotos(voucherIdVal, slot), 6159行。1つのカードの写真ストリップを埋めます。
4.2 アディンダUI(6190~6438行)
_addendaBadgeHTML(a), 6197行。どのアディンダがどのデバイスによって記録されたかを示すバッジ。
_addendumSummaryHTML(a), 6206行。アディンダの内容を説明する1行。
renderAddendaPanelHTML(occurrenceID), 6225行。保存済みバウチャーカードに表示されるアディンダパネル。
_addendumPersonDefault(voucherId), 6256行。誰がアディンダを記録したか。編集前に、上記優先順位で設定されます。
_rememberAddendumPerson(first, last, orcid), 6268行。最後のアディンダを記録した人物を記憶し、次回のために使用します。
showAddAddendumModal(voucherId, occurrenceID, type), 6274行。1つのバウチャーのアディンダ追加ダイアログを開きます。
closeAddendumModal(), 6298行。アディンダ追加ダイアログを閉じます。
_addendumFormatProblems(type, payload), 6310行。セーブゲートは108で座標と日付のチェックを学びましたが、このドアは一度もチェックせず、より悪質です。
submitAddendumModal(), 6325行。ダイアログからアディンダをチェックして保存します。
deleteVoucher(id), 6387行。1つのバウチャー、その写真とアディンダを削除します(Undo付き)。
openClearAllDialog(), 6400行。すべてクリアダイアログを開きます。
closeClearAllDialog(), 6402行。すべてクリアダイアログを閉じます。
async confirmClearAll(), 6412行。すべてのバウチャー、アディンダ、写真をクリアし、写真のスイープが完了した後にのみ再描画します。
4.3 アディンダ問題ノート(6439~6471行)
renderAddendumProblems(), 6450行。findLocalAddendumProblems() はアディンダが導入されて以来存在していましたが、コンパイラドロワー以外で呼び出されたことがありませんでした。そのため、ローカルレポートは孤立した、または2つの矛盾する再決定を保持する可能性がありましたが、それを示す兆候はありませんでした。
5.1 ダウンロードヘルパー(6472~6496行)
downloadBlob(name, content, mime), 6474行。ワークスペースプレフィックス付きの名前でコンテンツをファイルに保存します。
downloadCSV(name, csv), 6484行。CSVテキストを保存します(ExcelがUTF-8を読み取れるようにBOM付き)。
downloadJSON(name, obj), 6486行。オブジェクトを整形されたJSONとして保存します。
downloadHTMLFile(name, html), 6488行。HTML文字列をファイルとして保存します。
recordsFor(ids), 6491行。これらのIDを持つ保存済みバウチャー、またはすべて。
5.2 CSVエクスポートとインポート(6497~6598行)
_csvFormulaSafe(v), 6515行。=、+、@、またはタブで始まるセルは、Excel、LibreOffice、SheetsにとってテキストではなくFORMULAです。これらは開いたときに評価され、=cmd|'/c ...'!A1 はライブコマンドです。
csvUnescapeFormulaGuard(v), 6522行。エクスポート時に追加されたフォーミュラガード引用符を削除します。
csvEscape(v), 6527行。1つのCSVセル:必要に応じてフォーミュラガードと引用符が付けられます。
toCSV(records), 6533行。レコードをCSVテキストとして変換します。
exportCSV(ids), 6540行。バウチャーをCSVとしてエクスポートします。
parseCSV(text), 6549行。CSVテキストを行のセルに解析します。
importCSV(ev), 6569行。CSVファイルからバウチャーをインポートします。
5.3 JSONエクスポートとインポート(6599~6710行)
async recordsWithPhotoManifest(recs), 6606行。写真ファイルは Export All Photos (ZIP) を介して別途転送されます。このJSONはマニフェストのみを運びます。
async exportJSON(ids), 6692行。写真マニフェスト付きで、バウチャーをJSONとしてエクスポートします。
importJSON(ev), 6699行。JSONファイルからバウチャーをインポートします。
5.4 ZIPとXLSXエクスポート(6711~6936行)
crc32(bytes), 6717行。バイトのCRC-32チェックサム。ZIPエントリ用。
_u16(n), 6727行。16ビット数(2つのリトルエンディアンバイト)。
_u32(n), 6729行。32ビット数(4つのリトルエンディアンバイト)。
strToBytes(s), 6731行。テキストをUTF-8バイトに変換します。
base64ToBytes(b64), 6733行。Base64テキストをバイトに変換します。
colLetter(n), 6740行。列番号をスプレッドシートの文字に変換します(1 = A、27 = AA)。
xmlEsc(s), 6773行。XML用にテキストをエスケープします。改行を保持します。
makeZip(files), 6782行。ファイルを非圧縮ZIPにパックします(XLSXおよび写真エクスポート用)。
buildXLSX(records), 6824行。レコードからXLSXワークブック(QR画像付き)を構築します。
exportXLSX(ids), 6923行。バウチャーをXLSXとしてエクスポートします。
5.5 写真ZIPエクスポート(6937~7009行)
async exportAllPhotosZip(ids), 6953行。これらのバウチャーのすべての写真を1つのZIPとしてエクスポートします。マニフェスト付き。
5.5b このファイルをコピーして保存(7010~7130行)
_downloadFolderHint(), 7041行。このデバイスの通常のダウンロードフォルダの名前。通知用。
saveThisFileToDevice(), 7059行。このレポートファイル自体のコピーをデバイスに保存します。
async _finishSaveToDevice(bytes, picked, name), 7085行。バイトとフォルダの選択を待ち、コピーを書き込みます。
5.5b テイクホーム(7131~7712行)
async _sha256Hex(bytes), 7177行。バイトのSHA-256を小文字の16進数で返します。ブラウザがcrypto.subtleを提供しない場合は空文字列。
makeZipBlob(entries), 7189行。保存済み(非圧縮)ZIPをBlobとして作成します。makeZip() と同じレイアウトとUTF-8名フラグですが、各エントリのデータはコピーされないBlobである可能性があります。写真自身のBlobは参照によってアーカイブに格納されるため、200MBのパートがメモリ内で200MBのバイトを必要とすることはありません。
async _bundleTextEntry(name, text), 7210行。1つのテキストファイルをZIPエントリとして作成します。CRC、サイズ、SHA-256付き。
_bundledPhotoMap(), 7216行。写真IDから、それを保持する保存済みまたは共有バンドルの名前へのマッピング。
async _bundlePlan(recs, limits, opts), 7223行。各バウチャーがどの写真を持っているかを読み取り、バウチャーをパートに分割します。
_bundleCard(rec, photoPaths), 7253行。ビューアページが表示するような、1つのバウチャー。
_bundleViewerHTML(meta, cards), 7276行。open-me.html ページ。表示されるすべてが埋め込まれているため、サーバーやネットワークなしでフォルダから開くことができます。
_bundleReadme(meta, fileCount), 7339行。パートごとのREADME.txt:開き方と確認方法。
async _bundleBuildPart(plan, k, bundle), 7375行。1つのパートを構築します。各写真を一度読み取り(CRCとSHA-256のため)、その後写真自身のBlobをZIPに渡します。
_takeHomeSettings(), 7442行。バンドルがどこへ行くか。ワークスペースごとに記憶されます:ルート(「device」または「github」)、GitHubの場合は所有者/リポジトリとブランチ。
_githubRepoClean(v), 7447行。GitHubが許可する形式の所有者/リポジトリ。無効な場合は空文字列。
_githubUploadURL(repo, branch), 7452行。そのブランチのテイクホームフォルダを指すリポジトリのアップロードページ。
async openTakeHomeModal(ids, opts), 7457行。これらのバウチャー、またはすべてに対する「テイクホーム」ダイアログを開きます。
async _takeHomeSetNewOnly(on), 7470行。「まだテイクホームされていない写真のみ」ボックス。
async _takeHomeReplan(), 7477行。選択されたルートのパートをカットし、再計画します。
async _takeHomeSetting(key, value), 7485行。ルート、リポジトリ、またはブランチへの変更を保存し、再計画します。
_takeHomeGithubNote(), 7495行。GitHub行:リポジトリが有効になった後のアップロードリンクと、そこで行うこと。
_takeHomeRender(), 7507行。_takeHome からダイアログを描画します。
closeTakeHomeModal(), 7555行。「テイクホーム」ダイアログを閉じ、構築されたZIPを解放します。
async _takeHomePrepare(k), 7562行。1つのパートを構築し、何が含まれたかを記録し、次に「共有」と「保存」を提供します。
_takeHomeHandedOff(k, how), 7589行。パートがデバイスから離れたことを記録します。Removeステップが読み取るログに記録されます。
async _takeHomeShare(k), 7595行。準備されたパートをデバイスの共有シート経由で送信します。
_takeHomeSave(k), 7610行。準備されたパートをダウンロードします。
async clearBundledPhotos(), 7629行。Removeステップ。保存されたすべてのバウチャーを歩きます。バウチャーの写真は、それらのすべてがバンドルに含まれており、そのバンドルが保存または共有され、バンドルが記録したハッシュ値と一致する場合にのみ削除されます。
5.5c 持ち帰り、まだ安全でないもの(7713~7960行)
async _putPhotoRecord(rec), 7727行。1つの写真レコードを写真ストアに直接書き込みます。元のIDを保持します。
async importBundleFiles(ev), 7736行。「バンドルをインポート」ボタン:選択されたすべてのZIPを名前順に処理します。
async _importOneBundle(file, total), 7758行。1つのテイクホームZIP:addRecords() を通じてレコードをインポートし、次に各写真をチェックしてバウチャーに再アタッチします。
scheduleTakeHomeNote(), 7849行。まだテイクホームされていないアイテムのリストの更新をスケジュールします。
async renderTakeHomeNote(), 7854行。バンドルされていない写真を持つバウチャーをカウントし、行を描画します。
_anyDialogOpen(), 7908行。他のダイアログが既に開いている場合、true。そのため、オファーは順番待ちします。
async maybeOfferSnapshot(), 7913行。スナップショットを提供するかどうかを決定し、提供します。
_snapshotSnooze(hours), 7947行。オファーを閉じ、この時間だけ待機します。
_snapshotYes(), 7953行。はい:オファーを閉じ、スナップショットを開きます。スナップショットが破棄された場合、オファーがすぐに戻ってくるのを防ぐために短いスヌーズが設定されます。
5.6 メール(7961~7997行)
async emailreport(ids), 7969行。JSONエクスポートを共有またはメール送信します。
5.7 HTMLテーブルエクスポート(7998~8030行)
plainDoc(title, inner, extraCSS), 8000行。コンテンツの周りにプレーンな印刷可能なHTMLページを作成します。
exportHTMLTable(ids), 8018行。バウチャーを印刷可能なHTMLテーブルとしてエクスポートします。
5.8 ラベル印刷(8031~8178行)
_taxonHTML(name, qualifier), 8041行。決定をラベルHTMLとして表示します:名前の単語はイタリック、修飾語とランク接続子はローマン。
labelInner(v), 8058行。1つの標本ラベルの内側。
labelDoc(records), 8107行。標本ラベルのページ。4x3インチ。
printHTMLNow(html), 8139行。HTMLを新しいウィンドウで開き、印刷します。
printLabels(ids), 8173行。標本ラベルを印刷用に開きます。現在の決定が一番上に、元の決定は "Orig. det." として保持されます。
5.9 QRシート(印刷前)(8179~8371行)
_voucherIdTail(id), 8197行。Voucher IDの最後の4文字。小文字。短い場合は空文字列。
_setVoucherIdLabel(el, id), 8202行。Voucher IDをドラフトQRパネルに、最後の4文字を太字で書き込みます。
_qrSheetDefaultRows(), 8209行。シートの行を [{label, value}] の形式で返します。uiStateに記憶されます。
_qrSheetRows(), 8217行。保存されたQRシートの行、またはデフォルト。
_qrSheetRowsFromDOM(), 8225行。行エディタをダイアログから読み取ります。空の行は削除されます。
_qrSheetSave(), 8232行。入力中に保存します。そのため、キャンセルしても変更は保持されます。
_qrSheetRenderRows(rows), 8234行。行エディタを描画します:ラベル、値、削除。
_qrSheetAddRow(), 8244行。空の行を追加し、カーソルをラベルに入れます。
_mintSheetIds(n), 8255行。n個の小文字v4 UUIDを生成します。最後の4文字はバッチ内でユニークであり、このブラウザのバウチャー(または現在のドラフト)に既に存在する最後の4文字と重複しません。
qrSheetDoc(ids, fields), 8273行。印刷ウィンドウを構築します。UUIDごとに1つのレターサイズのページ。
openQrSheetModal(), 8310行。QRシートダイアログを開きます。初回使用時に構築します。
closeQrSheetModal(), 8344行。QRシートダイアログを閉じます。
_qrSheetKeydown(e), 8351行。Escapeキーでダイアログを閉じます。
_qrSheetSetCount(n), 8353行。10/20/50/100を選択し、対応するボタンを点灯させます。
_qrSheetResetFields(), 8358行。デフォルトの6行に戻し、プライマリコレクターから名前を取得します。
printQrSheets(), 8363行。行を保存し、バッチを生成し、印刷ウィンドウを開きます。
5.10 QRタグ(照合印刷)(8372~8624行)
_qrTagPerPage(), 8412行。保存されたページあたりのタグ数選択、または12。
_qrTagSetPerPage(n), 8418行。ページあたり20/12/6を選択し、ボタンを点灯させ、記憶します。
_qrTagNameHTML(v), 8425行。タグの名前行:修飾語はローマン、二名法はイタリック。
_qrTagTime(v), 8434行。ドラフトが開始された時刻(24時間制ローカルタイム)。保存時刻にフォールバックします。
_qrTagDates(), 8440行。コレクション日付のユニークなリストとカウント。新しい順。
_qrTagRecords(scope), 8446行。スコープが指定するレコード。古い順(フィールド順)。
_qrTagRenderScopes(), 8453行。スコープピッカーを埋めます:選択済み(あれば)、各日、すべて。
_qrTagRenderList(), 8464行。現在のスコープのチェックリストを描画します。シートIDバウチャーはデフォルトで選択解除されています。
_qrTagToggle(cb), 8480行。印刷に含まれる/含まれないチェックボックス。
_qrTagSetAll(on), 8485行。チェックリストのすべて/なし。
_qrTagCount(), 8489行。印刷ボタンが作成するタグの数を示します。
_qrTagSetScope(v), 8495行。スコープピッカーが変更されました。
qrTagDoc(recs, perPage), 8498行。印刷ウィンドウを構築します。コレクターと日付の見出しの下にグループ化された、カット可能なタグのレターサイズのグリッド。
openQrTagModal(), 8560行。QRタグダイアログを開きます。初回使用時に構築します。
closeQrTagModal(), 8598行。QRタグダイアログを閉じます。
_qrTagKeydown(e), 8605行。Escapeキーでダイアログを閉じます。
printQrTags(), 8608行。チェックされたバウチャーを保存順に印刷します。ポップアップブロッカーにブロックされないように、印刷ウィンドウはクリック内で開かれます。
5.11 コレクションシステム:Symbiota, Specify, DiSSCo(8625~9518行)
_csTermURI(name), 8703行。列名に対するタームURI:Dublin Core、Symbiota、またはDarwin Core。
_csCell(v), 8709行。マシンファイル用の1つのCSVセル:制御文字は削除、RFC 4180引用、それ以外は何もしません。
_csCSV(headers, rows), 8715行。ヘッダーとオブジェクトの行をCSVテキストとして、LF改行、末尾に改行。
_csTidy(v), 8721行。空白の連続をトリムして折りたたみます。
_csFull(first, last), 8723行。2つのパートから「First Last」を生成します。空白はスキップします。
_csParseName(raw), 8729行。学名を属、種小名、ランク、下位分類群名、および著者名に分割します。
_csMeters(raw), 8764行。「±4365 m」、「10m」、「0.5 km」、「30 ft」、「0.5 mi」をメートル単位で読み取ります。
_csQualifier(raw), 8778行。コレクションシステムが記述する形式でのIronfistの修飾語。決定済みは修飾語なし。
_csUSState(raw), 8788行。郵便コードまたはフルネームによる米国州または準州。{ value, matched }。
_csOrcid(raw), 8800行。生のORCID iDを https://orcid.org/ URIとして返します。それ以外はそのまま渡します。
_csSplitCollectors(raw), 8807行。追加コレクター("A B | C D")を [{ first, last, guess }] として分割します。
_csPrepare(recIn), 8820行。唯一のリーダー。両方のエクスポートが使用するすべての派生値は、装飾されたレコード(アディンダと現在のフィールド)から一度計算され、レビューフラグが追加されます。
_csReviewRows(P, system), 8970行。準備されたレコードごとの review.csv 行。このシステムに適用されるフラグのみ。
_csReview(rows), 8976行。review.csv テキスト。修正、チェック、情報の順にソート。カウント付き。
_csSymbiotaOcc(P), 8988行。準備されたレコードごとの発生コア行。追加タームの競合はフラグとして表示。
_csSymbiotaDets(P), 9021行。準備されたレコードごとの同定拡張行。古い順。
_csMetaXml(occCols, detCols), 9030行。アーカイブ用の meta.xml:コアと拡張。キーの後ろの各列に1つのフィールド要素。
buildSymbiotaArchive(recs), 9045行。これらの装飾されたレコードのSymbiota ZIPエントリ([{ name, text }])、およびレビューカウント。
_csSpecifyTaxonCols(n, h, family), 9096行。1つの決定のWorkBench列を [header, value] ペアとして返します。nは現在のもの(プレフィックスなし、ファミリー付き)が1、それ以前のものが2以上("Det 2 ...")。
_csSpecifyRow(P, nColl, nDet, addedTerms), 9117行。1つのWorkBench行を [header, value] ペアとして返します。エクスポートされるレコードが持つコレクターと決定の最大数に合わせてサイズ調整されるため、すべての行が同じ列を持ちます。
_csSpecifyTarget(header), 9145行。WorkBench列がSpecifyの標準スキーマのどこに配置されるか:{ table, field, note }。
buildSpecifyWorkbench(recs), 9208行。これらの装飾されたレコードのSpecify ZIPエントリ([{ name, text }])、およびレビューカウント。
_odsClean(v), 9301行。空文字列、null、空の配列、および @type のみを保持する空のオブジェクトを削除します。これにより、ファイルに空のキーが含まれなくなります。
_odsNum(s), 9313行。10進数文字列を数値として返します。数値でない場合はundefined。
_odsAgent(first, last, orcid, role, position), 9315行。単一の役割を持つopenDSエージェントとしての1人の人物。
_odsNameHTML(n), 9325行。ods:scientificNameHTMLLabel: 属と種小名はイタリック、× はイタリックの外、ランクマーカーと著者はローマン。
_odsSpecimen(P), 9340行。1つの準備されたレコードを ods:DigitalSpecimen として返します。
buildOpenDS(recs), 9430行。これらの装飾されたレコードのopenDS ZIPエントリ([{ name, text }])、およびレビューカウント。
_csDownload(built, base, label), 9488行。ビルダーのエントリをZIP化し、ダウンロードしてからレビューカウントを報告します。
async exportSymbiota(ids), 9496行。Symbiota用エクスポート:これらのバウチャー、またはすべてに対するDarwin Core Archive ZIP。
async exportOpenDS(ids), 9502行。DiSSCo用エクスポート:これらのバウチャー、またはすべてに対するopenDS Digital Specimen ZIP。
async exportSpecify(ids), 9508行。Specify用エクスポート:これらのバウチャー、またはすべてに対するWorkBenchデータセットZIP。
6.1 トースト(9519~9563行)
showUndoToast(message, undoFn), 9531行。数秒間、Undoボタン付きのメッセージを表示します。
hideUndoToast(), 9541行。Undoメッセージを非表示にします。
runUndo(), 9548行。保留中のUndoを実行し、メッセージを非表示にします。
showNotice(message, isError), 9554行。短いメッセージを表示します。エラーはより長く表示されます。
6.2 セクション状態(9564~9577行)
initSectionPersistence(), 9568行。開いているまたは閉じているフォームセクションを記憶します。
6.3 テーマ(9578~9593行)
toggleTheme(), 9580行。ライトテーマとダークテーマを切り替え、記憶します。
initTheme(), 9587行。保存されたテーマ、またはシステムのテーマを適用します。
6.4 ビルド名(9594~9608行)
buildLabel(), 9600行。ヘッダーチップが表示する短い形式、I.F.<n>。
applyBuildName(), 9602行。ビルド名をタブタイトルとヘッダースタンプに表示します。
6.5 ワークスペースバー(9609~9728行)
_wsHue(name), 9619行。ワークスペース名からの安定した色相。これが後で問題になるとわかっている。
_wsColor(name), 9625行。ワークスペースの色、またはデフォルトの場合はなし。
_wsListLoad(), 9627行。このブラウザが開いたワークスペースの共有リスト。
_wsListRemember(name), 9632行。ワークスペースを共有リストに追加します。
_wsHref(name), 9641行。ワークスペースのURL:この同じファイル、?ws=name(デフォルトはなし)。
_wsFavicon(), 9643行。タブアイコン:ワークスペースの最初の文字をその色の上に表示。
renderWorkspaceBar(), 9657行。このワークスペースのバー、ストライプ、アイコンを描画します。
_wsRenderList(), 9673行。スイッチャーリスト:デフォルトとすべての名前付きワークスペースをプレーンリンクとして表示。
toggleWorkspacePanel(force), 9683行。ワークスペーススイッチャーを開閉します。
confirmWorkspaceSwitch(name), 9693行。新しいワークスペース:名前を整理し、記憶し、このタブで移動します。
guardWorkspaceLink(e), 9705行。ワークスペースリンクのクリックをインターセプトし、ナビゲーションがページを離れる前にドラフトをフラッシュします。
openNewWorkspace(), 9715行。名前ボックスを読み取り、ワークスペース名が制限されている小文字ハイフン形式に正規化し、そのワークスペースを開きます。
6.6 同じワークスペース、2つのタブ(9729~9775行)
_wsBeat(), 9744行。他のタブにこのワークスペースがここで開いていることを伝えます。
_wsWarnTwice(), 9746行。このワークスペースが別のタブでも開いていることを警告します。
initWorkspacePresence(), 9753行。2タブチェックを開始します。
6.7 セッションバッジとトップスタンプ(9776~9823行)
renderSessionBadge(), 9785行。スキーマバージョンと短いデバイスタグを表示します。
renderTopStamp(), 9793行。このページが開かれた日時と短いデバイスタグを表示します。
async copySessionIdToClipboard(elId), 9801行。完全なデバイスタグをクリップボードにコピーします。
7.1 ストレージ耐性(9824~9991行)
_persistAsked(), 9884行。このブラウザは既に永続ストレージについて質問されましたか?
_markPersistAsked(), 9890行。このブラウザが実際に質問に回答したことを記録します。
requestPersistNow(), 9895行。ストレージストリップのボタン:このブラウザにデータを保持するように要求します。
_persistWithTimeout(), 9910行。ブラウザのプロンプトが応答されない場合、nullに解決します。これにより、ここで何もハングしません。
async checkStorageResilience(opts), 9917行。ローカルストレージの安全性をチェックし、リスクがある場合は通知を表示します。
7.2 ストアの調整(9992~10185行)
async reconcileStores(), 10024行。保存されたバウチャーと保存された写真を比較し、どちらかの孤立したものを報告します。
async purgeOrphanPhotos(), 10127行。確認後、バウチャーがないすべての写真を削除します。
async exportOrphanPhotos(), 10151行。孤立した写真をZIPに保存してから削除します。
7.3 ランタイムトレーサー(?trace)(10186~10300行)
_traceOn(), 10220行。URLが ?trace を要求している場合、true。
_traceWrap(name, fn), 10225行。関数をラップし、トレーサーが呼び出し回数と呼び出し元をカウントします。
_traceModule(moduleName, fns), 10244行。モジュールオブジェクト内のすべての関数をトレーサー用にラップします。
_traceInstall(), 10251行。すべてのグローバル関数に対してトレーサーをオンにします(?trace の場合のみ)。
_traceReport(), 10283行。トレーサーがこれまでに見たもの。
_traceDump(), 10293行。トレーサーレポートをコンソールに出力します。
7.4 セルフテスト(?selftest)(10301~10612行)
async runSelfTest(), 10318行。?selftest ラウンドトリップ:1つのフィクスチャバウチャーをストア、エクスポート、および元に戻します。
mapTableForSelfTest(headers, rows), 10595行。解析されたテーブルの列をFIELD_DEFSにマッピングします。セルフテストのCSV再インポート用。
9.2 コンパイラドロワー:マージルール(10959~11082行)
withCompileBatchId(recs), 10967行。このコンパイルのバッチIDを各レコードにスタンプします。
mergeAddendaInto(existing, incoming), 10979行。重複するoccurrenceIDが修正を失わなくなるように、2番目のコピーのアディンダを保持レコードに折りたたみます。アディンダIDで重複排除します。
mergePhotoLists(target, winnerPhotos, otherPhotos), 11005行。同じoccurrenceIDの2つの写真マニフェストの和集合。
_stampMs(v), 11026行。ミリ秒単位のタイムスタンプ、またはnull。
mergeFieldsInto(existing, incoming, incomingStamp), 11039行。同じoccurrenceIDのマージのフィールド部分:新しいコピーの値が勝ち、写真リストは和集合され、脇に置かれたコピーは競合として記録されます。
9.3 コンパイラドロワー:コンパイルと表示(11083~11241行)
el(id), 11085行。ドロワー内の document.getElementById のショートハンド。
recordKey(r), 11095行。レコードのマージキー:occurrenceID、またはそれがない場合はVoucher ID。
mergeRecords(items, sourceLabel), 11101行。1つのソースのレコードをコンパイル済みセットにマージし、変更されたものをカウントします。
cleanRecords(), 11146行。コンパイル済みレコードからドロワー固有のブックキーピングフィールドを削除します。
collectorsCount(), 11154行。コンパイル済みセット内のユニークなコレクターの数。
photoRefNames(), 11163行。コンパイル済みレコードが参照するすべての写真ファイル名。
fingerprintDrift(), 11178行。レビューアが実際に尋ねる、すべてのものを独自のプライベートコピーとして保持するドロワーに関するプロビジョニングの質問:エクスポートされるものが読み取ったバウチャーと矛盾する可能性があるか?
render(), 11189行。ドロワーのカウント、メッセージ、競合リストを再描画します。
9.4 コンパイラドロワー:リーダー(11242~11466行)
mapTable(headers, rows), 11244行。テーブル列をFIELD_DEFSにマッピングし、レコードを返します。
parseJsonText(text), 11264行。JSONテキストからのバウチャーレコード。
parseCsvText(text), 11271行。CSVテキストからのバウチャーレコード。
parseHtmlText(text), 11277行。エクスポートされたHTMLテーブルからのバウチャーレコード。
async _inflateRaw(bytes, expected), 11300行。圧縮されたZIPエントリを解凍します。暴走したものは拒否します。
async readStoredZip(buffer), 11321行。非圧縮ZIPを {path: bytes} に読み込みます。
colIndex(ref), 11364行。スプレッドシートセル参照の列を0ベースのインデックスに変換します。
_xmlDoc(bytes, what), 11370行。XMLバイトを解析します。破損している場合は明確なエラーを表示します。
_firstSheetPath(entries), 11383行。ワークブック順で最初のワークシートのパス。
_excelSerialToISO(v), 11404行。Excel日付シリアルをYYYY-MM-DDに変換します。他の値はそのまま渡します。
async parseXlsxBuffer(buffer), 11411行。XLSXファイルからのバウチャーレコード。
async parsePhotoZip(buffer), 11447行。写真ZIPから写真とそのマニフェストを読み込みます。
9.5 コンパイラドロワー:ファイル取り込み(11467~11532行)
async processFile(file), 11467行。ドロップされたファイルをタイプごとに読み取ります:JSON、CSV、HTML、XLSX、または写真ZIP。
async loadFiles(files), 11493行。ドロップされたファイルを順番に読み取り、失敗を報告しますが、停止しません。
async addThisreport(), 11509行。THE SEAM。このクロージャ内で、ファイル本体の他の部分のものを読み取る唯一の場所です:保存済みバウチャーの load()、それらの画像の getPhotosForVoucher()。
9.6 コンパイラドロワー:エクスポート(11533~11612行)
saveBlob(blob, filename), 11535行。Blobをワークスペースプレフィックス付きの名前で保存します。
exportCompilerJSON(), 11542行。コンパイル済みセットをJSONとしてエクスポートします。
exportCompilerCSV(), 11553行。コンパイル済みセットをCSVとしてエクスポートします。
exportCompilerHTML(), 11558行。コンパイル済みセットをHTMLテーブルとしてエクスポートします。
exportCompilerXLSX(), 11569行。コンパイル済みセットをXLSXとしてエクスポートします。
exportCompilerPhotos(), 11578行。コンパイル済みセットの写真を1つのZIPとしてエクスポートします。
clearCompiler(), 11607行。ドロワーを空にし、新しいバッチIDを開始します。
10 ペインシェル(11692~11937行)
isNarrow(), 11712行。レイアウトが1つのペインを一度に表示している場合、true。
currentPane(), 11715行。電話で表示されているペイン:「1」、「2」、または「3」。
showPane(n), 11718行。電話で1つのペインを表示します。広い画面では、そのペインが開いていることを確認するだけです。
toggleSide(side), 11729行。ウェッジ。狭い画面:そのペインとペイン2の間を切り替えます。
paint(), 11742行。タブの状態とウェッジ矢印を正確に保ちます。
revealElement(el), 11767行。要素をビューに表示します。電話ではペインを切り替え、広い画面では折りたたまれたペインを再度開き、その上のすべての <details> を開き、次にそのペインをスクロールします。
syncIdentificationChoices(), 11858行。現在の <select> の値を、それらの前に配置されたカードスタイルの選択トリガーにプッシュします。
close(), 11882行。選択ダイアログを閉じます。3つの出口(閉じるボタン、背景クリック、Escape)がすべて同じパスを通るように名前が付けられています。
B.3 特筆すべきエンジニアリング上の決定(ソースコード内の場所付き)
各項目は、実際の使用で障害が露呈した後に行われた変更です。ただし、そうでない場合はその旨が記載されています。行番号はソースコード内の根拠がある場所です。
1633行。ストレージ書き込みは大きな音で失敗する。 localStorageの書き込み拒否は以前は黙って処理され、キャッシュはレコードが保存されたと報告していました。レコードは実用的でエクスポート可能なのでキャッシュは保持されますが、ディスクがそれを受け取らなかったことを示す永続的なバナーが表示されます。
1709行。2つのタブ、1つのストア。 すべての書き込みは最初にディスクを再読み込みし、mutate() は各読み取り-変更-書き込みを、新しい読み取りと書き込みの間に行うため、2番目のタブの保存が古いコピーによって上書きされることはなくなりました。
1769行。2つのストアのための1つの障害レポーター。 レコードストアとドラフトオートセーブは異なるキーを書き込みますが、同じように失敗します。1つの関数がメッセージとバナーを所有します。
1829行。ローカルカレンダー日付。 todayISO() はUTCではなくローカル日付部分を使用するため、夕方の記録が翌日の日付になるのを防ぎます。
1949行。上書きではなくアディンダ。 修正は不変のoccurrenceIDにキー付けされた独自の行として記録されます。
2086行。アディンダはバウチャーとともに消滅する。 レコードを削除すると、その修正が孤立し、すべてのエクスポートに乗り込み、数か月後にコンパイルでアタッチするものがない状態で表面化していました。現在、レコードを削除すると、それに関連するアディンダも削除されます。
2136行。すべてのフォーマットに対応する単一のアディンダパーサー。 ネストされた配列またはシリアライズされたセル、同じ関数、破損したセルも許容します。
2259行。位置ではなく優越による地理参照。 コンパイル後、配列順序はロード順になるため、最新のもの勝ちが2つの独立した修正のいずれかを静かに勝たせていました。各地理参照は、それが上書きしたものを記録するようになりました。現在のヘッドが複数ある場合は競合として報告されます。
2316行。ローカルアディンダの問題が報告される。 チェックはコンパイラにのみ存在していましたが、現在ローカルセットで実行され、決定せずに報告します。
2382行。アディンダはインポートを生き延びる。 エクスポートはチェーンをネストしていましたが、インポートは行をFIELD_DEFSに通してネストされた配列を破棄していました。現在、すべての受信アディンダはupsertされ、親ポインタはローカルで保存されたレコードに書き戻されます。
2630行。ローカルインポートはoccurrenceIDで重複排除する。 異なるVoucher IDと同一のoccurrenceIDを持つ同僚のコピーは、2番目の標本としてインポートされていました。現在、既存のものに折りたたまれます。
2776行。occurrenceIDは再ラベル付けでも維持される。 印刷済みシートのスキャンは、レコードが持っていた唯一のUUIDを上書きしていました。標本UUIDはドラフト開始時に生成され、IDの再割り当てでは変更されなくなりました。
2897行。URL形式のIDはバックアップとともに移行される。 レコードが変更される前に、個別のバックアップキーが一度書き込まれます。
3206行、4056行。プログラムによる書き込み後のドラフト再同期。 GPSとEXIFは直接 .value を書き込みますが、これは入力イベントを発火させません。明示的な再同期がないと、セーブゲートは古い空値を認識していました。
3288行。Safari IndexedDB Blobの注意点、記載済み、未適用。 既知のWebKit Blobバグは、ArrayBufferワークアラウンドとともに文書化されていますが、テスト用のハードウェアなしで盲目的に適用されていません。
3304行。写真ストアのオープン失敗はキャッシュされない。 1回の拒否は、スペースが解放された後でも、それ以降の写真呼び出しすべてを失敗させていました。拒否はキャッシュをクリアするため、次の呼び出しで再試行されます。
3482行。EXIF内のVoucher ID。 手動構築のAPP1セグメント。ライブラリなし。
3614行。写真は最初のファイル名を保持する。 ファイル名はエクスポートリストの順序だったため、2回目のテイクホームバンドルは名前を再利用してインポート時に2つの写真を混同する可能性がありました。写真は現在、最初に出力された名前を保持します。
4130行。タイマーは入力時にアームされ、ドラフトにスコープされる。 ボタンのみのアームは手入力レコードをゼロ秒として記録していました。ページ全体のアームは、エクスポートクリックが空のドラフトでクロックを開始することを許可していました。
4190行。手動編集されるまで、決定はコレクターをミラーリングする。 自動入力された最後の値を追跡し、編集とデフォルトを区別します。
5008行。サイトは保存時にバンクされる。 このサイトの複製はライブフォームを読み取りましたが、誰もが使用する唯一のシーケンス(保存、次に複製)ではフォームは空でした。
5120行。オートセーブはIDを運ぶ。 新しく生成されたIDの下のテキストを復元すると、ドラフトが写真や印刷済みシートから分離されていました。IDを含むドラフト全体が保存および復元されるようになりました。
5183行。空のテストの代わりに初期スナップショット。 リセットされたフォームは決して空ではありません(日付、王国、データム、機関は引き継がれます)。そのため、「コンテンツあり」はリセット状態のスナップショットと比較されます。
5532行。日付と座標のフォーマットゲート。 空でないことは座標ではありません。形状は検証されますが、妥当性は主張されません。
5588行。写真と写真なしは相互排他的。 チェックボックスはチェック全体をショートカットしていたため、バウチャーは画像と「写真なし」フラグを同時に持つことができました。ゲートは現在、矛盾を拒否します。
5787行。王国はセッションに属する。 リセットと再読み込みで永続化されます。初回実行時のみPlantaeにデフォルト設定されます。
6057行。リストは現在の状態で装飾される。 検索、ソート、カードの見出しは、エクスポートとラベルと一致します。
6302行。アディンダダイアログは同じフォーマットゲートを取得する。 無効な修正緯度が、下流のリーダーが最も信頼する列である current_latitude になっていました。
6498行。スプレッドシートフォーミュラガード。 =、+、@、またはタブで始まるセルにアポストロフィプレフィックス。数値は除外され、経度が生き残るようにします。インポート時に元に戻されます。
6691行。JSONはバイトではなく写真マニフェストを運ぶ。 エクスポートを小さく、差分可能に保ちます。ZIPとテイクホームバンドルは、一致する名前の下に画像を運びます。
7131行。レコードと写真は一緒に移動する。 かつては名前の規則だけで結合された2つのファイルとして移動していました。テイクホームは、両方を含むパートごとに1つのZIP、それらを一緒に表示するページ、および各ファイルのSHA-256を作成します。バウチャーが2つのパートに分割されることはありません。
7167行。パートはGitHubの制限に合わせてカットされる。 GitHubのブラウザアップロードは、25 MiBを超えるファイルや一度に100ファイル以上を受け付けません。そのため、GitHubルートはパートを24 MiBと90枚の写真でカットします。ファイルはパートとリンクを構築し、コミットはコレクターのものです。
7625行。写真は証明可能な安全性が確認されてから削除される。 スペースを解放するためにバウチャーの写真を削除するのは、それらのすべてが保存済みまたは共有バンドルに含まれており、そのバンドルが記録したものと同じハッシュ値を持つ場合のみです。
7713行。バンドルはチェックされて戻ってくる。 テイクホームは一方通行でした。インポートバンドルはレコードを単一のインポートドアに戻し、各写真をマニフェストハッシュと比較します。失敗した写真は添付されず、名前が付けられます。
7912行。スナップショットは提供されるが、強制されない。 一部のブラウザは警告なしにサイトデータをクリアします。バンドルされていない作業が蓄積すると、ファイルはコピーを作成するかどうかを一度尋ねます。タップなしでは何も保存されません。
8145行。ラベルは現在の決定を印刷する。 修復ではなく決定。元の決定は "Orig. det." としてラベルに残され、再決定者と日付が追記されます。
8817行。3つのコレクションエクスポートのための単一のリーダー。 Symbiota、Specify、DiSSCoは、_csPrepare() を介して各レコードを読み取るため、現在の名前、コレクター、座標、レビューフラグについて一致します。
9268行。DiSSCoキーは省略され、偽造されない。 7つの必須openDSキーはDiSSCoによって取り込ま時に生成されます。エクスポートはそれらを省略し、READMEにその旨が記載されています。このファイルは取り込み前のDigital Specimenです。
9838行。WebKitの追放、両方のメカニズム。 ストレージ圧力による追放(persist() で軽減)とITPの7日間ルール(ホーム画面へのインストールでのみ軽減)を区別し、アドバイザリーはテストされていないとラベル付けされています。
10971行。コンパイラは重複するoccurrenceIDのアディンダをマージする。 2番目のコピーの修正は以前はコピーとともに破棄されていました。
11028行。コンパイラはフィールドをマージし、新しい方が勝つ。 最初にロードされたコピーが勝者でしたが、後で修正されたエクスポートが古いものに負けていました。新しいコピーの値が勝ち、写真リストは和集合され、脇に置かれたコピーは名前が付けられます。
11086行。コンパイラは単一のエントリドアを使用する。 ドロワーは以前、canonicalRecord() のほぼコピーを独自に保持していました。フラットフォーマットは空のチェーンにコンパイルされ、CSV往復は再決定を元に戻しました。
11609行。クリア時に新しいコンパイルバッチID。 バッチIDはドロワーがクリアされると終了します。
B.4 SERNEC取得ドクトリンとサンプリングスクリプト
SERNECエージェント取得ドクトリン、v2候補フリーズ
目的
これは境界設定された標本データ取得研究です。エージェントは取得ワーカーであり、分類学者、データクリーナー、アナリスト、または研究デザイナーではありません。
エージェントの仕事は取得であり、判断ではない。
失敗はデータである。置換は汚染である。
ソース境界
- 標本取得には SERNECのみ を使用してください:https://sernecportal.org/portal/collections/search/index.php
- 指定された正確なコレクション/機関コードと属を検索してください。
- 失敗したSERNEC検索をGBIF、iDigBio、Google、機関ポータル、NCBI、または他のソースで救済しないでください。
- SERNECインターフェースは共有のSEINetデータベースを検索するため、正確なフリーズされたコレクションコードを選択することが必須です。
フリーズされた研究アーム
A. RANDOM_SURVEY
Micranthes; Potentilla; Euphorbia; Ribes; Ranunculus; Lupinus; Polygonum; Solidago; Chorizanthe; Eragrostis。
B. STRESS_TEST、別の意図的な研究
Carex; Cyperus; Solidago; Panicum。
Stress-testの属は意図的に選択されており、ランダムサーベイ推論の一部ではありません。
Solidagoは設計により両方の腕に登場します。RANDOM_SURVEY/SolidagoとSTRESS_TEST/Solidagoは別々の実験セルです。それらをマージしないでください。
フリーズされた機関パネル
ソースリストには486のコレクションエントリが含まれており、シード20260827で既にランダム化されていました。そのフリーズされたリストを SERNEC - Southeastern Herbaria タグが付いた行に制限し、既存のランダム順序を維持し、最初の20件を取得してください。結果として得られた20件は 01_FROZEN_sernec_institutions_20.csv に固定されます。
疎、空、破損、扱いにくい、または予期せず大きいという理由で、機関を再描画、置換、または置き換えないでください。
取得ユニット
取得ユニットは次のとおりです。
Study_Arm × Institution × Genus
280個のフリーズされた取得セルがあります:20機関 ×(10のランダム属 + 4のストレステスト属)。
種は、このフェーズでは事前に選択されません。 前のドラフトでは、サポートされていない10種/属のターゲットが導入されましたが、そのルールは撤回されました。種名は、SERNECによって返された標本レコードに含まれるとおりに保持され、後で別途設計されたステップとして分析される可能性があります。
レコードサンプリングルール
ターゲット = 取得セルあたり最大100件の標本レコード。
各Study_Arm × Institution × Genusについて:
- SERNECで正確なフリーズされた機関/コレクションと属を検索します。
- SERNECが利用可能であれば、報告された結果カウントを記録します。
- SERNECが許可する場合、完全な一致結果セット をエクスポートします。
- 生の(raw)エクスポートをそのまま保持します。
- 完全な結果が0件の場合:0件を保持/報告します。
- 1~100件の場合:すべての レコードを保持します。
- 100件を超える場合:提供されたPythonサンプラーを完全な生のCSVで実行し、置換なしで100件の再現可能なランダムサンプルを保持します。
- ランダムサンプリングの代わりとして、表示される最初の100件のレコードを絶対に使用しないでください。
- SERNECがエージェントがエクスポートできる数よりも多くのマッチを報告した場合、セルを
CAPPEDとマークしてください。切り詰められたエクスポートからのランダムサンプルが完全なセルを表すと偽らないでください。
種の取り扱い
- 取得中に種を選択、バランス調整、置換、正規化、または層別化しないでください。
- 同数の種を強制しないでください。
- サンプリングされた標本レコードに含まれる種決定をそのまま保持してください。
- 空、
sp.、cf.、aff.、下位分類群、同義語、または奇妙な分類群文字列はそのまま残します。 - 後続の種レベルのサンプリングは、別途決定された研究であり、実行前にフリーズされる必要があります。
保存ルール
生のSERNECレコードをクリーンアップ、正規化、修正、推論、地理参照、重複排除、マージ、エンリッチ、または分類学的に調整しないでください。
生の(raw)エクスポートを上書きしないでください。派生した100行サンプルのファイル名は区別する必要があります。
推奨される生のファイル名:<StudyArm>__<InstitutionCode>__<Genus>__RAW.csv
推奨されるサンプリング済みファイル名:<StudyArm>__<InstitutionCode>__<Genus>__SAMPLE100.csv
停止/失敗ルール
即興で修正するのではなく、停止して報告してください。もし:
- マッチするSERNECレコードがない場合。
- ポータル結果/ダウンロードキャップが完全なエクスポートを妨げる場合。
- タイムアウト/ハング。
- 機関/コレクションフィルターが間違っているように見える場合。
- 属クエリが曖昧な場合。
- CSVダウンロードが失敗した場合。
- 提供されたURLが利用できない場合。
- 要求されたコレクションが見つからない場合。
他の属、機関、ポータル、クエリ解釈、またはソースを代用しないでください。
各セルに必要な戻り値
- Job_ID
- Study_Arm
- Institution_Code
- Institution_Name
- Genus
- Record_Target
- SERNEC_Result_Count (表示される場合)
- Exported_Row_Count
- Retrieval_Status: COMPLETE / SPARSE / ZERO / FAILED / CAPPED
- Query_or_Result_URL
- Retrieval_Date
- Raw_Filename
- Failure_or_Note
1文の運用ルール
与えられたものを正確に検索し、SERNECが返すものを正確にエクスポートし、そのまま保持し、修正する代わりにすべての失敗を報告してください。
サンプリングスクリプト
注意:ループは実行中にオンザフライで反転されました。その変更は以下のリストには反映されていません。
#!/usr/bin/env python3
"""Reproducibly sample up to 100 specimen rows from one COMPLETE raw SERNEC CSV.
Usage:
python 04_sample_records.py RAW.csv SAMPLE.csv STUDY_ARM INSTITUTION_CODE GENUS
Rules:
- RAW.csv is never modified.
- 0..100 data rows -> retain all.
- >100 data rows -> sample 100 without replacement.
- Sampling seed is deterministically derived from MASTER_SEED + cell identity.
- Output preserves the original column set. Selected rows are written in original
raw-file order after row indices are sampled.
"""
import csv
import hashlib
import random
import sys
from pathlib import Path
MASTER_SEED = 20260828
TARGET = 100
if len(sys.argv) != 6:
raise SystemExit(
"Usage: python 04_sample_records.py RAW.csv SAMPLE.csv STUDY_ARM INSTITUTION_CODE GENUS"
)
raw_path = Path(sys.argv[1])
out_path = Path(sys.argv[2])
arm = sys.argv[3].strip()
institution = sys.argv[4].strip()
genus = sys.argv[5].strip()
raw_bytes = raw_path.read_bytes()
raw_sha256 = hashlib.sha256(raw_bytes).hexdigest()
with raw_path.open("r", newline="", encoding="utf-8-sig") as f:
reader = csv.reader(f)
try:
header = next(reader)
except StopIteration:
raise SystemExit("RAW CSV is empty: no header row")
rows = list(reader)
n_available = len(rows)
seed_text = f"{MASTER_SEED}|{arm}|{institution}|{genus}|{raw_sha256}"
seed_int = int(hashlib.sha256(seed_text.encode("utf-8")).hexdigest(), 16)
if n_available <= TARGET:
selected_indices = list(range(n_available))
rule = "ALL_AVAILABLE"
else:
rng = random.Random(seed_int)
selected_indices = sorted(rng.sample(range(n_available), TARGET))
rule = "RANDOM_100_WITHOUT_REPLACEMENT"
out_path.parent.mkdir(parents=True, exist_ok=True)
with out_path.open("w", newline="", encoding="utf-8") as f:
writer = csv.writer(f)
writer.writerow(header)
for i in selected_indices:
writer.writerow(rows[i])
print(f"RAW_SHA256={raw_sha256}")
print(f"CELL={arm}|{institution}|{genus}")
print(f"AVAILABLE_ROWS={n_available}")
print(f"SELECTED_ROWS={len(selected_indices)}")
print(f"RULE={rule}")
print(f"MASTER_SEED={MASTER_SEED}")
print(f"OUTPUT={out_path}")