ID 情報の取得方法

サイト コレクション ID、チーム ID、サービス ID の取得方法については、以下の説明を参照してください。

サイト コレクション ID

サイト コレクション ID は、サイト コレクションのライフサイクル管理サービス要求またはサイト コレクション設定の変更サービス要求を送信するスクリプトを実行する際に必要です。

サイト コレクションのライフサイクル管理サービス要求のサイト コレクション ID を取得するには、以下の説明を参照してください。

1.   以下のエンドポイント URL を使用して ServiceNow の REST メッセージを作成します。

${data_center_url}/services/sitelifecycle/${serviceId}/url/validation

REST メッセージの作成方法については、REST メッセージの作成 の説明を参照してください。

2.   以下のサンプル スクリプを参照してスクリプトを実行します。

try{

    var serviceId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx";

    var validationInfo= {};

    validationInfo.uri = "https://xxxxx.sharepoint.com/sites/demoSC";

 

    sm = new sn_ws.RESTMessageV2('x_avepo_cg_modern.Validate Site', 'Post Validate SC lifecycle');

    sm.setStringParameter('data_center_url', gs.getProperty('x_avepo_cg_modern.data_center_url'));

    sm.setStringParameter("gao_api_clientsecret", gs.getProperty('x_avepo_cg_modern.gao_api_clientsecret'));

    sm.setStringParameter("gao_user_name",   gs.getProperty('x_avepo_cg_modern.gao_user_name'));

    sm.setStringParameter("serviceId", serviceId);

    sm.setRequestBody(global.JSON.stringify(validationInfo));

    response = sm.execute();

    var result= response.getBody();

  gs.info("Validate url for sc lifecycle service, details is: " + result

} catch (ex) {

    gs.error(ex);

}

3.   スクリプトの実行後、返された siteId がサイト コレクション ID です。

サイト コレクション設定の変更サービス要求のサイト コレクション ID を取得するには、以下の説明を参照してください。

1.   以下のエンドポイント URL を使用して ServiceNow の REST メッセージを作成します。

${data_center_url}/services/changesitesetting/${serviceId}/url/validation

REST メッセージの作成方法については、REST メッセージの作成 の説明を参照してください。

2.   以下のサンプル スクリプを参照してスクリプトを実行します。

try{

    var serviceId = "xxxxxx-xxxx-xxxx-xxxxxx";

    var validationInfo= {};

    validationInfo.uri = "https://xxxx.sharepoint.com/sites/demoSC";

 

    sm = new sn_ws.RESTMessageV2('x_avepo_cg_modern.Validate Site', 'Post Validate Change SC');

    sm.setStringParameter('data_center_url', gs.getProperty('x_avepo_cg_modern.data_center_url'));

    sm.setStringParameter("gao_api_clientsecret", gs.getProperty('x_avepo_cg_modern.gao_api_clientsecret'));

    sm.setStringParameter("gao_user_name",   gs.getProperty('x_avepo_cg_modern.gao_user_name'));

    sm.setStringParameter("serviceId", serviceId);

    sm.setRequestBody(global.JSON.stringify(validationInfo));

    response = sm.execute();

    var result= response.getBody();

    gs.info("Validate url for change sc service, details is: " + result

} catch (ex) {

    gs.error(ex);

}

3.   スクリプトの実行後、返された siteId がサイト コレクション ID です。

チーム ID

チーム ID は、チームのライフサイクル管理サービス要求またはチーム設定の変更サービス要求を送信するスクリプトを実行する際に必要です。

チームのライフサイクル管理サービス要求またはチーム設定の変更サービス要求のチーム ID を取得するには、以下の説明を参照してください。

1.   以下のエンドポイント URL を使用して ServiceNow の REST メッセージを作成します。

${data_center_url}/users/resolve?keyword=${groupemail}&userType=4&sharingOptions=0&userSource=2

REST メッセージの作成方法については、REST メッセージの作成 内の説明を参照してください。

2.   以下のサンプル スクリプトを参照してスクリプトを実行します。

try{

    var groupEmail = "demo@domain.com";

 

    sm = new sn_ws.RESTMessageV2('x_avepo_cg_modern.Resolve Group', 'Get ACG Group');

    sm.setStringParameter('data_center_url', gs.getProperty('x_avepo_cg_modern.data_center_url'));

    sm.setStringParameter("gao_api_clientsecret", gs.getProperty('x_avepo_cg_modern.gao_api_clientsecret'));

    sm.setStringParameter("gao_user_name",   gs.getProperty('x_avepo_cg_modern.gao_user_name'));

    sm.setStringParameter("groupemail", groupEmail);

    sm.setRequestBody();

    response = sm.execute();

    var result= response.getBody();

  gs.info("Get group by group email, details is: " + result

} catch (ex) {

    gs.error(ex);

}

3.   スクリプトの実行後、返された id がチーム ID です。

サービス ID

サービス ID は、サービス要求を送信するスクリプトを実行する際に必要です。

サービスのサービス ID を取得するには、以下の説明を参照してください。

1.   以下のエンドポイント URL を使用して ServiceNow の REST メッセージを作成します。

${data_center_url}/services/id?name=${name}

REST メッセージの作成方法については、REST メッセージの作成 内の説明を参照してください。

2.   以下のサンプル スクリプトを参照してスクリプトを実行します。

try{

    var serviceName= "demo change team";

 

    sm = new sn_ws.RESTMessageV2('x_avepo_cg_modern.Get Service Id', 'Get ServiceId By Name');

    sm.setStringParameter('data_center_url', gs.getProperty('x_avepo_cg_modern.data_center_url'));

    sm.setStringParameter("gao_api_clientsecret", gs.getProperty('x_avepo_cg_modern.gao_api_clientsecret'));

    sm.setStringParameter("gao_user_name", gs.getProperty('x_avepo_cg_modern.gao_user_name'));

    sm.setStringParameter("name", serviceName.replaceAll(" ", "%20"));

    sm.setRequestBody();

    response = sm.execute();

    var result= response.getBody();

    var serviceId= response.getBody().replace(/\"/g, '');

    var reg = new RegExp("^[0-9a-z]{8}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{4}-[0-9a-z]{12}$");

    if (serviceId.match(reg) != null && serviceId != "00000000-0000-0000-0000-000000000000") {

        gs.info('Successfully get service id. Service Id: ' + serviceId);

    } else {

        gs.error('Failed to get service id by service name, please check whether your service name is right.Details: ' + serviceId);

    }

} catch (ex) {

    gs.error(ex);

}

3.   スクリプトの実行後、返された serviceId がサービス ID です。