Quser, Set One User of Qorg Randomly

// GraalJS Script (engine type: 2)

//////// START "main()" /////////////////////////////////////////////////////////////////
main();
function main(){ 

//// == Config Retrieving / 工程コンフィグの参照 ==
const qorgPocketPopulation = configs.getObject( "SelectConfA" ); /// REQUIRED ///////////
const strExcludedMembers   = configs.get( "StrConfB" );          // not required ////////
const quserPocketSelected  = configs.getObject( "SelectConfC" ); /// REQUIRED ///////////


//// == Data Retrieving / ワークフローデータの参照 ==
const qorgPopulation       = engine.findData( qorgPocketPopulation );
  if( qorgPopulation     === null ){
    throw new Error( "\n AutomatedTask ConfigError:" +
                     " Qorg {A} is null \n" );
  }
// com.questetra.bpms.core.event.scripttask.WorkflowEngine
// https://questetra.zendesk.com/hc/ja/articles/360024574471-R2300#WorkflowEngine


//// == Calculating / 演算 ==
let   listQusers = quserDao.findByQgroup( qorgPopulation );
  if( listQusers === null ){
    throw new Error( "\n AutomatedTask UnexpectedQorgError:" +
                     " Qorg {A} has no member \n" );
  }
let numOfQusers = listQusers.size() - 0;
// com.questetra.bpms.core.event.scripttask.QuserDaoWrapper
// https://questetra.zendesk.com/hc/ja/articles/360024574471-R2300#QuserDaoWrapper

let arrQusers = [];
for( let i = 0; i < numOfQusers; i++ ){
  arrQusers.push( (listQusers.get(i).getEmail() + "") );
  // com.questetra.bpms.core.event.scripttask.QuserView
  // https://questetra.zendesk.com/hc/ja/articles/360024574471-R2300#QuserView
}
if( strExcludedMembers !== "" ){
  let arrExcludedMembers = strExcludedMembers.split('\n');
  for( let i = 0; i < arrExcludedMembers.length; i++ ){
    let numId = arrQusers.indexOf( arrExcludedMembers[i] );
    if( numId > -1 ){
      arrQusers.splice( numId, 1 ); // remove 1 element at `numId`
    }
  }
}
if( arrQusers.length === 0 ){
  throw new Error( "\n AutomatedTask UnexpectedQorgError:" +
                   " Population is Zero \n" );
}

let numRand = Math.floor( Math.random() * arrQusers.length );
engine.log( " AutomatedTask numRand: " + numRand +
            " (" + arrQusers.length + ")" );
let strSelected = arrQusers[ numRand ];
let quserSelected = quserDao.findByEmail( strSelected );
// com.questetra.bpms.core.event.scripttask.QuserDaoWrapper
// https://questetra.zendesk.com/hc/ja/articles/360024574471-R2300#QuserDaoWrapper


//// == Data Updating / ワークフローデータへの代入 ==
engine.setData( quserPocketSelected, quserSelected );


} //////// END "main()" /////////////////////////////////////////////////////////////////

/*
Notes:
- When the process reaches the automated task, the Qorg settings of the Workflow Platform are referred.
    - To explicitly and automatically determine the person in charge.
    - The Process Status "Offered" is avoided.
APPENDIX:
- The random number generation depends on `Math.random()` (JavaScript).
    - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/random

Notes-ja:
- 案件が自動処理工程に到達した際、ワークフロー基盤の Qorg 設定を参照し、一人を抽出します。
    - 明示的・自動的に担当者を決めたい場合などに利用されます。
    - プロセス状態「引き受け待ち」を回避できます。
APPENDIX-ja:
- 乱数の生成分布は `Math.random()` (JavaScript) に依存します。
    - https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Math/random
*/