EssBuildDimension

データ・ファイルまたはルール・ファイルに対して、アクティブなデータベースのアウトラインのメンバーに関する追加または削除を実行します。

構文

            ESS_FUNC_M EssBuildDimension (
            hCtx, rulesObj, dataObj,
mbrUser, ErrorName
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
pRulesObj	ESS_OBJDEF_T	ルール・ファイル・オブジェクト定義構造体へのポインタ。
pDataObj	ESS_OBJDEF_T	データ・ファイル・オブジェクト定義構造体へのポインタ。
pMbrUser	ESS_MBRUSER_T	SQLユーザー構造体(データ・ソースがSQLデータベースの場合)。SQLユーザー構造体がNULLの場合は、SQL以外のデータ・ソースを示します。
ErrorName	ESS_STR_T	クライアントでのエラー出力ファイルの名前。

備考

MbrUserがNULL以外の場合、SQLデータ・ソースとみなされます。
データ・ソースのインポートについては、EssImportを参照してください。
データベースは、アクティブ・データベースである必要があります。EssSetActiveを参照してください。

戻り値

なし。

アクセス

この関数を使用するには、呼出し元が、指定したデータベースに対するデータベース・デザイン権限(ESS_PRIV_DBDESIGN)を持っている必要があります。

例

         ESS_FUNC_M
ESS_BuildDim(ESS_HCTX_T hCtx)
{
   ESS_FUNC_M    sts = ESS_STS_NOERR;
   ESS_OBJDEF_T  RulesObj;
   ESS_OBJDEF_T  DataObj;
   ESS_MBRUSER_T User;                   
   ESS_STR_T     ErrorName;
   
   RulesObj.hCtx     = hCtx;
   RulesObj.FileName = "Prodmap";         
   RulesObj.ObjType  = ESS_OBJTYPE_RULES;  
   
   DataObj.hCtx      = hCtx;
   DataObj.FileName  = "Prodtabl";         
   DataObj.ObjType   = ESS_OBJTYPE_TEXT;    
    
   ErrorName         = "builddim.err";
   
   sts               = EssBuildDimension (hCtx, &RulesObj, &DataObj,  
                       NULL, ErrorName);
   return (sts);
   /*******************************************************************/
   /*                                                                 */
   /* When a SQL data source is defined in the rules file, define     */
   /* the variables in the ESS_OBJDEF_T DataObj structure as follows: */
   /*    DataObj.hCtx     = hCtx;                                     */
   /*    DataObj.AppName  = NULL;                                     */
   /*    DataObj.DbName   = NULL;                                     */
   /*    DataObj.ObjType  = ESS_OBJTYPE_NONE;                         */
   /*    DataObj.FileName = NULL;                                     */
   /*                                                                 */
   /* Also, provide strings for the variables in the ESS_MBRUSER_T    */
   /* User structure; for example:                                    */
   /*    User.User     = "Dbusernm";                                  */
   /*    User.Password = "Dbpasswd";                                  */
   /*                                                                 */
   /* Use a blank string for User and Password, if the SQL source     */ 
   /* does not require user and password information; for example:    */
   /*    User.User     = "";                                          */
   /*    User.Password = "";                                          */
   /*                                                                 */
   /* Also, define sts as follows:                                    */
   /*    sts =  EssBuildDimension (hCtx, &RulesObj, &DataObj,         */
   /*           &User, ErrorName);                                    */
   /*                                                                 */
   /*******************************************************************/ 
}