アクティブなデータベース・アウトライン内で、指定された名前のドリルスルーURLを更新します。
ドリルスルーURLの制限を参照してください。
構文
ESS_FUNC_M EssUpdateDrillThruURL (
hCtx, ESS_PDURLINFO_T pUrl
);
| パラメータ | データ型 | 説明 |
|---|---|---|
hCtx |
ESS_HCTX_T |
APIコンテキスト・ハンドル。 |
pUrl |
ESS_PDURLINFO_T |
URL定義。 |
bMerge |
ESS_BOOL_T |
|
戻り値
正常に処理されると、URL XMLの置換と、pUrl内の対応するフィールドによるドリルスルー領域のリストの更新または置換によって、アクティブなデータベース内の指定されたドリルスルーURLが更新されます。
指定された名前のURLが存在しない場合は、エラー・コードが戻されます。
アクセス
呼出し側は、指定したデータベースに対してデータベース設計権限(ESS_PRIV_DBDESIGN)を持っている必要があります。
呼出し側はEssSetActiveを使用して、指定したデータベースをアクティブ・データベースとして選択しておく必要があります。
例
/* Sample Code for EssUpdateDrillThruURL */
ESS_STS_T sts = ESS_STS_NOERR;
ESS_DURLINFO_T url;
ESS_PDURLINFO_T urlInfo;
ESS_STR_T fileName = "";
ESS_CHAR_T xmlString[XML_CHAR_MAX];
ESS_BOOL_T bMerge;
ESS_USHORT_T i;
memset(&url, '\0', sizeof(ESS_DURLINFO_T));
fileName = "F:\\testarea\\mainapi\\sample1.xml";
GetFileContent(fileName, xmlString);
/* Update URL*/
url.bIsLevel0 = ESS_TRUE;
url.cpURLName = "Drill Through to EPMI";
url.cpURLXml = xmlString;
url.iURLXmlSize = (ESS_SHORT_T) strlen(xmlString)+1;
url.iCountOfDrillRegions = 1;
sts = EssAlloc (hInst, sizeof(ESS_STR_T) * url.iCountOfDrillRegions, &(url.cppDrillRegions));
/* With bMerge = ESS_FALSE, update Drill Regions */
bMerge = ESS_FALSE; // replace
url.cppDrillRegions[0] = "Mar";
sts = EssUpdateDrillThruURL(hCtx, &url, bMerge);
printf("EssUpdateDrillThruURL sts: %ld\n",sts);