オペレーターが編集したら自動的にレビュー待ちタグを付けるUserScript
動作はレビュー待ちタグつけUserScriptの動作確認で確認してください
このページでは確認しないでください
下に書かれている解説も全て「レビュー待ち」に置換してしまう為
UserScript Page Edit APIを使っている
用途
コールセンターの
レビューしましたボタンUserScriptと組み合わせて使う
できた
以下、scriptとその解説です
グローバル汚染しないようスコープを作る
script.jsrequestAnimationFrame(() => {個人ページに書いた設定の読み込みを待つため
詳しくはproject memberをグループ分けして、必要なUserScriptだけを有効化するを読んでください
以下は全てこのUserScript用のスコープ内で実行される
SVはこのscriptを使わない
script.jsif (window.KCS?.role === 'SV') return;早期returnでさっさと終了する
UserScript Eventsのlines:changedで行の変更を検知してレビュー状態を更新する
script.jscosense.on('lines:changed', ({ by }) => {
if (by === 'edit') updateKnowledgeReviewState();
}); by === 'edit' で lines:changed の発火元を区別している区別しないと、同じページを編集している他人の編集でもタグが付いてしまう
詳しくはlines:changedイベントの発火元が自分なのか同時編集してる他人なのか区別するを読んでください
lines:changed イベントから呼び出される関数。hashtagを書き換えるscript.jsasync function updateKnowledgeReviewState () {
if (cosense.Layout !== 'page') return;
if (!cosense.Page.metadata?.links?.includes('ナレッジ記事')) return;
if (updateAllLinksInPage({ from: 'レビュー完了ナレッジ記事', to: 'レビュー待ちナレッジ記事' })) return;
if (cosense.Page.metadata?.links?.includes('レビュー待ちナレッジ記事')) return;
cosense.Page.insertLine('#レビュー待ちナレッジ記事', 1);
}
対象は
#ナレッジ記事 が付いているページだけページ内の全ての #レビュー完了ナレッジ記事 を #レビュー待ちナレッジ記事 に置換する
もちろんレビュー完了ナレッジ記事というリンク記法もレビュー待ちナレッジ記事に置換する
置換対象が無い場合
ページの最上部に #レビュー待ちナレッジ記事 を書き込む
ページ内の全てのリンク記法を置換する便利な関数
返り値
条件に合う対象を置換したらtrue、1つも置換しなかったらfalse
script.jsfunction updateAllLinksInPage({ from, to }) {
let updated = false;
for (const [index, line] of cosense.Page.lines.entries()) {
if (!line.nodes) continue;
const result = updateLink({ node: line.nodes, from, to });
if (result !== line.text) {
cosense.Page.updateLine(result, index);
updated = true;
}
}
return updated;
}1行を処理する関数
行の文字列からブラケティングをparseし、リンク記法だけ置換して、文字列に戻す
script.jsfunction updateLink({ node, from, to }) {
const args = { from, to };
if (typeof node === 'string') return node;
if (Array.isArray(node)) return node.map(i => updateLink({ node: i, ...args })).join('');
switch (node.type) {
case 'link':
case 'hashTag': {
if (!node.unit.project && node.unit.page === from) {
node.unit.page = to;
}
return node.unit.whole;
}
case 'indent':
case 'quote': {
return node.unit.tag + updateLink({ node: node.children, ...args });
}
case 'deco': {
return '[' + node.unit.deco + ' ' + updateLink({ node: node.children, ...args }) + ']';
}
case 'strong': {
return '[[' + updateLink({ node: node.children, ...args }) + ']]';
}
}
return node.unit.whole;
}グローバル汚染しないように作ったスコープを閉じる
script.js});