Академический Документы
Профессиональный Документы
Культура Документы
This section lists prerequisites and discusses how to: Activate integrations. Publish initial setup (fullsync) data. Publish incremental setup (sync) data. Use transactional and other services.
Prerequisites
Before you set up integration between General Ledger and other PeopleSoft product applications that involve using IPs: If you are integrating with PeopleSoft HCM products, you must select the HCM product by selectingSet Up Financials/Supply Chain, Install, Installation Options, Products. See Setting Installation Options for PeopleSoft Applications. Read the Integration Broker chapters thoroughly. See Enterprise PeopleTools PeopleBook: Integration Broker Service Operations Monitor Review the Integration Broker chapters to learn how to set up and manage the IB Gateway. See Enterprise PeopleTools PeopleBook: Integration Broker Administration, "Managing Integration Gateways"
Activating Integrations
Follow these steps to activate integrations on your database. You should perform the setup tasks on both the publishing and subscribing databases, unless stated otherwise. Setup task Set up and configure Integration Broker Gateway. (Multiple steps are required to set up the gateway. Please see the PeopleTools PeopleBook for details.) See Enterprise PeopleTools PeopleBook: Integration Broker Administration, "Managing Integration Gateways" Navigation PeopleTools, Integration Broker, Configuration.
PeopleTools, Integration Broker, Integration Setup, Nodes. PeopleTools, Integration Broker, Integration Setup, Service Operations
Activate Service Operation. - Review Service Operation Security - Select active for Handler Status and Routings Provide web service
PeopleTools, Integration Broker, Web Services, Provide Web Service PeopleTools, Integration Broker, Service Operations Monitor, Monitoring, Asynchronous Services or PeopleTools, Integration Broker, Service Operations Monitor, Monitoring, Synchronous Services Set Up Financials/Supply Chain, Common Definitions, Design ChartFields, Combination Editing, Build Combination Data Set Up Financials/Supply Chain, Business Unit Related, General Ledger, Ledgers For A Unit, Journal Edit Options Enterprise Components, Integration Definitions, Initiate Processes, Full Data Publish Set Up HRMS, Install, Installation Table
Build Combination Data with Select checked for the Publish to HRMS/SA.
A ChartField Combo Edit Process Group is added or deleted on the Ledgers For A Unit - Journal Edit Options page. Run the full publish run control to publish the messages. Check General Ledger on the Product tab, then navigate to the Product Specific tab and press the Update Version button. Run the Standard or Advanced ChartField
Setup task Configuration after modifying or adding ChartFields, depending upon the modifications.
Navigation Design ChartFields, Configure, Standard Configuration or Set Up Financials/Supply Chain, Common Definitions, Design ChartFields, Configure, Advanced Configuration
After you have set up your integration system, you are ready to use it by triggering IPs according to your requirements and business events. This table lists setup and transactional IPs for use with General Ledger (PeopleTools, Integration Broker, Integration Setup, Services): Service/Service Operation Queue Operatio n Type Remarks
Setup Integrations: ACCOUNT_CHARTFIELD_FULLSYNC ACCOUNT_CHARTFIELD_SYNC BUS_UNIT_GL_FULLSYNC BUS_UNIT_GL_SYNC BU_LED_COMB_FULLSYNC BU_LED_GRP_FULLSYNC BU_LED_GRP_SYNC LEDGER_DEFN_FULLSYNC LEDGER_DEFN_SYNC BUD_PERIOD_CALENDAR_FULLSYNC BUD_PERIOD_CALENDAR_SYNC DETAIL_CALENDAR_FULLSYNC DETAIL_CALENDAR_SYNC PROJECT_FULLSYNC PROJECT_SYNC PROJECT_STATUS_FULLSYNC PROJECT_STATUS_SYNC PROJECT_ACTIVITY_FULLSYNC PROJECT_ACTIVITY_SYNC BUS_UNIT_AV_FULLSYNC BUS_UNIT_AV_SYNC BUS_UNIT_HR_FULLSYNC BUS_UNIT_HR_SYNC BUS_UNIT_SF_FULLSYNC BUS_UNIT_SF_SYNC JOURNAL_GEN_APPL_ID_FULLSYNC JOURNAL_GENERATOR_APPL_ID_SYNC GL_SETUP One way asynchron ous (Out)
DETAIL_CALENDAR
PROJECTS_SETUP
HR_SETUP
JOURNAL_GENERATOR
One way asynchron ous (Out) Bidirection al asynchron ous One way asynchron ous (Out)
DEPT_FULLSYNC DEPT_SYNC
ENTERPRISE_SETUP
BUS_UNIT_FS_FULLSYNC BUS_UNIT_FS_SYNC ALTACCT_CF_FULLSYNC ALTACCT_CF_SYNC BUDGET_REF_CF_FULLSYNC BUDGET_REF_CF_SYNC BUDGET_SCENARIO_FULLSYNC BUDGET_SCENARIO_SYNC CHARTFIELD1_FULLSYNC CHARTFIELD1_SYNC CHARTFIELD2_FULLSYNC CHARTFIELD2_SYNC CHARTFIELD3_FULLSYNC CHARTFIELD3_FULLSYNC CLASS_CF_FULLSYNC CLASS_CF_SYNC
ENTERPRISE_SETUP
Service/Service Operation
Queue
Operatio n Type
Remarks
FSCM_CF_CONFIG FUND_LOAD FUND_CF_SYNC OPER_UNIT_CF_FULLSYNC OPER_UNIT_CF_SYNC PRODUCT_CHARTFIELD_FULLSYNC PRODUCT_CHARTFIELD_SYNC PROGRAM_CF_FULLSYNC PROGRAM_CF_SYNC SCHEDULE_FULLSYNC SCHEDULE_SYNC FSCM_CF_CONFIG Note. With FSCM_CF_CONFIG, financials Standard ChartField Configuration is supported and can be published to HCM release HR89 from release FSCM90. Details of the standard ChartField configuration will be available only if the process completes successfully. PeopleSoft Financials will issue a warning if you attempt an Advanced Configuration action and PeopleSoft HCM is enabled on the Installed Product page. HCM supports only standard configuration. RELEASE_REQUEST RELEASE_RESPONSE ENTERPRISE_SETUP One way asynchron ous (Out) Publish of standard ChartField configuration and log information after the Standard ChartField configuration process completes successfully.
Synchrono us
Release_Request and Release_Response acts as a set of Synchronized messages to send FSCM version information to HCM when requested. Launch from SpeedType page.
HR_CHARTFLD_COMBO_SYNC
HR_CHARTFLD_COMBO
Transactional Integrations: HR_ACCT_CD_LOAD ENTERPRISE_SETUP One way asynchron ous (Out) Launch from the Combination Build process request. Extract selected data from the ChartField combination data table. Transforms and publishes the data in the PeopleSoft HCM Account Code format. HCM North America Payroll. See Note #1.
PAYROLL_ACCTG_TRANSACTION
PAYROLL_ACCTG_TRANSACTION
GP_POST_GL
GP_POST_GL
STUDENT_ADV_ACCTG_LINE STUDENT_FIN_ACCTG_LINE
STUDENT_ADMIN_ACCOUNTING
Service/Service Operation
Queue
Remarks
LM_ACCTG_LN
LM_ACCTG_ENTRY
(ELM) Enterprise Learning Management. See Note #1. Generic accounting entry for demo and users customization. Commitment Control budget journals. Budget checking for commitment control transactions. Works with the Ledger Load process to move ledger data from regional GL to headquarter GL database for consolidation. XBRL instance creation. See Note #2. Combo edit request service calls the combo edit online validation logic. Uses the Service AliasCFComboEdit, and the Operation Alias CFComboEditReq. Request/response pair that provides real-time budget checking for PeopleSoft HR encumbrance transactions. This could be used as a model for third party applications. See PeopleSoft Enterprise Human Resources 9.1 PeopleBook: Manage Commitment Accounting Request/response pair that provides real-time budget checking for PeopleSoft HR expense transactions. This
JOURNAL_LOAD_TEMPLATE
JOURNAL_LOAD_TEMPLATE
COMMIT_CNTRL_BUDGET_UPDATE
COMMIT_CNTRL_BUDGET_UPDAT E
One way asynchron ous (In) Bidirection al asynchron ous Bidirection al asynchron ous
COMMIT_CNTRL_TRAN_CHECK_UPDATE
COMMIT_CNTRL_TRAN_CHECK_U PDATE
LEDGER_LOAD
LEDGER
XBRL_ASYNC
XBRL
COMBO_CF_EDIT_REQUEST
GL_BUDCHECK_ENC_TRANSACTIONS PAYROLL_KK_ENCUMBER_RESPONSE
GL_BUDGETCHECK
GL_BUDCHECK_EXP_TRANSACTIONS PAYROLL_KK_EXPENSE_RESPONSE
GL_BUDGETCHECK
Service/Service Operation
Queue
Operatio n Type
Remarks
could be used as a model for third party applications. See PeopleSoft Enterprise Human Resources 9.1 PeopleBook: Manage Commitment Accounting GL_BUDCHECK_PAYROLL_REALTIME GL_BUDGETCHECK Synchrono us Synchronous (realtime ) budget check of encumbrance transactions from HCM (such as hiring transactions). Used in conjunction with the options that are set in HCM. See PeopleSoft Enterprise Human Resources 9.1 PeopleBook: Manage Commitment Accounting Provides realtime budget checking for PeopleSoft HR or any third party applications. Used specifically for integration with PeopleSoft HCM to call the Budget Check Only feature (budget pre-check) for HCM transactions against commitment control budgets. GL Actuals and Standard Budget Journal Email Approval
GL_BUDGETCHECK
Synchrono us
GL_BUDCHK_CHECKWITHOUTRESERVE
GL_BUDGETCHECK
Synchrono us
JRNL_AF_EM_APPROVAL
GL_EM_APPROVAL
Note. #1General Ledger subscribes to these accounting entries and writes the entries to their corresponding accounting tables. When you run Journal Generator, it sends back the accounting message with the updated fields. Please check with the individual products to determine whether they use this service from General Ledger. Note. #2The target node is typically an external node that accepts and handles XBRL documents. See Also Enterprise PeopleTools PeopleBook: Integration Broker, "Sending and Receiving Messages" Understanding PeopleSoft Commitment Control Using XBRL to Produce Balance Sheets and Income Statements
Accounting Entry Service Accounting entries are generated in each PeopleSoft subsystem application and then published to General Ledger. Some of them use the Batch Data Publish utility while others have their specific procedures to publish. Please refer to the application PeopleBooks on how to publish data from the subsystems. After receiving the accounting entries, you run Journal Generator to create journal entries in General Ledger. Journal Generator updates the accounting table and publishes the updated data back to PeopleSoft subsystem applications over the same IP on which it receives accounting entries. Fields that are updated by Journal Generator include Journal ID, Journal date, Journal line number, Fiscal year, Accounting period, and GL_distrib_status. Please check with the individual PeopleSoft subsystem products to determine whether they use this update service from General Ledger. Commitment Control Budget Update Service These steps describe how commitment control budget update messaging works. 1. For example, HCM Northern Payroll enters and generates commitment control budget data and sends it to General Ledger using the COMMIT_CNTRL_BUDGET_UPDATE service. 2. Upon receiving the request message, the subscription process runs automatically and updates the budget journal tables, and then initiates the FS_BP budget posting process to update the commitment control ledgers. See Entering and Posting Commitment Control Budget Journals. Realtime Budget Checking for HCM and Third Party Applications The main purpose of realtime budget checking is to alert the user at transaction time within the HCM application whether there are sufficient funds available (for example, at the time of hiring, transfer, or salary changes). The option to enforce the valid budget check prior to saving a transaction resides within HCM setup. General Ledger provides realtime budget checking of position data from PeopleSoft HCM. Requisitions for positions are validated against budgetary rules in the Financials database and recorded as Pre-Encumbrances. Position offers are booked as Encumbrances. Position data changes, such as bonuses and salary changes, are validated and booked against the budget appropriately. Request services invoke the budget processor and response services send validation or error messages to HCM, which can be viewed (and corrected or overridden) through the HR Enc Exceptions page or the HR Exp Exceptions page. This provides immediate feedback to the user with a link from HCM directly into the Commitment Control Inquiry or Exceptions (if setup and security is enabled). To implement realtime budget checking, complete the following: 1. Activate the services that are listed for the GL_BUDGETCHECK queue. See Activating Integrations. 2. For non-PeopleSoft applications, complete the Service Configuration page (Integration Broker, Configuration, Service Configuration). 3. Make sure that the application server is active (Integration Broker, Configuration, Quick Configuration). 4. Add the HR node to the single sign-on for FMS (PeopleTools, Security, Security Objects, Single Signon). 5. Specify for each source transaction type whether overrides are allowed , disallowed, or automatic. You can, therefore, enable or disable the automatic overrides in payroll and other transactions. See PeopleSoft Enterprise Human Capital Management PeopleBook: Manage Commitment Accounting HCM Account Code Integration HCM maintains its account code table with data from the Financials ChartField combination data table and the Financials SpeedTypes. HCM uses account codes extensively in its systems to represent a combination of ChartField values. Do not confuse these account codes with the account ChartField in Financials. Financial users access the Build Combination Data page to initiate the build process and to publish ChartField combination data to HCM and Learning Solutions using the HR_ACCT_CD_LOAD service. A service operation publishes data from a selected process group and sends it to HCM to convert it into its account codes. For further details, please read the HCM documentation on account codes.
See PeopleSoft Enterprise Human Resources 9.1 PeopleBook: Manage Commitment Accounting, "Setting Up Commitment Accounting Processing Control Tables" When you add or update a user SpeedType and you selected the Publish check box, the ChartField combinations of that SpeedType publish to HCM and convert to their account code. Note. You use the Publish Data check box to control whether to send the ChartField values of the new or updated SpeedType to PeopleSoft HRMS, which uses the SpeedType to update its Account Code table. The check box is visible and available if the SpeedType is a user SpeedType and the HCM installation option is selected. If the check box is visible but unavailable for entry on the page, the service HR_CHARTFIELD_COMBO_SYNC is not activated. When available, this check box is always deselected by default. This option is not part of the SpeedType data and thus is not saved with your SpeedType definition. See Also Understanding ChartField Combination Editing Understanding PeopleSoft Commitment Control
The batch import method requires that you write the data to a file, submit and upload one or more files through the browser, and then initiate the Spreadsheet Journal Batch Import process (GL_EXCL_JRNL) to process the import.
Importing Information to a Ledger Using the Flat File Ledger Process (GL_LED_IMP)
In addition to using publish and subscribe to import ledgers, you can also import data using the Flat File Ledger Import process (GL_LED_IMP) to import standard detail ledgers and standard budgets ledgers. See Also Importing and Exporting Ledgers
Integrating PeopleSoft Financials with Third-party Applications Using Generic Process Initiation Service
PeopleSoft Financials provides a generic process initiation web service, PROCESS_INITIATION, which enables third-party applications to launch any PeopleSoft processes for any of the Financials products, such as PeopleSoft General Ledger, Payables, Receivables, Billing, or Asset Management, for example. The following diagram represents the integration process flow:
PeopleSoft delivers the following as part of the generic process initiation integration between third-party applications and PeopleSoft Financials (PeopleTools 8.51):
Generic process initiation Asynchronous Request/Response Web Service, PROCESS_INITIATION, which can be invoked to initiate any PeopleSoft process. The PROCESS_INITIATION web service utilizes PeopleTools 8.51 Process Status Notification Service, PRCS_STATUS_NOTIFY, to retrieve the process status and deliver the response to the third-party application with notification of process completion. The response xml includes the URL link(s) to the location of any report files that are created by the process. Note. PeopleSoft does not deliver routings for this Process Status Notification Service. A Local-to-Local Routing for its Service Operation, PRCS_STATUS_OPER, must be generated manually.
Request and Response messages with Schema: Request Message, PROCESS_SUBMIT_REQ.V1 with Schema Response Message, PROCESS_SUBMIT_RES.V1 with Schema
Note. The objects related to this service are delivered as inactive and must be activated in order to use this integration. See Activating the Objects for the PeopleSoft Integration for Third-Party Applications. Request Message The following graphic represents the schema for the request message, PROCESS_SUBMIT_REQ.V1:
The following three parameters are required in the request xml: Process Type of the defined PeopleSoft process (maximum length = 30 characters) Process Name of the defined PeopleSoft process (maximum length = 12 characters) Run Control ID (must be predefined for that process) See Examples of PeopleSoft Processes Initiated Using the Generic Process Initiation Service for Third-Party Integration. Note. You can review the schema content by accessing PeopleTools, Integration Broker, Integration Setup, Messages, Schema. Response Message The Response Message, PROCESS_SUBMIT_RES.V1, returns: Original three request parameters. Process description. Run status (failure or success). Message (from message log). Run Status Code (Process Run Status value, not the meaningful translation value). Process instance and Content ID. Report URL (link to Report Manager to view resulting report), if applicable.
Note. The Run Status Code, Process Instance, Content ID, and Report URL are only included if they have values.
Examples of PeopleSoft Processes Initiated Using the Generic Process Initiation Service for Third-Party Integration
This section lists some examples of PeopleSoft Financials processes that can be initiated using the generic process initiation service through this integration. Other processes can also be initiated using this web service, as long as the required three parameters are included in the request xml. Area Process Name Navigation Required Parameters Process Type: Application Engine Process Name: AM_DEPR_CALC Run Control ID: (predefined value) Process Type: Application Engine Process Name: AM_AMAEDIST Run Control ID: (predefined value) Process Type: Application Engine Process Name: AM_DPCLOSE Run Control ID: (predefined value) Process Type: PSJob Process Name: APY1400 Run Control ID: (predefined value) Process Type: Application Engine Process Name: FS_PEACCRL Run Control ID: (predefined value) Process Type: SQR Report Process Name: AR30006 Run Control ID: (predefined value) Process Type: PSJob Process Name: BIJOB05 Run Control ID: (predefined value) Process Type: PSJob Process Name: BIJOB06 Run Control ID: (predefined value) Process Type: Application Engine Process Name: GL_JEDIT Run Control ID: (predefined value) Process Type: SQR Report Process Name: GLS7012
Asset Managemen t
Asset Managemen t
Asset Managemen t
Payables
Payables
Accounts Payable, Batch Processes, Vouchers, Period End Accrual, Create Period End Accruals
Receivables
Billing
Billing
General Ledger
General Ledger
Area
Process Name
Navigation
General Ledger
Process Type: Application Engine Process Name: FS_ALLC Run Control ID: (predefined value) Process Type: COBOL SQL Process Name: GLPOCONS Run Control ID: (predefined value) Process Type: Application Engine Process Name: GL_RECN Run Control ID: (predefined value) Process Type: Application Engine Process Name: FS_JGEN Run Control ID: (predefined value)
General Ledger
General Ledger
General Ledger
Note. The aforementioned PeopleSoft Financials processes were successfully tested for the delivered web service.