appinterface.h

Go to the documentation of this file.

/*==============================================================================
                Copyright (c) 2003-2005 UGS Corporation
                   Unpublished - All Rights Reserved
 ==============================================================================*/

/*  */

#ifndef APPINTERFACE_H
#define APPINTERFACE_H

#include <unidefs.h>
#include <pie/pie.h>

#include <ai/libai_exports.h>

#define AppInterface_class_name_c                   "AppInterface"
#define MasterRecord_class_name_c                   "MasterRecord"
#define RequestObject_class_name_c                  "RequestObject"
#define RecordObject_class_name_c                   "RecordObject"

#define AppInterfaceType_class_name_c "AppInterfaceType"
#define AppInterface_private_structure_type_name_c  "PrivateContext"
#define AppInterface_private_appgrp_type_name_c     "PrivateAppGrp"
#define AppInterface_vis_structure_type_name_c  "VisStructureContext"

#define TC_link_ic_relation_name                  "IMAN_eco_link"

#define AI_id_size_c                                WSO_desc_size_c
#define AI_msg_size_c                               WSO_desc_size_c

#define AI_request_no_dependancy                    "AI_request_no_dependancy"

#define AI_max_app_ref_string                       240

#define AppInterfaceType_idc_type_name_c  "IntermediateDataCapture"
typedef enum Request_type_e
{
    Request_type_publish =0,
    Request_type_sync    =1,
    Request_type_any     =2
} Request_type_t;

typedef enum Request_status_e
{
    Request_status_normal  =0,
    Request_status_warning =1,
    Request_status_severe  =2,
    Request_status_abort   =3,
    Request_status_any     =4
} Request_status_t;

typedef enum Request_state_e
{
    Request_state_new           =0,
    Request_state_processing    =1,
    Request_state_pending       =2,
    Request_state_communicating =3,
    Request_state_completed     =4,
    Request_state_rejected      =5,
    Request_state_any           =6
} Request_state_t;

typedef enum Request_scope_e
{
    Request_scope_whole     =0,
    Request_scope_partial   =1,
    Request_scope_any       =2
} Request_scope_t;

typedef enum Request_update_e
{
    Request_update_full     =0,
    Request_update_delta    =1,
    Request_update_any      =2
} Request_update_t;

typedef struct AI_search_criteria_s
{
    char       name[WSO_name_size_c+1];
    char       desc[WSO_desc_size_c+1];
    char       type[WSO_name_size_c+1];
    tag_t      owner;
    tag_t      group;

    date_t     createdBefore;
    date_t     modifiedBefore;
    date_t     releasedBefore;

    date_t     createdAfter;
    date_t     modifiedAfter;
    date_t     releasedAfter;

    char       context[AI_id_size_c+1];
    char       site_id[AI_id_size_c+1];
    char       project_id[AI_id_size_c+1];

} AI_search_criteria_t, *AI_search_criteria_p_t;

