// GraalJS Script (engine type: 2)
//////// START "main()" /////////////////////////////////////////////////////////////////
main();
function main(){
//// == Config Retrieving / 工程コンフィグの参照 ==
const strAuthzSetting = configs.get ( "AuthzConfU" ); /// REQUIRED
engine.log( " AutomatedTask Config: Authz Setting: " + strAuthzSetting );
const strWpcomDomain = configs.get ( "StrConfA1" ); /// REQUIRED
if( strWpcomDomain === "" ){
throw new Error( "\n AutomatedTask ConfigError:" +
" Config {A1: WordPress.com domain} is empty \n" );
}
const strPostId = configs.get ( "StrConfB1" ); /// REQUIRED
if( strPostId === "" ){
throw new Error( "\n AutomatedTask ConfigError:" +
" Config {B1: PostID} is empty \n" );
}
const strPeriodStart = configs.get ( "StrConfB2" ).substring(0, 10); /// REQUIRED
if( strPeriodStart === "" ){
throw new Error( "\n AutomatedTask ConfigError:" +
" Config {B2: PeriodStart} is empty \n" );
}
const strPeriodEnd = configs.get ( "StrConfB3" ).substring(0, 10); /// REQUIRED
if( strPeriodEnd === "" ){
throw new Error( "\n AutomatedTask ConfigError:" +
" Config {B3: PeriodEnd} is empty \n" );
}
const numPocketSubtotal = configs.getObject( "SelectConfC1" ); // NotRequired
const numPocketTotal = configs.getObject( "SelectConfC2" ); // NotRequired
const strPocketTsv = configs.getObject( "SelectConfC3" ); // NotRequired
const strPocketTsvSwitched = configs.getObject( "SelectConfC4" ); // NotRequired
//// == Data Retrieving / ワークフローデータの参照 ==
// (Nothing. Some workflow data is referenced via Expression Language in Config.)
//// == Calculating / 演算 ==
/// Get Views
/// WordPress.com REST API
/// https://developer.wordpress.com/docs/api/1.1/get/sites/%24site/stats/post/%24post_id/
// request1, prepare
let request1Uri = "https://public-api.wordpress.com/rest/v1.1/sites/" +
strWpcomDomain + "/stats/post/" + strPostId;
let request1 = httpClient.begin(); // HttpRequestWrapper
request1 = request1.authSetting( strAuthzSetting ); // with "Authorization: Bearer XX"
request1 = request1.queryParam( "fields", "views,data" );
// https://questetra.zendesk.com/hc/en-us/articles/360024574471-R2300#HttpRequestWrapper
// request1, try
const response1 = request1.get( request1Uri ); // HttpResponseWrapper
engine.log( " AutomatedTask ApiRequest1 Start: " + request1Uri );
const response1Code = response1.getStatusCode() + "";
const response1Body = response1.getResponseAsString() + "";
engine.log( " AutomatedTask ApiResponse Status: " + response1Code );
if( response1Code !== "200"){
throw new Error( "\n AutomatedTask UnexpectedResponseError: " +
response1Code + "\n" + response1Body + "\n" );
}
// response1, parse
/*
engine.log( response1Body ); // debug
{
"views":1,
"data":[
["2021-06-25",0],
["2021-06-26",0],
["2021-06-27",0],
["2021-06-28",0],
["2021-06-29",1],
["2021-06-30",0]
]
}
*/
const response1Obj = JSON.parse( response1Body );
const datePeriodStart = toJsDate( strPeriodStart );
const datePeriodEnd = toJsDate( strPeriodEnd );
let numSubtotal = 0;
let strTsv = "date\tviews\n";
let strTsvSwitchedDate = "date\t";
let strTsvSwitchedViews = "views\t";
for( let i = 0; i < response1Obj.data.length; i++ ){
let dateTmp = toJsDate( response1Obj.data[i][0] );
if( datePeriodStart.getTime() <= dateTmp.getTime() ){
if( dateTmp.getTime() <= datePeriodEnd.getTime() ){
numSubtotal += response1Obj.data[i][1];
strTsv += response1Obj.data[i][0] + "\t" + response1Obj.data[i][1] + "\n";
strTsvSwitchedDate += response1Obj.data[i][0] + "\t";
strTsvSwitchedViews += response1Obj.data[i][1] + "\t";
}else{
break;
}
}
}
strTsv = strTsv.slice(0, -1); // Remove Last "\n"
strTsvSwitchedDate = strTsvSwitchedDate.slice(0, -1); // Remove Last "\t"
strTsvSwitchedViews = strTsvSwitchedViews.slice(0, -1); // Remove Last "\t"
let strTsvSwitched = strTsvSwitchedDate + "\n" + strTsvSwitchedViews;
//// == Data Updating / ワークフローデータへの代入 ==
if( numPocketSubtotal !== null ){
engine.setData( numPocketSubtotal, new java.math.BigDecimal( numSubtotal ) );
}
if( numPocketTotal !== null ){
engine.setData( numPocketTotal, new java.math.BigDecimal( response1Obj.views - 0 ) );
}
if( strPocketTsv !== null ){
engine.setData( strPocketTsv, strTsv );
}
if( strPocketTsvSwitched !== null ){
engine.setData( strPocketTsvSwitched, strTsvSwitched );
}
} //////// END "main()" /////////////////////////////////////////////////////////////////
function toJsDate( bpmsDateOrDatetimeStr ){
// BPMS Date: "2020-04-01" (subtype "Y/M" "M/D" "Y", not supported)
// BPMS Datetime: "2020-04-01 23:59"
let year = 0;
let monthIndex = 0;
let day = 0;
let hours = 0;
let minutes = 0;
// The ECMA/JavaScript Date object has a large number of methods.
// "Date.parse" is danger (strongly discouraged)
// - new Date("2014-11-10") // Mon Nov 10 2014 09:00:00 GMT+0900 (JST)
// - new Date(2014, 10, 10) // Mon Nov 10 2014 00:00:00 GMT+0900 (JST)
let arrDatetime = bpmsDateOrDatetimeStr.split(" ");
if( arrDatetime.length === 1 ){
let arrDateParts = arrDatetime[0].split("-");
year = parseInt(arrDateParts[0], 10);
monthIndex = parseInt(arrDateParts[1], 10) - 1;
day = parseInt(arrDateParts[2], 10);
}
if( arrDatetime.length === 2 ){
let arrDateParts = arrDatetime[0].split("-");
let arrTimeParts = arrDatetime[1].split(":");
year = parseInt(arrDateParts[0], 10);
monthIndex = parseInt(arrDateParts[1], 10) - 1;
day = parseInt(arrDateParts[2], 10);
hours = parseInt(arrTimeParts[0], 10);
minutes = parseInt(arrTimeParts[1], 10);
}
return new Date( year, monthIndex, day, hours, minutes );
}
/*
Notes-en:
- Refers Jetpack stats for your WordPress.com account.
- WordPress.com is a service that hosts WordPress sites. It is provided by Automattic itself.
- Request is made to the "WordPress.com REST API" (WP.COM API).
- https://developer.wordpress.com/docs/api/
- Note: Not the "WP.REST API" for WordPress.Org.
- For the ID of the existing article, refer to the URL of the edit screen.
- Number following `post =`
- "Date-Views TSV for Chart" is a TSV with the rows and columns switched.
- The horizontal axis (X axis) is the date. It can be used as data for bar and line charts.
- If the date is set in the datetime format, the time part will be ignored.
- Example: "2021-12-31 12:34" → "2021-12-31"
- If a day without logs is specified, that the number of views is considered to be 0.
- No error will occur.
APPENDIX-en
- You can also refer to it by "Site ID" (blogid) instead of the WordPress.Com domain.
- Site ID (blogid) is obtained from `GET v1.1/sites/example.blog/` and the "View page source".
- Setting example of "HTTP Authentication" (OAuth2)
- Authorization Endpoint URL:
- https://public-api.wordpress.com/oauth2/authorize
- Token Endpoint URL:
- https://public-api.wordpress.com/oauth2/token
- Scope:
- "global", "", "auth" or "media"
- (document) https://developer.wordpress.com/docs/oauth2/
- By default, the token will grant the application full access to a single blog.
- Needs a "global" scope, if to access to all the blogs that users have on WordPress.com.
- Client ID, Consumer Secret:
- ( from https://developer.wordpress.com/apps/ )
- Redirect URLs: https://s.questetra.net/oauth2callback
Notes-ja:
- WordPress.com アカウントの Jetpack 統計値を参照します。
- WordPress.com は WordPress sites をホストするサービスです。Automattic 社自身が提供しています。
- "WordPress.com REST API" (WP.COM API) に対してリクエストが投げられます。
- https://developer.wordpress.com/docs/api/
- 注： WordPress.Org 用の "WP.REST API" ではありません。
- 既存記事のIDは、編集画面のURL等を参照してください。
- `post=` に続く数字
- 「Date-Views TSV（グラフ用）」は「Date-Views TSV」の行と列が入れ替わったTSVです。
- 横軸（X軸）が日付となります。棒グラフや折れ線グラフのデータとして活用できます。
- 日付が日時フォーマットで設定された場合、時刻部分は無視されます。
- 例: "2021-12-31 12:34" → "2021-12-31"
- ログのない時期が指定された場合、当該日は 0 とみなします。
- エラーにはなりません。
APPENDIX-ja:
- WordPress.Com ドメインの代わりに「サイトID」（blogid）で参照することも可能です。
- サイトID（blogid）は、"`GET v1.1/sites/example.blog/`" や "ページのソース" 等から取得します。
- "HTTP認証設定" の例 (OAuth2)
- 認可エンドポイント URL:
- https://public-api.wordpress.com/oauth2/authorize
- トークンエンドポイント URL:
- https://public-api.wordpress.com/oauth2/token
- スコープ:
- "global", "", "auth" or "media"
- (document) https://developer.wordpress.com/docs/oauth2/
- デフォルトでは、１つの blog に対するアクセスが認可されます。
- 全保有 blogs へアクセスできるようにするには "global" をセットします。
- クライアントID, クライアントシークレット:
- ( 開発者ページから取得してください⇒ https://developer.wordpress.com/apps/ )
- Redirect URLs: https://s.questetra.net/oauth2callback
*/
