About this Product
What's New in This Release
TIBCO® Order Management Installation and Configuration Guide
Installation Overview
Operating System and Database Requirements
Required Products
Required Third-Party Jars
Required TIBCO Products
TIBCO Environment
Installation Scenarios
Installation Environment Variables
Installation and Deployment Options
Post-Installation Tasks
Post-Installation Task 1: Copying Dependencies
Post-Installation Task 2: Creating the Database
Creating an Oracle Database for the Admin User
Creating an Oracle Database for the Order Capture System
Creating an Oracle Database for the Archival Service
Creating a PostgreSQL Database for the Admin User
Creating a PostgreSQL Database for the Order Capture System
Creating a PostgreSQL Database for the Archival Service
Creating an Oracle Database for Catalog
Creating an Oracle Database for Jeopardy
Creating an Oracle Database for Order
Creating a PostgreSQL Database for Catalog
Creating a PostgreSQL Database for Jeopardy
Creating a PostgreSQL database for Order
Creating an Oracle database for Orch in case of Redis
Creating a PostgreSQL database for Orch in case of Redis
Post-Installation Task 3: Creating the TIBCO Enterprise Message Service Channel
Post-Installation Task 4: Integrating with TIBCO Fulfillment Subscriber Inventory
Post Installation Task 5: Integrating with TIBCO Offer and Price Engine Service
Post Installation Task 6: Creating Applications and Stores for TIBCO Order Management on FTL
Post-Installation Task 7: Configuring the Installation
Configuring the Database and Messaging Through Configurator
Configuration Properties
Configuring the Order Capture System Properties
Configuring the Jeopardy Service Properties
Post-Installation Task 8: Starting or Restarting the Services
Deployment of TIBCO Order Management on Kubernetes
Migrating orders from TIBCO Order Management - Long Running 5.0.0 HF2 to TIBCO Order Management 5.1.0
Installation FAQs and Troubleshooting
TIBCO® Order Management Getting Started
Use Case Submitting an Order
Create Products by using TIBCO Product and Service Catalog
Logging in to TIBCO Product and Service Catalog
Creating the START-END Milestone Pair
Creating Plan Fragments for Products
Creating the Products
Creating the Product Bundle
Publishing the Products and Making the Products Available
Starting the Test Harness
Submitting Order and Retrieving Order Reference by using SOAP UI
Submitting Order and Retrieving Order Reference by using REST service
Searching for Orders by using Order Reference
Viewing the Execution Plan
Viewing the Gantt Chart to Confirm Fulfillment of Order
Use Case Amending an Order
Create Products by using TIBCO Product and Service Catalog
Logging in to TIBCO Product and Service Catalog
Creating the START-END Milestone Pair
Ways to Create Plan Fragments for Products
Creating Plan Fragments for Products
Creating the Products
Creating the Product Bundle
Publishing the Products and Making the Products Available
Starting the Test Harness
Submitting Order and Retrieving Order Reference by using SOAP UI
Submitting Order and Retrieving Order Reference by using REST service
Searching for Orders by using Order Reference
Viewing the Execution Plan
Viewing the Gantt Chart to Confirm Fulfillment of Order
Submitting Order Amendment by Changing the Original Order
Searching the Amended Order by using the Order Reference
Viewing the Execution Plan of Amended Order
Viewing the Gantt Chart to Confirm Fulfillment of Amended Order
TIBCO® Order Management Concept and Architecture Guide
Introduction
About TIBCO Order Management
TIBCO® Fulfillment Orchestration Suite Overview
TIBCO Fulfillment Orchestration Suite Components
User Interface Integration
TIBCO® Order Management Overview
Basic Order Management Concepts
Order
Characteristics
Product
Plan
Plan Item
Milestone
Dependency
Plan Fragment
Error Handling
SLA Notification
Plan Development
Lifecycle
Order
Order Line
Order Amendment
Plan
Plan Item
Milestone
Dependency
Sequences
Standard Order
Successful Completion
Feasibility Failed
Plan Development Failed
Plan Item Execution Failed
Amend Order Fulfillment
Before Plan Creation
Amend Order Fulfillment
Cancel Order
Architecture
Orchestrator
Automated Order Plan Development
Order Capture System
Process Components
Feasibility Provider
Key Functionality
TIBCO® Order Management Administration
Deployment
Recommended Setup for a TIBCO Order Management Development Environment
Microservices
Pre Deployment Configuration
Components Deployment
Automated Order Plan Development Deployment
Archival Service Deployment
Authorization Service Deployment
Catalog Service Deployment
Configurator Deployment
Data Service Deployment
Encrypt Password Utility
Order Capture System Deployment
Order Migration Service Deployment
Order Management Server UI Deployment
Orchestrator Service Deployment
TM Forum Adapter Deployment
Process Component Deployment
Jeopardy Deployment
Connecting TIBCO Order Management to TIBCO® EMS Server with SSL Enabled
Configuring SSL for TIBCO Order Management
Configuration
Queue Management
Data Models
Model Loading Process
Online Model Loading
Catalog Web Service Model Loading
Offline Model Loading
Order Management System Configuration
User Interface Configuration
URL to Access Order Management System UI Component
Target Parameters for Order Management System UI
Additional Parameters for Order Management Server UI
Multi-Tenancy Configuration
Managing Application Security
Managing Users and Roles
Authorization Service
Create and Modify User
Get User
Delete User
Generating an authorization token
Collecting Order Summary Data
Audit Trail
Enabling Internal Error Handler Support
Order Capture System Configuration
Order Capture System External Component Configuration
Order Service Web Service Configuration
Subscriber Inventory Web Service Configuration
Eligibility and Pricing Web Service Configuration
Order Plan Preview Configuration
Messaging Configuration
Authorization Server Configuration
Pooled Database Source Configuration
Admin Data Source Configuration
Multi-Tenancy Configuration
Security Configuration
Catalog Directory Configuration
Offer and Price Engine Common Configuration
Log File Configuration
Logging
How Logging Works
Contents of the Log Message
Controlling Log Levels
Configuring Logging for Java Components
Administration Tasks
Swagger API Reference
Swagger UI
Invoking an Operation
Generating a Swagger JSON File
Overview of the Swagger JSON File
Sample Swagger JSON File
Docker
Building a Docker Image Without an Internet Connection
Copying Files to Docker Context
Building Docker Images
ocs-util Docker Image
Setting Up the .env File
Configuring for Order Management Server Docker Containers
Running the Docker Containers
Extend Docker-Compose Files
Modifying a Container Time-Zone
Reading Container Logs
Troubleshooting Error from Building Docker Images
Order Sequencing
Enabling or Disabling Order Sequencing
Bulk Order Actions
Bulk Order Actions
WSDL Location
Error Codes
Invoke Bulk Order Operation
Tracking the Request Status
Logging
Schema
Bulk Order Schema
Bulk Orders Operation Request Schema
Bulk Orders Operation Response Schema
Sample Request
Sample Response
Performing Bulk Actions on error Plans
Multitenancy
Configuring a tenant
Authorizing a tenant
Order Capture System User Interface Tasks
Configuring the System
User Management
Entering Users
Editing Users
Deleting Users
Demo Subscriber Directory
Accessing the List of Subscribers
Entering Subscribers
Editing Subscribers
Deleting Subscribers
Accessing the List of Stores
Entering Stores
Editing Stores
Deleting Stores
Reloading the Catalog
Back Office
Search Syntax
Managing Health Check Endpoint
TIBCO Order Management Disaster Recovery
TIBCO Order Management Topology for Disaster Recovery
Storage and Volumes
Network
Database
Messaging Server
Schema References
Plan Item
Product Model
Result Status
Message
Order Request
Order Request Header
Order Request Line
Process Component Model
TIBCO® Order Management User's Guide
Orchestrator
Architecture
Batch Notification
Batch Event Processing
Notification
Time Dependency
Non-Executing Plan Item
Process Component Destination
Order Types
Amend Order
Suspend and Activate Order
Order Submission
Execution Plan
Plan Tasks with Associated Process Components
Actions
Dependencies
Order Header
Order Line
Orchestrator Interfaces
Feasibility Providers
Feasibility Request
Feasibility Response
Process Components
Plan Item Execute Request Event
Plan Item Milestone Release Request Event
Plan Item Milestone Notify Request Event
Plan Item Execute Response Event
Plan Item Suspend Request Event
Plan Item Suspend Response Event
Plan Item Activate Request Event
Pre-qualification Failed Handlers
Pre-Qualification Failed Request Event
Pre-qualification Failed Response Event
Plan Item External Error Handlers
Plan Item Failed Request Event
Plan Item Failed Response Event
Automated Order Plan Development
Overview
Model Deployment
Configuration
Main Configuration
Logs
Features
Autoprovision
Dynamic Bundles
Static Bundles
Time Dependency
Product Specification Field Decomposition
Custom Action Based Product Decomposition
Sequencing
Delta Provisioning
Single Use
Product Affinity (Plan Item Level)
Inlink
Crosslink
Affinity Sequencing
Conditional Affinity
Conditional Affinity Sample
Configurable Handling of CrossLink + ProductComprisedOf Conflicts and Single Use + ProductComprisedOf Conflicts
Sort Plan
Attribute-Based Decomposition
ProductDependsOn and ProductRequiredFor Relationships
Dependent and Sibling Products
Shared Attributes
Shared Attributes - Sample Test Scenarios
Intermediate Milestones Dependencies
Milestone to START Dependency
END to Milestone Dependency
Milestone to Milestone Dependency
Milestone without Dependency
Conditional Milestones Dependency
Order Amendment
Amendment Workflow
Modeling of the Required Characteristics in Fulfillment Catalog
Types of Amendment
OrderLine Action Change
RequiredbyDate Change
OrderLine user-defined field Change
OrderLine Addition
Execution Plan Modification Rules (EPMR)
COMPENSATE_RESTART
COMPENSATE
RESTART
IGNORE
No Execution Plan Modification Rules Characteristic in Product
Amendment Configuration Flags
Impact on Dependencies
Multiple Amendments
Custom Action
Internal Error Handler
Internal Error Handler Data Flow Diagram
Understanding Data Flow in Internal Error Handler
Internal Error Handler Sequence Diagram
Searching for Plans with planItem in ERROR State
Modifying the Plan Item State
Choosing Error Resolution for the Plan Item in Error State
Details of Each Resolution Choice
Submit the Error Resolution
Order Capture System Overview
Order Capture System User Interface Overview
Searching for Subscribers
Submitting an Order in Order Capture System
Amending an Order in Order Capture System
Canceling an Order in Order Capture System
Order Capture System Error Codes and Messages
Search Syntax
Order Management System User Interface
Navigation
Changing Password
Order Management System User Interface Logging Notifications
Growls for Information and Error Messages
Notification Logger
Order Management Functionality
Dashboard
Dashboard Components
Order Summary
Auto-refreshing the Interval
Viewing Order Summary Data Based on the Definite Time Period
Backlog Orders
Amended Orders
Setting Display Preferences for Amended Orders
Orders in Execution
Inflow Orders
Orders Page
Searching for an Order
Viewing Order Information
Suspending an Order
Resuming an Order
Canceling an Order
Amending an Order
Performing Bulk Action on Orders
Plans Page
Searching for a Plan
Grid View
GANTT Chart View
Accessing Dependency View of Plan Items and their Status
GANTT Chart
Viewing a GANTT Chart
GANTT Chart Components
Top Toolbar
Bottom Toolbar
Grid Header
GANTT Chart Diagram
Tooltips
Activity Log
About Activity Log
Viewing the Activity Log
Searching for an Order in the Activity Log
Interpreting the Log Messages
Understanding the Types of Log Messages
Fulfillment Provisioning Attributes and Parameters
Searching for Fulfillment Provisioning Components
Data Access Interfaces
Get Plan
Get Plan Request
Get Plan Response
Get Plan Messages and Message Codes
Get Plan Items
Get Plan Items Request
Get Plan Items Response
Get Plan Items Messages and Message Codes
Set Plan
Set Plan Request
Set Plan Response
Set Plan Messages and Message Codes
Set Plan Item
Set Plan Item Request
Set Plan Item Response
Set Plan Item Messages and Message Codes
Best Practices for TIBCO Order Management
process component Design Guidelines
Process Component Technology Selection
BusinessWorks - Asynchronous process component
BusinessWorks - Synchronous Process Component
Exception Handling Guidelines
General Approach
Example Approach
Plan Item Failed Handler
Process Component Considerations
Pre-Qualification Failed Handler
Technical Exception Handling
Types of Technical Exception
TIBCO Order Management Components for Technical Exception Handling
Schema References
Plan Item
ResultStatus
Message
Order Request
Samples
Sample Order XML
Sample Plan Item XML
Sample XPATHs
Configuration Service API Samples
Archival Services API samples
Operation Get Audit Trail Data for Order
Operation Get Audit Trail Data for Plan
Get Execution Plan by Query Filter
Operation Find Order Detail
Operation Find Orders By Criteria
Operation Get Order Summary
Operation Get Orders By Criteria
Orchestrator API samples
Amend Order
Get Audit Trail
Feasibility Reply
GetOrderDetails
Submit Order
Withdraw Order Request
Activate Order
Cancel Order
Get Order Execution Plan
Suspend Order
Bulk Action
Plan Item Bulk Error Handler
Plan Item Error Handler
PlanItem Execute Response
Milestone Notify Request
Plan Item Suspend Response
PreQualification Failed Reply
Data Services API samples
Get Plan
Set Plan
Set PlanItem
Get PlanItems Request
Catalog Services API samples
Submit Action Model
Submit Action Models
Submit Product Model
Submit Product Models
Submit PlanFragment Model
Submit PlanFragment Models
Purge Action Model
Purge Plan Fragment Model
Purge Product Model
Process Component API sample
Operation Feasibility
Operation Plan Item Activate Request
Operation Plan Item Error Handler
PlanItem Execute Request
Operation Milestone Release Request
Operation Send Plan Item Execute Response
Operation Plan Item Suspend Request
Operation PreQualification Failed
Authorization Service API sample
Get User
Create and Modify User
Delete User
Configurations
Automated Order Plan Development Configuration
Orchestrator Configuration
Data Service Configuration
TM Forum Configuration
Catalog Configuration
Authorization Service Configuration
Common Configuration
Archival Service Configuration
Order Capture System Configuration
Order Management System UI Configuration
Migration Service Configuration
Jeopardy Configuration
TIBCO® Order Management Web Services Guide
Architecture
Services and Operations
Integration Channels
SOAP Over HTTP
SOAP Over JMS
REST over HTTP/HTTPS
TIBCO Fulfillment Orchestration Suite Overview
TIBCO Fulfillment Orchestration Suite Components
Fulfillment Management Services
Security Header
Order Service
Activate Order
Amend Order
Cancel Order
Get Order Details
Get Order Execution Plan
Get Orders
Handle Plan Item In Error
Perform Bulk Order Action
Submit Order
Suspend Order
Synchronous Submit Order
Withdraw Order
Automated Order Plan Development Service
Generate Plan
Generate Partial Plan
Order Management Services
Orchestrator Service
Amend Order
Get Audit Trail
Feasibility Reply
GetOrderDetails
Submit Order
Withdraw Order Request
Activate Order
Cancel Order
Get Order Execution Plan
Suspend Order
Bulk Action
Plan Item Bulk Error Handler
Plan Item Error Handler
PlanItem Execute Response
Milestone Notify Request
Plan Item Suspend Response
PreQualification Failed Reply
Authorization Service
Create and Modify User
Get User
Delete User
Generating an authorization token
Data Service
Catalog Service
Configuration Service
TM Forum Adapter Service
Common Data Format Specifications
ResultStatus
ResultFault
Notification
Order Notification
Plan Notification
Order
OrderHeader
OrderLine
ProductModel
Product
Order Characteristic
Execution Plan
PlanFragment models
PlanFragment
Pagination Type
SubscriberListType
AddressType
Response Codes and Messages
Error Codes
TIBCO® Order Management Best Practices
Introduction to TIBCO Order Management Best Practices Guide
Purpose of the Document
Scope of the Document
General Installation Guidelines
Hardware Configuration Guidelines
Hardware Selection Guidelines
Hardware Sizing Guidelines
Fault Tolerance
External Load Balancing
Software Configuration Guidelines
Software Configuration Guidelines for TIBCO Product and Service Catalog
Software Configuration Guidelines for TIBCO Order Management
Architecture
TIBCO Product and Service Catalog Strategy
Order Enrichment
Other Considerations
Product Catalog Guidelines
Best Practices for Catalog Modeling
Product Modelling Patterns
Functional Product Initializer
Helper Product Layer
Functional Coordination Helper Product
Use Case Layer Pattern
Order Fulfillment Guidelines
Order Management System Guidelines
Orchestrator Guidelines
Automatic Order Plan Development Guidelines
Data Service Guidelines
Catalog Service
Authorization Service
Create and Modify User
Get User
Delete User
Generating an authorization token
TM Forum Adapter for Order Management
Development Guidelines
Team Organization Guidelines
Code Organization Guidelines
Environment Organization Guidelines
Performance Tuning Guidelines
Performance Tuning Guidelines for TIBCO Order Management
Guidelines for Operations
Guidelines for Monitoring
Guidelines for Logging
Purging or Cleanup Guidelines
TIBCO® Order Management Security Guidelines
Introduction
Security Features
Security Vulnerabilities
Ensuring TIBCO Order Management Security
Authorization Service
Create and Modify User
Get User
Delete User
Generating an authorization token
Configuring SSL for TIBCO Order Management
Encrypt Password Utility
TIBCO Documentation and Support Services
Legal and Third-Party Notices