RTDM to ID Migration

• RTDM to ID Migration
  • Overview
    • Prerequisites
    • Installation
  • Getting Started
  • Running
    • Examples
    • Capabilities
  • Support
    • SAS Communities
    • SAS Documentation
    • GitHub Issues
  • Contributing
  • License

Overview

Tool to migrate campaigns from SAS Real-Time Decision Manager (RTDM) to SAS Intelligent Decisioning (ID).

Prerequisites

Campaigns from RTDM need to be extracted using SAS Customer Intelligence Integration Utilities. This step must be performed before running the migration tool.

SAS Customer Intelligence Integration Utilities documentation

Installation

Download this project and build using provided Maven pom.xml file.

mvn clean install

This will generate a jar file under the \target folder.

Getting Started

Migrating campaigns from RTDM to ID is a 3-step process.

• Extract campaigns from RTDM using SAS Customer Intelligence Integration Utilities. This creates an extract XML file.
• Start rtdm-migrate-to-id tool
• Issue REST requests to rtdm-migrate-to-id tool using the extract XML file as input.

Running

Run the migration tool from a command/shell window.

java -jar rtdm-migrate-to-id-0.13.1.jar

or
# if port 8080 already in use
java -Dserver.port=8086 -jar rtdm-migrate-to-id-0.13.1.jar

This row inside command/shell will tell you that service successfully started

RTDM Subdiagrams must be migrated before migrating parent diagram.

Examples

Authenticate with SAS Viya to get an authorization token.

• https://developer.sas.com/apis/rest/#authentication-to-sas-viya
• https://github.com/sassoftware/devsascom-rest-api-samples/blob/master/CoreServices/sasLogon.md

Once authenticated user can POST requests.

POST: localhost:8080/api/rtdm2id/create-diagram?baseIp={{ID environment}}&login={username}&password={password}&protocol={protocol}&parentFolderUri={parentFolderUri}&useCrossBranchLinks={useCrossBranchLinks}
Authorization: Bearer {{token}}
Content-Type: application/xml
Body: Extract XML generated from SAS Customer Intelligence Integration Utilities

Example Body: extract/extracted_campaign.xml

The parameter protocol is optional. The default value is "http" if not provided. If the target environment is using HTTPS for secure online transactions then protocol must be provided with a value of "https".

The parameter parentFolderUri is optional. The default value is /folders/folders/@myFolder if not provided.

The parameter useCrossBranchLinks is optional. The default value is "true". The use of cross-branch link nodes in the migration tool is an experimental feature. This feature is enabled by default. Cross-branch links will be created in the migrated Decision if the RTDM campaign contains a node with multiple input nodes. If the migration tool generates an error related to cross-branch links then set this parameter to "false".

Capabilities

• Creation of DS2 Node process in ID from RTDM DS2 Process
• Creation of SQL Node process in ID from RTDM Data Process
• Creation of Decision input/output variables in ID from RTDM event variables
• Creation of Assignment Rule Set in ID from RTDM Reply Node
• Creation of Assignment Rule Set in ID from RTDM calculated variables
• RTDM Subdiagrams must be migrated before migrating parent diagram

Support

SAS Communities

Ask questions on the Decisioning Community Web Site.

SAS Documentation

SAS Customer Intelligence Integration Utilities

Authentication to SAS Viya

SAS Logon API

GitHub Issues

See the SUPPORT.md file for information on how to open an issue against this repository.

Contributing

We welcome your contributions! Please read CONTRIBUTING.md for details on how to submit contributions to this project.

License

This project is licensed under the Apache 2.0 License.