#ifdef __cplusplus
    extern "C"{
#endif

extern AI_API int AI_init_module();

extern AI_API int AI_create_instance(
    const char*    type,    
    const char*    name,    
    const char*    desc,    
    tag_t*         ai       
    );

extern AI_API int AI_export_objects(
    tag_t          ai,      
    int            num,     
    tag_t*         objects, 
    logical        partial  
    );
extern AI_API int AI_export_objects_incremental(
    tag_t          ai,      
    int            num,     
    tag_t*         objects, 
    logical        partial  
);
extern AI_API int AI_can_add_request(
    tag_t          ai,      
    Request_type_t type,    
    logical*       ok       
    );

extern AI_API int AI_create_request(
    tag_t          ai,      
    const char*    name,    
    const char*    desc,    
    Request_type_t reqType, 
    tag_t*         req      
    );

extern AI_API int AI_ask_request_objects(
    tag_t           ai,     
    Request_type_t  type,   
    Request_state_t state,  
    int*            num,    
    tag_t**         req     
    );

extern AI_API int AI_ask_next_request(
    tag_t           ai,         
    tag_t           cur_req,    
    Request_type_t  type,       
    Request_state_t state,      
    tag_t*          req         
    );

extern AI_API int AI_remove_request_object(
    tag_t          ai,      
    tag_t          req      
    );

extern AI_API int AI_find(
    AI_search_criteria_t* seach,    
    int*                  num,      
    tag_t**               ais       
    );

extern AI_API int AI_init_search(
    AI_search_criteria_t* seach     
    );

extern AI_API int AI_ask_transfermode(
    tag_t           ai,     
    PIE_direction_t type,   
    tag_t*          tm      
    );

extern AI_API int AI_set_transfermode(
    tag_t           ai,     
    PIE_direction_t type,   
    tag_t           tm      
    );

extern AI_API int AI_ask_master_record(
    tag_t          ai,  
    tag_t*         ma   
    );

extern AI_API int AI_set_master_record(
    tag_t          ai,  
    tag_t          ma   
    );

extern AI_API int AI_ask_base_refs(
    tag_t          ai,      
    int*           num,     
    tag_t**        refs     
    );

/*****************************************************************************
    * Description
    *   Set the input tags to base references ( the root objects used by this interface)
    *   If the tags are run time configured objects such as BOMLine, we need to
    *   persistant it.
    *
    *   If multiple BOMLines are input, we will just create one single private StructureContext
    *
    *   Note: it will reset the previous baserefs.
    *
    * Input:
    *   ref - tag of reference
    * Output:
    *
    *
    * Returns:
    *   status_t
    *
    * Side Effects:
    *   see Description
    *
    *****************************************************************************/
extern AI_API int AI_set_base_refs(
    tag_t          ai,      
    int            num,     
    tag_t*         refs     
    );

extern AI_API int AI_add_base_ref(
    tag_t          ai,      
    tag_t          ref      
    );

/*****************************************************************************
    * Description
    *   Add the input tags to base references ( the root objects used by this interface)
    *   If the tags are run time configured objects such as BOMLine, we need to
    *   persistant it.
    *
    *   If multiple BOMLines are input, we will just create one single private StructureContext
    *
    * Input:
    *   ref - tag of reference
    * Output:
    *
    *
    * Returns:
    *   status_t
    *
    * Side Effects:
    *   see Description
    *
    *****************************************************************************/
extern AI_API int AI_add_base_refs(
    tag_t          ai,      
    int            num,     
    tag_t*         refs,     
    int*            persistNum,  
    tag_t**        persistObj   
    );

extern AI_API int AI_ask_site_id(
    tag_t          ai,                  
    char           id[AI_id_size_c+1]   
    );


extern AI_API int AI_ask_site_id2(
    tag_t          ai,                  
    char           **id                 
    );

extern AI_API int AI_set_site(
    tag_t          ai,      
    tag_t          site     
    );

extern AI_API int AI_ask_app_id(
    tag_t          ai,                  
    char           id[AI_id_size_c+1]   
    );

extern AI_API int AI_ask_app_id2(
    tag_t          ai,                  
    char           **id                 
    );

extern AI_API int AI_ask_project_id(
    tag_t          ai,                  
    char           id[AI_id_size_c+1]   
    );

extern AI_API int AI_ask_project_id2(
    tag_t          ai,                  
    char           **id                 
    );

extern AI_API int AI_set_project_id(
    tag_t          ai,  
    const char*    id   
    );

extern AI_API int AI_ask_master_file(
    tag_t          ai,  
    tag_t*         mf   
    );

extern AI_API int AI_set_master_file(
    tag_t          ai,  
    tag_t          mf   
    );

extern AI_API int AI_request_process(
    tag_t          req,     
    tag_t          eco      
    );

extern AI_API int AI_request_can_process(
    tag_t          req,     
    logical*       ok       
    );

extern AI_API int AI_request_process_partial(
    tag_t          req,         
    int            num_obj,     
    tag_t*         objs         
    );

extern AI_API int AI_request_ask_type(
    tag_t          req,     
    int*           type     
    );

extern AI_API int AI_request_ask_scope(
    tag_t          req,     
    int*           scope    
    );

extern AI_API int AI_request_set_scope(
    tag_t           req,    
    Request_scope_t scope   
    );

extern AI_API int AI_request_ask_update_type(
    tag_t          req,     
    int*           update   
    );

/*Set for update type, which is Full/Delta*/
extern AI_API int AI_request_set_update_type
(
    tag_t             req,    
    Request_update_t  update  
);

extern AI_API int AI_request_ask_state(
    tag_t          req,     
    int*           stat     
    );

extern AI_API int AI_request_set_state(
    tag_t           req,    
    Request_state_t stat    
    );


extern AI_API int AI_request_ask_state_msg(
    tag_t          req,                         
    char           stat_msg[AI_msg_size_c+1]    
    );


extern AI_API int AI_request_ask_state_msg2(
    tag_t          req,                         
    char           **stat_msg                   
    );

extern AI_API int AI_request_set_state_msg(
    tag_t          req,         
    const char*    stat_msg     
    );

extern AI_API int AI_request_ask_status(
    tag_t          req,     
    int*           stat     
    );

extern AI_API int AI_request_set_status(
    tag_t            req,   
    Request_status_t stat   
    );


extern AI_API int AI_request_ask_status_msg(
    tag_t          req,                         
    char           stat_msg[AI_msg_size_c+1]    
    );


extern AI_API int AI_request_ask_status_msg2(
    tag_t          req,                         
    char           **stat_msg                   
    );

extern AI_API int AI_request_set_status_msg(
    tag_t          req,         
    const char*    stat_msg     
    );

extern AI_API int AI_request_ask_structure_file(
    tag_t            req,       
    Request_update_t type,      
    tag_t*           file       
    );

extern AI_API int AI_request_set_structure_file(
    tag_t            req,       
    Request_update_t type,      
    tag_t            file       
    );

extern AI_API int AI_request_ask_process_by(
    tag_t          req,     
    tag_t*         user     
    );

extern AI_API int AI_request_ask_process_on(
    tag_t          req,     
    date_t*        date     
    );

extern AI_API int AI_request_ask_owning_ai(
    tag_t          req,     
    tag_t*         owner    
    );

extern AI_API int AI_request_add_file_map(
    tag_t          req,         
    const char*    fileRef,     
    const char*    fileId       
    );

extern AI_API int AI_request_import_file(
    tag_t          req,         
    const char*    fName,       
    const char*    fRefId,      
    int            fileType,    
    const char*    appName,     
    const char*    siteId,      
    const char*    version,     
    tag_t*         fileTag      
    );

extern AI_API int AI_save_records(
    tag_t          ai   
    );

extern AI_API int AI_add_record(
    tag_t          ai,          
    const char*    objId,       
    const char*    masterId,    
    date_t         date,        
    tag_t*         record       
    );

extern AI_API int AI_ask_record(
    tag_t          ai,      
    const char*    objId,   
    tag_t*         record   
    );

extern AI_API int AI_remove_record(
    tag_t          ai,      
    const char*    objId    
    );

extern AI_API int AI_is_object_modified(
    tag_t          ai,          
    const char*    objId,       
    date_t         modDate,     
    logical*       modified     
    );

#ifdef __cplusplus
    }
#endif

/* ----------------------------------------------------------------------------------
                AppInterface Type related
-------------------------------------------------------------------------------------*/

/*****************************************************************************
* Description
*   Finds an AppInterface Type with specified name
*
* Input:
*   name - Name of new AIType
*
* Output:
*   typeTag - Tag of AIType
*
* Returns:
*
* Side Effects:
*   see Description
*
*****************************************************************************/
extern AI_API int AIType_find
(
    const char   *name,          /* (I) */
    tag_t        *type           /* (O) */
);

/*****************************************************************************
* Description
*   Returns isUsedForIDC logical flag on AppInterface type.
*
* Input:
*   aitype - AppInterface Type object tag
*
* Output:
*   status - TRUE/FALSE
*
* Returns:
*
* Side Effects:
*   see Description
*
*****************************************************************************/
extern AI_API int AIType_ask_is_used_for_idc
(
    tag_t        aitype,          /* (I) */
    logical*     status           /* (O) */
);

/*********************************************************************************
    Utility Funtion
**********************************************************************************/
/*****************************************************************************
* Description
*   Utility funtion to validate the PLMXML file, given a checking data file.
*   It will be able to check:
*       1) Total number of element:                Element ; Occurrence; 100
*       2) Total Number of attribute:              Attribute ; Occurrence ; linkedOccurrenceRef; 23
*       3) Check whether has require attribute:    Required ; Occurrence ; instancedRef
*
*   If any checking failes, will return failure. Checking result will be print to the log file
*
* Input:
*    char* plmxml_file,        PLMXML file full name
*    char *custom_fptr,        Customization file which contains the checking info
*    char *log_fptr,           Log file
*
*
* Output:
*    write the result to the log file
*    logical* failed     check failed or not
* Returns:
*
* Side Effects:
*   see Description
*
*****************************************************************************/

extern AI_API int AI_validate_plmxml
(
    char* plmxml_file,   /* (I) */
    char *custom_fptr,      /* (I) */
    char *log_fptr,      /* (I) */
    logical* failed       /* (O) */
);
extern AI_API int AI_request_find_by_ai_type(
    Request_type_t req_type, /* (I) */
    Request_state_t  state,  /* (I) */
    const char* ai_type,     /* (I) */
    int*  num,            /* (O) */
    tag_t **reqs             /* (OF) */
);

#include <ai/libai_undef.h>

#endif