Release 2.48

Unknown macro: {noprint}
Unknown macro: {float}

Contents

Components list

Billing - Charge

AddChargeToBillingGroup

Component name

AddChargeToBillingGroup

Class name

com.cdrator.billing.charge.component.AddChargeToBillingGroup

Description

Add a charge on BillingGroup - Charge is defined by PriceCode
Add a charge on BillingGroup - Charge is defined by PriceCode. The price code is made up of a prefix and suffix, which must both be added as parameters. The price code should match an existing fee.

Required activity parameters

PREFIX_PRICE_CODE - Prefix of the Fee: SINGLE,ONCE (Root)
SUFFIX_PRICE_CODE - Suffix of the Fee (Name)

Required context objects

SUBSCRIPTION - The customers Subscripton

Possible outcomes

DONE - Only possible outcome

ChargeForBillingGroup

Component name

ChargeForBillingGroup

Class name

com.cdrator.billing.charge.component.ChargeForBillingGroup

Description

Add a charge on BillingGroup - Charge is defined by PriceCode
The price code is made up of a prefix and suffix, which must both be added as parameters. The price code should match an existing fee.

Required activity parameters

PREFIX_PRICE_CODE - Prefix of the Fee: SINGLE,ONCE (Root)

Optional activity parameters

SUFFIX_PRICE_CODE - Suffix of the Fee (Name)
SUFFIX_PRICE_CODE_KEY - Used to configure the context key, to fetch the suffix of the fee from the context, if SUFFIX_PRICE_CODEis not defined in the parameters.
ADD_CHARGE - If fee has to be added immediately. Should be set to true/false. By default its false.

Required context objects

SUBSCRIPTION - The customers Subscripton

Possible outcomes

DONE - Only possible outcome

ChargeForSubscription

Component name

ChargeForSubscription

Class name

com.cdrator.billing.charge.component.ChargeForSubscription

Description

Creates a charge for subscription - Charge is defined by PriceCode.
The price code is made up of a prefix and suffix, which must both be added as parameters. The price code should match an existing fee.

Required activity parameters

PREFIX_PRICE_CODE - Prefix of the Fee: SINGLE,ONCE (Root)

Optional activity parameters

SUFFIX_PRICE_CODE - Suffix of the Fee (Name)
SUFFIX_PRICE_CODE_KEY - Used to configure the context key, to fetch the suffix of the fee from the context, if SUFFIX_PRICE_CODEis not defined in the parameters.
ADD_CHARGE - If fee has to be added immediately. Should be set to true/false. By default its false.
CHARGE_ITEM - If set to true, charge item will be added to context.

Required context objects

SUBSCRIPTION - The customers Subscripton

Possible outcomes

DONE - Only possible outcome

Billing - Churn

UpdateStatusAndCommentsForBatchFileLine

Component name

UpdateStatusAndCommentsForBatchFileLine

Class name

com.cdrator.billing.churn.component.UpdateStatusAndCommentsForBatchFileLine

Description

Updates the status and comments for a batch file line.

Optional activity parameters

STATUS - The status_id to which the status should be changed to.

Required context objects

BATCH_FILE_LINE - Batch file line whose status/comments have to be updated.

Optional context objects

BATCH_FILE_LINE_COMMENTS - The comment string to which the comment of batch file line has to be set to.

Possible outcomes

DONE - Once the update of status/comment is done.

Billing

ChangeAlertGroupForBillingGroup

Component name

ChangeAlertGroupForBillingGroup

Class name

com.cdrator.billing.component.ChangeAlertGroupForBillingGroup

Description

Sets alert group id on a billing group.
Sets alert group id on a billing group. Alert group id must be defined in the activity parameter as ALERT_GROUP_ID, and Billing group must be in context with key BILLING_GROUP

Required activity parameters

ALERT_GROUP_ID - Activity parameter to define the id of the alert group.

Required context objects

BILLING_GROUP - The ID of the Billing Group which will get the alert group id set.

Possible outcomes

DONE - When the Billing Groups alert group has been set.

ChangeBillingGroup

Component name

ChangeBillingGroup

Class name

com.cdrator.billing.component.ChangeBillingGroup

Description

This component is used to change the billing group on a subscription.
The new billing group can be a reused existing billing group of the same type, or a new one. Saves the newly created billing group member to Context as BILLING_GROUP_MEMBER

Required context objects

SUBSCRIPTION - The subscription changing billing group.
BG_TYPE - The code for the Billing Group being being changed to.
BILLING_CYCLE - The ID of the Billing Cycle for the new Billing Group. Only required when creating a new Billing Group.
ALERT_GROUP - The ID of the Alert Group for the new Billing Group. Only required when creating a new Billing Group.

Optional context objects

CHANGE_DATE - The start date of the new billing group. If not set, will default to today's date.
CHANGE_TO_EXISTING_BG - Indicates if an existing Billing Group should be used as the new Billing Group. Allowed values: 'Y' and 'N'. If no value is set, or no existing Billing Group with type "BG_TYPE" can be found, defaults to creating a new Billing Group.

Possible outcomes

DONE - When the Billing Group has been changed

CheckBillingGroupHasActiveMembers

Component name

CheckBillingGroupHasActiveMembers

Class name

com.cdrator.billing.component.CheckBillingGroupHasActiveMembers

Description

Checks if the Billing Group has active members.

Required context objects

BILLING_GROUP - The Billing Group which has to be checked.

Possible outcomes

YES - When the billing_group has active members.
NO - When the billing_group has no active members.

CheckBillingGroupHasMailOrSmsEnabled

Component name

CheckBillingGroupHasMailOrSmsEnabled

Class name

com.cdrator.billing.component.CheckBillingGroupHasMailOrSmsEnabled

Description

Checks if email and sms options are enabled on the billing group.
Adds the context object: IS_SEND_BOTH into the context. This represents whether both sms and email have to be sent if the value is true.

Required context objects

BILLING_GROUP - Billing group is required in the context.

Possible outcomes

SEND_BOTH - If both sms and email options are enabled on the billing group.
SEND_EMAIL - If only email is enabled on the billing group.
SEND_SMS - If only sms is enabled on the billing group.

CreateBillingGroup

Component name

CreateBillingGroup

Class name

com.cdrator.billing.component.CreateBillingGroup

Description

Determines which type of billing group to create based on the Product Config from the Context.
The outcome will be set based on Product Config's billing_group_code.

Required context objects

PRODUCT_CONFIG - The Product Config used to determine the Billing Group.

Possible outcomes

POST_PAID - When the billing_group_code fetched from the Product Config is, POST_PAID
PRE_PAID_CARD - When the billing_group_code fetched from the Product Config is, PRE_PAID_CARD
PRE_PAID_ADVANCED - When the billing_group_code fetched from the Product Config is, PRE_PAID_ADVANCED

CreatePostPaidBillingGroup

Component name

CreatePostPaidBillingGroup

Class name

com.cdrator.billing.component.CreatePostPaidBillingGroup

Description

Creates a post-paid billing group and adds it to the Context.
The component saves the newly created post-paid billing group to the Context as, BILLING_GROUP or the context key defined in the activity parameter BILLING_GROUP_CONTEXT_KEY.

Optional activity parameters

INVOICE_CREDIT_DAYS - Activity parameter to define the number of credit days. If not defined, then ParameterTreeValue for the specific product configs product code: "INVOICE.<PRODUCT_CONFIG_PRODUCT_CODE>_CREDIT_DAYS" will be considered.If the previous ParameterTreeValue is not defined, then, Default ParameterTreeValue: "INVOICE.CREDIT_DAYS" will be considered. If none of the above is set, then, "0" will be considered
INVOICE_TYPE - Activity parameter to define the invoice type. If not defined, then, ParameterTreeValue for the specific product configs product code: "INVOICE.DEFAULT_INVOICE_TYPE.<PRODUCT_CONFIG_PRODUCT_CODE>" will be considered.If none of the above is set, then, BillingGroup.INVOICE_TYPE_ID_PAPER will be considered.
BILLING_GROUP_CONTEXT_KEY - Activity parameter to define which context key will be used when adding the newly created billing group If not defined, context key defaults to BILLING_GROUP

Required context objects

PRODUCT_CONFIG - The Product Config used to create the billing group.

Optional context objects

BRAND - If this context object is present in the context, then the brand_id for the prepaid billing group being created is set.

Possible outcomes

DONE - When the postpaid billing group has been created.

CreatePrePaidBillingGroup

Component name

CreatePrePaidBillingGroup

Class name

com.cdrator.billing.component.CreatePrePaidBillingGroup

Description

Creates a prepaid billing group and adds it to the Context.
The component adds the newly created prepaid billing group to the context as, BILLING_GROUP.

Required context objects

PRODUCT_CONFIG - The Product Config used to create the prepaid billing group.

Optional context objects

BRAND - If this object is present in the context, then the brand_id for the prepaid billing group being created is set.

Possible outcomes

DONE - When the prepaid billing group has been created.

CreatePrePaidCardBillingGroup

Component name

CreatePrePaidCardBillingGroup

Class name

com.cdrator.billing.component.CreatePrePaidCardBillingGroup

Description

Creates a prepaid card billing group and adds it to the Context.
The component adds the newly created prepaid card billing group to the context as, BILLING_GROUP.

Required context objects

PRODUCT_CONFIG - The Product Config used to create the billing group.

Optional context objects

BRAND - If this object is present in the context, then the brand_id for the prepaid billing group being created is set.

Possible outcomes

DONE - When the prepaid card billing group has been created.

GetBillingGroupByName

Component name

GetBillingGroupByName

Class name

com.cdrator.billing.component.GetBillingGroupByName

Description

Checks if a billing group exists for the provided billing group name.
If a billing group is found then the billing group is added to the context.

Required context objects

BILLING_GROUP_NAME - Billing group name for which a billing group has to be fetched.

Possible outcomes

SUCCESS - If a billing group is found.
FAILED - If a billing group is not found.

MoveBillingGroupBalance

Component name

MoveBillingGroupBalance

Class name

com.cdrator.billing.component.MoveBillingGroupBalance

Description

Moves the balance from prepaid billing group to a new postpaid billing group.
This component requires that two CHARGE_ITEMS are defined in parameter tree:
MIGRATION.BALANCE.FROM_PREPAID_TO_POSTPAID: charge_item for moving positive balance
MIGRATION.BALANCE.FROM_PREPAID_TO_POSTPAID_NEGATIVE: charge_item for moving negative balance

Required context objects

BILLING_GROUP - The old prepaid billing group whose balance has to be moved.
SUBSCRIPTION - Subscription related to the new billing group.

Possible outcomes

DONE - When the Billing Group's balance is moved.
WAIT - If the new Billing Group Member is not active.

TerminateSubscriptionOn

Component name

TerminateSubscriptionOn

Class name

com.cdrator.billing.component.TerminateSubscriptionOn

Description

This component takes all possible information and calls subscription.terminateON
If the parameters (object)_key is set, it will be used instead of the default key in the description.
If the optional objects in the description is not there, default values will be used instead, these values are taken from the terminateOn methods in the subscription class.
If the parameters REASON, COMMENT, HOOKPOINT or COMMENT2 are set, the text will be used instead of what is in context.
If they follow this regex: ^\w+\.\w+()$ the method will be called in the same way as in the component: AddContextObject, otherwise they will be used a text string.

Optional activity parameters

SUBSCRIPTION_KEY - The context key for the subscription
DATE_KEY - The context key for the date
REASON_KEY - The context key for the reason
OUTPORT_KEY - The context key for the outport
COMMENT_KEY - The context key for the comment
REASON_ID_KEY - The context key for the reason_id
HOOKPOINT_KEY - The context key for the hookpoint_key
COMMENT2_KEY - The context key for the comment2
CAN_CONTACT_CUSTOMER_KEY - The context key for the can_contact_customer
OUTPORTED_TO_SERVICE_ID_KEY - The context key for the outported_to_service_id
REASON - The reason text or method to call
REASON_ID - The reason ID or method to call
COMMENT - The comment text or method to call
HOOKPOINT - The hookpoint text or method to call
COMMENT2 - The comment2 text or method to call

Required context objects

SUBSCRIPTION - The subscription to terminated.
DATE - The date to terminate on.
REASON - The reason for the termination. Only required if REASON is not set in the parameters.

Optional context objects

OUTPORT - If the service of the subscription should be set as outported.
COMMENT - The comment to put in the termination.
REASON_ID - The reason_id to put in the termination. Only used if REASON_ID is not set in the parameters
HOOKPOINT - The hookpoint_key for the termination flow.
COMMENT2 - The comment2 to put in the termination.
CAN_CONTACT_CUSTOMER - If the customer can be contacted.
OUTPORTED_TO_SERVICE_ID - The service id the subscription has been outported to.

Possible outcomes

DONE - If the subscription is terminated correctly.

Billing - Invoice

AddInvoiceFee

Component name

AddInvoiceFee

Class name

com.cdrator.billing.invoice.component.AddInvoiceFee

Description

This component will add fees to all invoices in the batch based on Brand Key and BillingGroup Invoice Type.
If no invoices exist to be processed for the batch, just a log entry will be added.

Required context objects

INVOICE_BATCH - The batch to which the fee has to be added to.
PE_CODE_X - Context object where X is replaced by billing group Invoice Type mapped to the Plan Element Code. Fx: PE_CODE_0 (invoice type paper) = SINGLE-INVOICE_GIRO.
RATEPLAN_BK_XXXX - Context object where XXXX is replaced by the Brand key mapped to the RatePlan ID. Fx: for instance: RATEPLAN_BK_GREENTEL = 201202031557455011.

Possible outcomes

DONE - After the invoice batch is processed or if no invoices exist in the batch to be processed.

CloseOpenInvoice

Component name

CloseOpenInvoice

Class name

com.cdrator.billing.invoice.component.CloseOpenInvoice

Description

This component will close the invoice based on the invoice from the context.

Required context objects

INVOICE - The invoice to be closed.

Possible outcomes

DONE - Once the invoice is closed.

CloseOpenInvoiceWithDueDate

Component name

CloseOpenInvoiceWithDueDate

Class name

com.cdrator.billing.invoice.component.CloseOpenInvoiceWithDueDate

Description

This component will close an invoice in context.
The component will close the invoice using invoice.closeWithDueDate(now).

Required context objects

INVOICE - The invoice that has to be closed.

Possible outcomes

DONE - When the invoice is closed.

GenericGetInvoiceAggregateLines

Component name

GenericGetInvoiceAggregateLines

Class name

com.cdrator.billing.invoice.component.GenericGetInvoiceAggregateLines

Description

Fetches the invoice aggregate lines of an invoice
Saves the list of invoice aggregate lines into the context as, INVOICE_AGGREGATE_LINES

Optional activity parameters

INVOICE_AGGREGATE_LINES_CONTEXT_KEY - CONTEXT key to use when adding the invoice aggregate lines to the context. Default: INVOICE_AGGREGATE_LINES

Required context objects

INVOICE - The invoice for which to get invoice aggregate lines

Possible outcomes

DONE - When the invoice aggregate lines have been added to the context
NO_INVOICE_AGGREGATE_LINES_FOUND - When the invoice does not contain any aggregate lines

GetInvoiceAggregateLines

Component name

GetInvoiceAggregateLines

Class name

com.cdrator.billing.invoice.component.GetInvoiceAggregateLines

Description

Fetches the invoice aggregate lines of an invoice.
Saves the list of invoice aggregate lines into the context as, INVOICE_AGGREGATE_LINES

Required context objects

INVOICE_ID - Invoice id for the invoice whose aggregate lines have to be fetched.

Possible outcomes

NO_INVOICE_AGGREGATE_LINES_FOUND - When no aggregate lines exist for the invoice.
DONE - When the aggregate lines are fetched and added to the context.

IsInvoiceOverDue

Component name

IsInvoiceOverDue

Class name

com.cdrator.billing.invoice.component.IsInvoiceOverDue

Description

Checks due date on given invoice

Required context objects

INVOICE - Invoice to check due date

Possible outcomes

YES - If invoice is over due
NO - If invoice due date is not reached or not set

SetInvoiceDueDate

Component name

SetInvoiceDueDate

Class name

com.cdrator.billing.invoice.component.SetInvoiceDueDate

Description

Updates invoice due date

Required context objects

INVOICE - The invoice which due date should be changed
DATE - The date to change due date to

Possible outcomes

DONE - When due date is updated

Billing - Payment

AccountPaymentSetCaptureStatus

Component name

AccountPaymentSetCaptureStatus

Class name

com.cdrator.billing.payment.component.AccountPaymentSetCaptureStatus

Description

This component will update the capture status on an Account Payment.
It will set the capture status to the value configured in the activity parameter: NEW_CAPTURE_STATUS.

Required activity parameters

NEW_CAPTURE_STATUS - Valid capture status id(valid integer value) to which the Account Payment's capture status has to be set to.

Required context objects

ACCOUNT_PAYMENT - The account payment whose status has to be changed.

Possible outcomes

DONE - When the capture status id of the Account Payment has been set.

CreateRechargeTicket

Component name

CreateRechargeTicket

Class name

com.cdrator.billing.payment.component.CreateRechargeTicket

Description

Creates a new recharge ticket.
This component creates a new recharge ticket for a given BILLING_GROUP with TICKET_ID and TICKET_TYPE.
The recharge ticket is added to the context with key "RECHARGE_TICKET".

Optional activity parameters

DEFAULT_RECHARGE_LIMIT_PATH - default recharge limit if none found in the context
SAVE_TICKET - After saving the ticket should it be saved. Y = Yes/N = No. Default: Y

Required context objects

BILLING_GROUP - The billing group must be in the context
TICKET_TYPE - The ticket code must be in the context with key

Optional context objects

TICKET_ID - The ticket value must be in the context
RECHARGE_AMOUNT - Recharge amount
RECHARGE_TO_AMOUNT - Recharge to amount
RECHARGE_LIMIT - Recharge limit
LAST_RECHARGE_DATE - Date the ticket should be considered recharged last. Recharges will only occur after this day.
DAY_OF_MONTH - Day of month to recharge
REFERNCE - Recharge ticket reference

Possible outcomes

RECHARGE_TICKET_EXISTS - If the recharge ticket already exists
DONE - When the recharge ticket has been created

DeleteRechargeTicket

Component name

DeleteRechargeTicket

Class name

com.cdrator.billing.payment.component.DeleteRechargeTicket

Description

Delete a recharge ticket.
This component deletes a recharge ticket for a given BILLING_GROUP.
The billing group must be in the context with key "BILLING_GROUP"
(OBS when using this with balance-recharge-ticket - it changes and saves the billing-group
This can lead to concurrency problems with "BILLING_GROUP" in in-process workflows)
Possible outcomes are:
NO_RECHARGE_TICKET_FOUND
DONE

GetAccountPayments

Component name

GetAccountPayments

Class name

com.cdrator.billing.payment.component.GetAccountPayments

Description

Gets a list of account payments.
Will get a list of account payments, based on the specified search criterias. The list will be stored in hookpoint result with the name ACCOUNT_PAYMENT_LIST.

Optional activity parameters

ORDER_BY - The order of the results.
CAPTURE_STATUS_IDS - A comma seperated list of Capture Status id's. If empty, the query will not include capture status.

Required context objects

BILLING_GROUP_ID - Billing group id for the account payments to filter by.

Optional context objects

INVOICE_ID - Invoice id for the account payments to filter by.
MAX_ROWS - Max number of records that should be returned.

Possible outcomes

DONE - When the list of accout payments have been succesfully added to hookpoint result.

GetNewPaymentRef

Component name

GetNewPaymentRef

Class name

com.cdrator.billing.payment.component.GetNewPaymentRef

Description

Returns a payment reference.
This component will return a payment reference (by using the id sequence using getFullId()).
The payment reference will be added to the context with key: "PAYMENT_REF".
This key can be customized by setting activity parameter: PAYMENT_REF_KEY
It is possible to precede the payment reference with the brand key by setting "PREPEND_BRAND_KEY" to "Y"
The resulting payment ref will be: BRANDKEY + ID
Possible outcomes are:
DONE

GetRechargeTicket

Component name

GetRechargeTicket

Class name

com.cdrator.billing.payment.component.GetRechargeTicket

Description

Gets a recharge ticket.
This component retrieves a recharge ticket for a given BILLING_GROUP.
The recharge ticket values are added to the context with keys: "TICKET_ID", "TICKET_TYPE", "RECHARGE_AMOUNT", "RECHARGE_TO_AMOUNT", "DAY_OF_MONTH", "RECHARGE_LIMIT"
The billing group must be in the context with key "BILLING_GROUP"
Possible outcomes are:
NO_RECHARGE_TICKET_FOUND
DONE

SavePayment

Component name

SavePayment

Class name

com.cdrator.billing.payment.component.SavePayment

Description

Saves a payment.
This component saves a payment.
The account payment is added to the context with key: "ACCOUNT_PAYMENT"
A valid charge item must be set in the parameter tree with value: "SOAP.SIGNUP.PAYMENT.CHARGE_ITEM_ID"
The billing group must be in the context with key "BILLING_GROUP"
The payment date must be in the context with key "PAYMENT_DATE"
The payment type must be in the context with key "PAYMENT_TYPE"
The payment reference must be in the context with key "PAYMENT_REFERENCE"
The transaction id must be in the context with key "TRANSACTION_ID", if it's a number.
The transaction id must be in the context with key "TRANSACTION_NUMBER", if it's alphanumerical.
The amount must be in the context with key "AMOUNT"
Outcome is
DONE

Required context objects

BILLING_GROUP - The billing group must be in the context with key "BILLING_GROUP"
PAYMENT_DATE - The payment date must be in the context with key "PAYMENT_DATE"
PAYMENT_TYPE - The payment type must be in the context with key "PAYMENT_TYPE"
PAYMENT_REFERENCE - The payment reference must be in the context with key "PAYMENT_REFERENCE"
TRANSACTION_ID - The transaction id must be in the context with key "TRANSACTION_ID", if it's a number. In case transactionId is alphanumerical, transactionNumber should be used and this should be set to 0.
AMOUNT - The amount must be in the context with key "AMOUNT"

Optional context objects

TRANSACTION_NUMBER - The transaction id must be in the context with key "TRANSACTION_NUMBER", if it's alphanumerical.

Possible outcomes

DONE - this is a description of the possible outcomes of the activity

UpdateRechargeTicket

Component name

UpdateRechargeTicket

Class name

com.cdrator.billing.payment.component.UpdateRechargeTicket

Description

Updates a recharge ticket.
This component updates a recharge ticket for a given BILLING_GROUP. For each listed field if not null or empty.
The recharge ticket is added to the context with key "RECHARGE_TICKET".
The billing group must be in the context with key "BILLING_GROUP".
Optional context parameters:
"RECHARGE_AMOUNT" - recharge amount
"RECHARGE_TO_AMOUNT" - recharge to amount
"RECHARGE_LIMIT" - recharge limit
"DAY_OF_MONTH" - day of month to recharge
Possible outcomes are:
NO_RECHARGE_TICKET_FOUND
DONE

Billing - SubscriptionFees

AddFeeForRemainingSubscriptionLockin

Component name

AddFeeForRemainingSubscriptionLockin

Class name

com.cdrator.billing.subscriptionFees.component.AddFeeForRemainingSubscriptionLockin

Description

Add a fee for the options in the list OPTION_KEYS if the active service is subscribed to one or more of these options.
Fees will be charged for the remaining time of the current subscription lockin (if present). As for instance caused by subscription termination before lockin end date.

Required activity parameters

OPTION_KEYS - A list of product option keys separated by , [comma]. Options for the provided keys will be checked.

Required context objects

SUBSCRIPTION - The subscription that will be charged with the fees.

Possible outcomes

ADDED - After adding the fees for the remaining lockin period.
NO_LOCKIN - If SUBSCRIPTION doesn't have an active lockin.

BillAllActiveSubscriptionFees

Component name

BillAllActiveSubscriptionFees

Class name

com.cdrator.billing.subscriptionFees.component.BillAllActiveSubscriptionFees

Description

This component will bill all SubscriptionFees instantly on the invoice passed in the context.
SUBSCRIPTION and INVOICE are required in the context. This component will find all the subscriptionFees for a subscription and bill it to the invoice from the context.
Outcome is DONE

GetAnumberGroupSignupFee

Component name

GetAnumberGroupSignupFee

Class name

com.cdrator.billing.subscriptionFees.component.GetAnumberGroupSignupFee

Description

Gets the signup fees for a signup anumber group.
Gets the signup fees for a signup a-number group.
The fee is added to the context with key: "ANUMBER_GROUP_SIGNUP_FEE".
The a-number group id should be in the context with key "ANUMBER_GROUP_ID", otherwise no AnumberGroupSignupFee is added.
The rateplan must be in the context with key "RATE_PLAN".
Optional context parameters:
TOTAL_PRICE
Outcome is
DONE

GetProductOptionFees

Component name

GetProductOptionFees

Class name

com.cdrator.billing.subscriptionFees.component.GetProductOptionFees

Description

Gets the signup fees for product options.
The list will be available in the context with key: "SOAP_GET_PRODUCT_OPTION_FEES".
The rate plan must be added to the context with key "RATE_PLAN_ID".
The product option must be added to the context with key "PRODUCT_OPTIONS".
Possible input is:
"TOTAL_PRICE" - Used internally for summing up fee costs
Possible activity configuration is:
BUSINESS_DAYS_UNTIL_START: number of working days until fee starts. Default is 1.
ADD_EXTRA_MONTH: if the component should add an extra month if the feedate is later than the 15th.
Possible outcomes are:
NO_RATE_PLAN_FOUND
DONE

GetSignupFee

Component name

GetSignupFee

Class name

com.cdrator.billing.subscriptionFees.component.GetSignupFee

Description

Gets the signup fees for a signup to a specific rate plan.
Gets the signup fees for a signup to a specific rate plan.
The list will be available in the HookpointResult with key: "SOAP_GET_SIGNUP_FEE".
Possible input is:
RATE_PLAN_ID
TOTAL_PRICE
Possible outcomes are:
NO_RATE_PLAN_FOUND
DONE

UpdateFeeEndDateWithEndDateLastPeriod

Component name

UpdateFeeEndDateWithEndDateLastPeriod

Class name

com.cdrator.billing.subscriptionFees.component.UpdateFeeEndDateWithEndDateLastPeriod

Description

Updates subscription fee's fee_end_date with end_date_last_period of the subscription fee.
When updating the fee_end_date, if then end_date_last_period is null, then both end_date_last_period and fee_end_date are updated with subscription's end_date.

Required context objects

SUBSCRIPTION - Subscription whose fees dates have to be updated.

Possible outcomes

DONE - When fee_end_date is set.

UpdateSubscriptionFeeNextChargeDate

Component name

UpdateSubscriptionFeeNextChargeDate

Class name

com.cdrator.billing.subscriptionFees.component.UpdateSubscriptionFeeNextChargeDate

Description

Updates subscription fee's next change date.
First the next charge date will be updated with the date in context if it exists, then the time will be updated with the parameter value if it exists.

Optional activity parameters

NEXT_CHARGE_TIME - the time to update the subscription fees next charge date with, e.g. HH, HH:MM, HH:MM:SS or HH:MM:SS:MS

Required context objects

FEE - the subscription fee to update.

Optional context objects

NEXT_CHARGE_DATE - the date to set for the subscription fee next charge date.

Possible outcomes

DONE - when the date is successfully updated.

Campaign - Bundle

GetBundleInfo

Component name

GetBundleInfo

Class name

com.cdrator.campaign.bundle.component.GetBundleInfo

Description

Retrieve bundles information: ID, CODE, NAME, DESCRIPTION and VALUE1 for the given CAMPAIGN.
The bundles returned are stored in a List in the context with name BUNDLES. For each bundle there is a Context in this list with keys ID, CODE, NAME, DESCRIPTION and VALUE1.

Required context objects

CAMPAIGN - Campaign for which the bundles information will be returned.

Possible outcomes

DONE - When the execution is done.

GetSubscriptionBundle

Component name

GetSubscriptionBundle

Class name

com.cdrator.campaign.bundle.component.GetSubscriptionBundle

Description

Gets the subscription bundles.
This component will get the subscription bundles.
The list will be available in the HookpointResult with key: "SOAP_GET_SUBSCRIPTION_BUNDLES"
Possible input is:
SUBSCRIPTION_ID
Possible outcomes are:
NO_SUBSCRIPTION_BUNDLES_FOUND
DONE

Campaign

ActivateSubscriptionCampaignInContext

Component name

ActivateSubscriptionCampaignInContext

Class name

com.cdrator.campaign.component.ActivateSubscriptionCampaignInContext

Description

This component will activate the subscription campaign in the context.
A subscription campaign is required in the context for this component to work.It will set the status and start date on the subscription campaign and add a subscription bundle, if one does not exist.

Optional activity parameters

SUBCAMPAIGN_START_DATE - If a date other than current date has to be set as the start date of the subscription campaign.

Required context objects

SUBSCRIPTION_CAMPAIGN - Subscription campaign which has to be activated.

Possible outcomes

activated - Once the subscription campaign is activated.

ActivateSubscriptionCampaigns

Component name

ActivateSubscriptionCampaigns

Class name

com.cdrator.campaign.component.ActivateSubscriptionCampaigns

Description

This component will activate subscription campaigns.
A subscription is required in the context for this component to work. This component will activate all subscription campaigns assigned to the subscription.It will set the status and start date on the subscription campaigns and add a subscription bundle, if one does not exist. By default the start date will be set to now, but can be changed by adding another date into the context with the key SUBCAMPAIGN_START_DATE.
Outcome is activated

AddCampaignsToSubscription

Component name

AddCampaignsToSubscription

Class name

com.cdrator.campaign.component.AddCampaignsToSubscription

Description

This component will add one-to-many campaigns to a subscription.
A subscription is required in the context and parameter for the campaign codes (code fields from the campaign).This component will add campaigns to a subscription.
Outcome is ADDED

AssignCampaign

Component name

AssignCampaign

Class name

com.cdrator.campaign.component.AssignCampaign

Description

Assign a campaign to the subscription, based on a campaign key and the subscription object.
The generated subscription campaign object will be added to the context.
Required context value(s):
SUBSCRIPTION: the subscription that the campaign will be assigned to
Optional context value(s):
CAMPAIGN_KEY: the key of the campaign. If not found the value from the paramter value is used.
Optional parameter value(s):
CAMPAIGN_KEY: the key of the campaign.
Outcome are:
DONE
CAMPAIGN_NOT_FOUND

GetProductCampaigns

Component name

GetProductCampaigns

Class name

com.cdrator.campaign.component.GetProductCampaigns

Description

Add the list of campaigns for a specific product to the context
Required context values:
PRODUCT_ID or PRODUCT
Outcome are:
DONE
PRODUCT_NOT_FOUND

GetSubscriptionCampaigns

Component name

GetSubscriptionCampaigns

Class name

com.cdrator.campaign.component.GetSubscriptionCampaigns

Description

Gets the subscription campaigns and put in Context.
This component will get the subscription campaigns.
The list of subscription campaigns will be available in the context with key: "SUBSCRIPTION_CAMPAIGNS".
The SUBSCRIPTION must be in the WfContext with key "SUBSCRIPTION".
Possible outcomes are:
NO_SUBSCRIPTION_CAMPAIGNS_FOUND
DONE

ReActivateSubscriptionCampaign

Component name

ReActivateSubscriptionCampaign

Class name

com.cdrator.campaign.component.ReActivateSubscriptionCampaign

Description

Re-activates a subscription campaign.
The date in the field To Date will be removed and the Status cahnged to Active (1).
Required context value:
SUBSCRIPTION_CAMPAIGN
Outcome is:
DONE

CdmaPhone

BookCdmaPhoneToService

Component name

BookCdmaPhoneToService

Class name

com.cdrator.cdmaPhone.component.BookCdmaPhoneToService

Description

This component will book a cdmaPhone to the service.
A CDMA_PHONE and a SERVICE is required in the context for this component to work. This component will book a CDMA Phone to a cdma SERVICE.
Outcome is DONE

Correspondence - Archive

AddDocArchive

Component name

AddDocArchive

Class name

com.cdrator.correspondence.archive.component.AddDocArchive

Description

This component will save a document to the doc archive using an inputStream in the context.
Parameters required for this to work is:
INPUT_STREAM_CONTEXT_KEY
PERSISTENT_OBJECT_KEY
DOC_ARCHIVE_DESCRIPTION
DOC_ARCHIVE_FILE_NAME
Optional parameters:
DOC_ARCHIVE_SUB_CODE
Required objects in the context:
ACCOUNT
A persistentObject with the key matching the value of the parameter PERSISTENT_OBJECT_KEY.
An InputStream with the key matching the value of the parameter INPUT_STREAM_CONTEXT_KEY.
Outcome is
DONE

SaveDocArchiveFile

Component name

SaveDocArchiveFile

Class name

com.cdrator.correspondence.archive.component.SaveDocArchiveFile

Description

This component will save a document from the document archive to the file system.
Parameters required for this to work is: FILE_PATH and DOC_ARCHIVE must be in the context of the workflow.
Outcome is DONE.

Correspondence

DynamicSender

Component name

DynamicSender

Class name

com.cdrator.correspondence.component.DynamicSender

Description

This component will assemble and send dynamic mail or SMS.
The component is configured using parameters.
Use the following configuration parameters:
SUBSCRIPTION_CONTEXT_KEY=<alternate subscription context key>
TEMPLATE_KEY=<template key>
TEMPLATE_TYPE=<EMAIL> or <SMS> (if not defined the default is EMAIL)
[REPLACE_EMPTY_LABELS]=true/false meaning if a LABEL is not handling and this is set to true, the label will not be shown as **LABEL@SOMETHING**, but will be an empty string. DEFAULT=FALSE.
[TEMPLATE_TO]=<phone_number> or <email> of recipent. If put in "SOMETHING" (double quotes) it will be used directly, otherwise the sender will try to resolve it like for labels etc.
___________________________________________
All parameters where the value is in "SOMETHING" (double quotes) are used directly.
Data can be retrieved using the same navigation logic as for labes and conditions.
It will replace lables using methods from context objects.
Advanced labels can be configured and uses by defining retrival path.
Example:
Context contains a SUB (Subscription) and is a mobile subscription meaning service will know the SIM card
You can navigate to SIM card pin using:
LABEL_PIN1=SUBSCRIPTION.getService.getSimCard.getPin1
LABEL_PIN2=SUBSCRIPTION.getService.getSimCard.getPin2
You can use work-labels for advanced navigation i.e.
WORK_SIMCARD=SUBSCRIPTION.getService.getSimCard
LABEL_PIN1=WORK_SIMCARD.getPin1
___________________________________________
Attachment options (several attachments allowed):
Parameters with key ATTACHMENT_<SOMETHING> will be tried resolved like labels.
Example:
WORK_INV_CODE=INVOICE
ATTACHMENT_AUTHORIZATION=INVOICE.getDocArchive(WORK_INV_CODE).getDocArchiveFile
It is also possible to directly define a path for a file to attach like:
ATTACHMENT_AUTHORIZATION="C:/rator/files/somefile.txt" .. must be in double quotes
The last option is to put the attachment in the context in an earlier step in the wf.
Meaning CONTEXT.get("ATTACHMENT_<SOMETHING>") should contain the file to attach

Required activity parameters

TEMPLATE_KEY - Name of the template to use.

Optional activity parameters

TEMPLATE_TYPE - <EMAIL> or <SMS> (if not defined the default is EMAIL)
REPLACE_EMPTY_LABELS - true/false meaning if a LABEL is not handling and this is set to true, the label will not be shown
TEMPLATE_TO - <phone_number> or <email> of recipent. If put in "SOMETHING" (double quotes) it will be used directly

Optional context objects

SUBSCRIPTION - Subscription object
ACCOUNT - Account object
SERVICE - Service object

Possible outcomes

DONE - When correspondance is sent

Device

ChangeDeviceStatus

Component name

ChangeDeviceStatus

Class name

com.cdrator.device.component.ChangeDeviceStatus

Description

Changes the status of the device defined to a configurable new status.Required parameters:
NEW_DEVICE_STATUS: the new status value for the device.
Optional parameters:The device is found in the context found via the key defined in the parameter: DEVICE_CONTEXT_KEY.
The default device CONTEXT_KEY is DEVICE.
Outcome is DONE.

ReleaseDevice

Component name

ReleaseDevice

Class name

com.cdrator.device.component.ReleaseDevice

Description

Releases the device from any service assignment.
Required parameters:
Optional parameters:
DEVICE_CONTEXT_KEY - The device is found in the context found via the key defined in this parameter.
Default device CONTEXT_KEY is DEVICE.
Outcome is DONE.

Fraud - Addresscheck

CheckIfUserExistsByPersonalIdOrCVRId

Component name

CheckIfUserExistsByPersonalIdOrCVRId

Class name

com.cdrator.fraud.addresscheck.component.CheckIfUserExistsByPersonalIdOrCVRId

Description

Checks if the user exists based on the personal id or the CVR id.
Either PERSONAL_ID or CVR_ID must be specified. Adds the boolean value to the context: IS_USER_EXISTS representing whether a user exists or not.

Optional activity parameters

CHECK_FOR_ACTIVE_SUBSCRIPTIONS - If set to true, the component will check if the user with the given personal_id(/cvr_id has any non-terminated subscriptions. If the user does not have any non-terminated subscriptions, then the outcome will be false.

Required context objects

CONTEXT - Context object, mandatory in each request.

Optional context objects

PERSONAL_ID - Personal Id of user.
CVR_ID - CVR ID of company/business.

Possible outcomes

FALSE - If user does not exist in the rator system or if the user exists but does not have any non-terminated subscriptsons.
TRUE - If user does exist in the rator system.

DoUseCachedAddressCheckResult

Component name

DoUseCachedAddressCheckResult

Class name

com.cdrator.fraud.addresscheck.component.DoUseCachedAddressCheckResult

Description

This component tells whether cached result should be used or an actual address check should be called.
A USERS Context Object is required for this component to work.
If the address check has been run within a certain period, the result of that check will be returned.
This is done to minimize the number of requests to the address check server.
The name of the parameter in the parameter tree which holds information concerning the period
back in time which should return the same result: FRAUD.ADDRESSCHECK.CACHE_PERIOD
If this parameter tree entry for cache period is not defined/contains empty value, the cached result is not used.
Possible outcomes are: YES/NO
Outcome YES means that cached result should be used.
Outcome NO means that actual address check should be called.

GetUserWithPersonalId

Component name

GetUserWithPersonalId

Class name

com.cdrator.fraud.addresscheck.component.GetUserWithPersonalId

Description

This components checks whether a user exists in Rator for given personalId/cvrId and adds account_id to hookpoint result if user is found.
This component checks if user with given personalId/cvrId exist in Rator. If the User with given
personalId/cvrId is not found in Rator, an user object is created and added to context with key "USERS".
If the user exists in Rator, the AccountId obtained from the user is added to hookpoint result with key
"ACCOUNT_ID" and the user object is added to workflow context with key "USERS".
Possible input is:
CONTEXT: Context object, mandatory in each request.
PERSONAL_ID: PersonalId of user.
CVR_ID: CVR ID of company/business. Either PERSONAL_ID or CVR_ID must be specified.
FIRST_NAME: First name of user that needs address check (optional).
LAST_NAME: Last name of user that needs address check (optional).
Possible outcomes are: INVALID_INPUT/DONE

Fraud

IsBlackListCheckEnabled

Component name

IsBlackListCheckEnabled

Class name

com.cdrator.fraud.component.IsBlackListCheckEnabled

Description

Checks whether the blacklist check on the User is enabled.
This component verifies the value of parameter tree entry SOAP.SERVICES.SIGNUP_SERVICES.RATOR_BLACKLIST_ENABLED
to find if the blacklist check should be done on the user: If the value of this parameter is YES/Y/TRUE,
the blacklist check should be done. A USERS context object is needed for this component to work.
The brandId from Users object is used to get the blacklist parameter value.
Possible outcomes are: YES/NO

PerformBlackListCheck

Component name

PerformBlackListCheck

Class name

com.cdrator.fraud.component.PerformBlackListCheck

Description

Performs blacklist check on the User.
A USERS context object is required for this component to work. This component performs blacklist check on
the given user, i.e. it checks if there is an entry in the BLACKLIST table for the personalId of given user.
If the BLACKLIST table contains an entry, that means the user is blacklisted.
This component adds a boolean value to the workflow result with key BLACK_LISTED indicating whether the user is blacklisted.
Possible outcomes are: BLACK_LISTED/NOT_BLACKLISTED

PerformBlackListCheckOnPersonID

Component name

PerformBlackListCheckOnPersonID

Class name

com.cdrator.fraud.component.PerformBlackListCheckOnPersonID

Description

Performs blacklist check on the User.
A PERSONALID parameter or context object is required for this component to work. This component performs blacklist check on
the given personID i.e. it checks if there is an entry in the BLACKLIST table for the personalId of given person.
If the BLACKLIST table contains an entry, that means the person is blacklisted.
This component adds a boolean value to the workflow context with key BLACK_LISTED indicating whether the person is blacklisted.
If the person is blacklisted the reason is added to the context with the key BLACK_LISTED_REASON
If no reason is given, then the parameter DEFAULT_REASON is given as the reason
Possible outcomes are: BLACK_LISTED/NOT_BLACKLISTED

PersistUpdatedUser

Component name

PersistUpdatedUser

Class name

com.cdrator.fraud.component.PersistUpdatedUser

Description

This component is used to persist the updated Users object.
A USERS Context Object is required for this component to work.
The updated Users object will be saved only if it is persistent.
If the user is not persistent, nothing happens.
Possible outcomes are: DONE

Fraud - Creditcheck

DoUseCachedCreditCheckResult

Component name

DoUseCachedCreditCheckResult

Class name

com.cdrator.fraud.creditcheck.component.DoUseCachedCreditCheckResult

Description

This component tells whether to use cached Credit Check result or to perform actual credit check.
A USERS Context Object is required for this component to work.
If a credit check has been run within a certain period, the result of that check will be returned.
This is done to minimize the number of requests to the credit check server.
The name of the parameter in the parameter tree which holds information concerning the period
back in time which should return the same result:
FRAUD.CREDITCHECK.APPROVED_PERIOD or FRAUD.CREDITCHECK.REJECTED_PERIOD
If the parameter tree entry for cache period is not defined/empty, the cached result is not used.
Possible outcomes are: YES/NO
Outcome YES means that cached result should be used.
Outcome NO means that actual credit check should be called.

Main - Account

CreateAccount

Component name

CreateAccount

Class name

com.cdrator.main.account.component.CreateAccount

Description

Creates a new account and adds it to the WfContext.
The account will be added to the context with key: "ACCOUNT".
The account type Id must be in the WfContext with key "ACCOUNT_TYPE".
If the context parameter "CUSTOMER_NUMBER" is defined, then that will be used when creating the account.
Outcome is
DONE

LinkAccountAndUserFromContext

Component name

LinkAccountAndUserFromContext

Class name

com.cdrator.main.account.component.LinkAccountAndUserFromContext

Description

Links an account and a User based on objects from the WfContext.
All objects are taken from the WfContext.
Outcome is
DONE

Main

CreateFullSubscriptionFromContext

Component name

CreateFullSubscriptionFromContext

Class name

com.cdrator.main.component.CreateFullSubscriptionFromContext

Description

Creates a full subscription based on objects from the WfContext.
All objects are taken from the WfContext.
Outcome is
DONE

CreateSubscriptionOnAccountAndBGFromContext

Component name

CreateSubscriptionOnAccountAndBGFromContext

Class name

com.cdrator.main.component.CreateSubscriptionOnAccountAndBGFromContext

Description

Creates a subscription on a given account and BillingGroup
This component creates a subscription on a given account and BillingGroup.

Optional activity parameters

A_NUMBER_REQUIRED - A_NUMBER_REQUIRED

Required context objects

ACCOUNT - ACCOUNT
BILLING_GROUP - BILLING_GROUP
NP_FLOW_INSTANCE - NP_FLOW_INSTANCE
PRODUCT_CONFIG - PRODUCT_CONFIG
PRODUCT_OPTIONS - PRODUCT_OPTIONS
SERVICE - SERVICE
SUBSCRIPTION - SUBSCRIPTION
USER - USER

Optional context objects

A_NUMBER - A_NUMBER
NP_FLOW - NP_FLOW
SALES_AGENT_ID - SALES_AGENT_ID
SALES_CHANNEL - SALES_CHANNEL

Possible outcomes

DONE - Outcome DONE when the the subscription has been created

Main - History

DynamicHistory

Component name

DynamicHistory

Class name

com.cdrator.main.history.component.DynamicHistory

Description

Creates a History entry for the Account Object which is referenced in the parameter "ACCOUNT" or exists in the Workflow Context.
The History entry will be created based on the mandatory parameters "DEFAULT_TEXT", "TRANSLATION_TAG" and all optional "LABEL" parameters.
It is also possible to set the Type and Object of the History entry by using the optional parameters "HISTORY_TYPE" and "HISTORY_OBJECT". If these parameters are not set the Type will be set to "Account" and the Object will be set to the Account Object.
It is possible to set the Type dynamically with parameter "HISTORY_TYPE_CONTEXT_KEY" which will override "HISTORY_TYPE".
It is possible to set the TranslationTag dynamically with parameter "TRANSLATION_TAG_CONTEXT_KEY" which will override "TRANSLATION_TAG".
It is mandatory for an Account object to exist. It can either be referenced in a parameter with the key "ACCOUNT" e.g. "ACCOUNT=BILLING_GROUP.getAccount" or exist as a Context Object with the key "ACCOUNT". The parameter has higher priority than the Context Object.
It is mandatory for a history text to exist. It can either be referenced in a parameter with the key "DEFAULT_TEXT" or exist as a Context Object with the key "HISTORY_TEXT". The parameter has lower priority than the Context Object.
The Outcome of this component is "DONE".
Parameters:
-------------------
DEFAULT_TEXT is the text of the entry which is shown in case the entry is not being translated based on the Translation Tag. The default text is always English and can be made up by static and dynamic information.
If the default text should only be a static text the value of the parameter should simply be a text string, e.g. "This is a History Entry".
If the default text should also contain dynamic information this can be done by using the "LABEL" parameters, e.g if a Phone Number should be in the default text, a parameter LABEL_PHONE_NUMBER should exist which can then be inserted in the default text using ¤PHONE_NUMBER¤. This could result in a default text which looks like this: "This is a History Entry for ¤PHONE_NUMBER¤".
This parameter is MANDATORY.
TRANSLATION_TAG is the tag that will be saved for the entry in order to be able to translate it into different languages. The translation tag should always be surrounded by "<" and ">", written in capital letters without whitespaces and contain a Unique ID, e.g. <HISTORY_TRANSLATION_TAG.201201081559140817>. For more info about Translation Tag naming convention see CDRator confluence.
All "LABEL" parameters defined will be added to the Translation Tag, e.g. if there is a parameter LABEL_PHONE_NUMBER the Translation Tag will be created with a dynamic label "PHONE_NUMBER" which is assigned the value of the label parameter.
This Parameter is MANDATORY.
TRANSLATION_TAG_CONTEXT_KEY is an alternative way of setting the tag of the entry. It overrides TRANSLATION_TAG parameter.
The tag is taken as a String from the context using this key, e.g. parameter is set "TRANSLATION_TAG_CONTEXT_KEY=TAG" and Context contains TAG="EmailPhone" then the tag of the entry would be the String "EmailPhone".
This Parameter is MANDATORY.
HISTORY_TYPE is the type of the entry. The history type should always be a text string, e.g. "Service" or "Service Option".
This parameter is OPTIONAL and has the default value "Account" in case it is not defined.
HISTORY_TYPE_CONTEXT_KEY is an alternative way of setting the type of the entry. It overrides HISTORY_TYPE parameter. The type is taken as a String from the context using this key, e.g. parameter is set "HISTORY_TYPE_CONTEXT_KEY=TYPE" and Context contains TYPE="Special" then the type of the entry would be the String "Special".
This parameter is OPTIONAL and has the default value "Account" in case it is not defined.
HISTORY_OBJECT is the object that is referenced in the entry.
The history object can either be a Context Object, e.g. "HISTORY_OBJECT=SERVICE", or method call that returns an Object, e.g. "HISTORY_OBJECT=SUBSCRIPTION.getService" and should always be a Persistent Object.
Normally the history object would match the history type, e.g. if the history type is set to "Service" the history object would be a Service Object.
This parameter is OPTIONAL and is default set to the Account object in case it is not defined.
LABEL parameters are used to insert dynamic information in the default text and translation tag. A label parameter is always named "LABEL_<NAME>" e.g. "LABEL_PHONE_NUMBER".
A label parameter can either be a text string, e.g. "LABEL_PHONE_NUMBER=55667788", a Context Object, e.g. "LABEL_PHONE_NUMBER=PHONE_NUMBER", or a method call, e.g. "LABEL_PHONE_NUMBER=SUBSCRIPTION.getService.getPhoneNumber".
Label parameters are OPTIONAL but need to exist if dynamic information is required in the history entry.

Main - Operator

GetAgentProfile

Component name

GetAgentProfile

Class name

com.cdrator.main.operator.component.GetAgentProfile

Description

Gets an agent profile.
The list will be available in the HookpointResult with key: "SOAP_GET_AGENT_PROFILE".
Possible input is:
PASSWORD
Possible outcomes are:
NO_OPERATOR_FOUND
DONE

Main - Service

ChangeServiceStatus

Component name

ChangeServiceStatus

Class name

com.cdrator.main.service.component.ChangeServiceStatus

Description

Method for changing the status on the Service.
The status is changed on the Service found in the Context for the workflow.

Required activity parameters

STATUS - The Service status being changed to.e.g Initial: 100; Active: 200; Blocked: 240; Deleted: 400; PendingBlocked: 225; PendingBlocked: 235

Required context objects

SERVICE - SERVICE context object

Possible outcomes

DONE - some description

ChangeServiceStatusToActive

Component name

ChangeServiceStatusToActive

Class name

com.cdrator.main.service.component.ChangeServiceStatusToActive

Description

Method for changing the status on the Service to Active.
The status is changed on the Service found in the Context for the workflow.
SERVICE context object is required.

ChangeServiceStatusToBlocked

Component name

ChangeServiceStatusToBlocked

Class name

com.cdrator.main.service.component.ChangeServiceStatusToBlocked

Description

Method for changing the status on the Service to Blocked.
The status is changed on the Service found in the Context for the workflow.
SERVICE context object is required.

ChangeServiceStatusToDeleted

Component name

ChangeServiceStatusToDeleted

Class name

com.cdrator.main.service.component.ChangeServiceStatusToDeleted

Description

Method for changing the status on the Service to Deleted.
The status is changed on the Service found in the Context for the workflow.

Required context objects

SERVICE - SERVICE context object

Possible outcomes

DONE - some description

ChangeServiceStatusToPendingBlocked

Component name

ChangeServiceStatusToPendingBlocked

Class name

com.cdrator.main.service.component.ChangeServiceStatusToPendingBlocked

Description

Method for changing the status on the Service to PendingBlocked.
The status is changed on the Service found in the Context for the workflow.
SERVICE context object is required.

ChangeServiceStatusToPendingUnBlocked

Component name

ChangeServiceStatusToPendingUnBlocked

Class name

com.cdrator.main.service.component.ChangeServiceStatusToPendingUnBlocked

Description

Method for changing the status on the Service to PendingUnBlocked.
The status is changed on the Service found in the Context for the workflow.
SERVICE context object is required.

CheckServiceStatus

Component name

CheckServiceStatus

Class name

com.cdrator.main.service.component.CheckServiceStatus

Description

Checks the Service status id.
Checks if the given status id matches the status id of the Service.If the status' matches the the outcome is: OK, if not then: NOT_OK

Required activity parameters

SERVICE_STATUS_ID - The Service status id to check the service for. The list can be comma separated.

Optional activity parameters

SERVICE_CONTEXT_KEY - The Context key to get the Service.

Optional context objects

SERVICE - The Service is required to be in context, but the context name is optional.

Possible outcomes

OK - When the Service status matches.
NOT_OK - When the Service status does not match.

UpdateNetworkICCAndPhoneNumber

Component name

UpdateNetworkICCAndPhoneNumber

Class name

com.cdrator.main.service.component.UpdateNetworkICCAndPhoneNumber

Description

Can update the network_icc and/or network_phonenumber on a teleservice.
The network_icc is the icc retreived from the simcard of the teleservice.
The network_phonenumber is updated with the service phone_number.To update network_icc, the teleservice must have a simcard.

Optional activity parameters

SERVICE_CONTEXT_KEY - An alternative context key to the teleservice object. Default: SERVICE
ICC - Should the NETWORK_ICC on the teleservice be updated. Default: true
PHONENUMBER - Should the NETWORK_PHONENUMBER on the teleservice be updated. Default: true

Required context objects

SERVICE - The teleservice on which NETWORK_ICC and/or NETWORK_PHONENUMBER will be updated

Possible outcomes

UPDATED - The NETWORK_ICC and/or NETWORK_PHONENUMBER was updated

Unknown package

CompareOptionStatuses

Component name

CompareOptionStatuses

Class name

com.cdrator.main.service.option.CompareOptionStatuses

Description

Will verify that there are not any serviceOptions, in the wrong status, that are to change
All service options status ids in the two lists, NEW_OPTIONS_LIST_CONTEXT and REMOVE_OPTIONS_LIST_CONTEXT, will be compared against a white list. Only if all service options have the correct status, will the verification be successfull. The white list is defined in the parameter tree as a comma seperated string value called OPTIONS.CHANGE.ALLOW_CHANGE_STATUS_ID_LISTIf the list is undefined or empty, verifycation will be successfull.

Required activity parameters

NEW_OPTIONS_LIST_CONTEXT - the context key for the list of new product options to subscribe
REMOVE_OPTIONS_LIST_CONTEXT - the context key for the list of product options to remove

Possible outcomes

SUCCESS - if service options, in either context list, pass status check or if no lists are specified
FAILED - if at least one service options, in either context list, dont pass status check

Main - Subscription

ActivateSubscription

Component name

ActivateSubscription

Class name

com.cdrator.main.subscription.component.ActivateSubscription

Description

This component will activate a subscription.
A subscription is required in the context for this component to work. This component will only activate the subscription in Rator. It will set the status and end date on the subscription. By default the start date will be set to now, but can be changed by adding another date into the context with the key SUBSCRIPTION_START_DATE.
Outcome is activated.

AddInitialSubscriptionFees

Component name

AddInitialSubscriptionFees

Class name

com.cdrator.main.subscription.component.AddInitialSubscriptionFees

Description

This component will add initial subscription fees.
A subscription is required in the context for this component to work. This component will add initial fees to a subscription when activating the customer.
Outcome is ADDED.

AddSingleChargeToSubscription

Component name

AddSingleChargeToSubscription

Class name

com.cdrator.main.subscription.component.AddSingleChargeToSubscription

Description

Adds a charge of a variable amount to a subscription
Adds a charge of a variable amount to a subscription. The charge is added immediately and is independent of any Charge Engine.
The component needs a charge-item but will override the description and amount by the values in context.
Should use method on Subscription_ class, but this is available in core version 8.3.

Required context objects

SUBSCRIPTION - Customers Subscription
CHARGE_ITEM - Charge Item to put the charge in the correct charge item group.
DESCRIPTION - Description going on the invoice detail line.
AMOUNT - Amount to charge the customer. May be positive or negative.

Possible outcomes

DONE - When charge is added

AddSubscriptionTerminationFee

Component name

AddSubscriptionTerminationFee

Class name

com.cdrator.main.subscription.component.AddSubscriptionTerminationFee

Description

This component will add a termination fee to a subscription.
A subscription is required in the context for this component to work. This component will add a termination fee to a subscription.
Outcome is ADDED.

AddSubscriptionToContext

Component name

AddSubscriptionToContext

Class name

com.cdrator.main.subscription.component.AddSubscriptionToContext

Description

adds the subscription to context with the specified id.
retreives the subscription with the specified id and adds it to context with the name: SUBSCRIPTION.

Required context objects

SUBSCRIPTION_ID - the id for the subscription to add.

Possible outcomes

DONE - when subscription is added successfully.

ChangeFeeDate

Component name

ChangeFeeDate

Class name

com.cdrator.main.subscription.component.ChangeFeeDate

Description

This component will add a termination fee to a subscription.
A subscription is required in the context for this component to work. This component will alter the start date on the package fee by a given amount of workdays. The parameter DAYS_TO_ADD must be available and parseable as a positive integer.
Outcome is DONE

CheckEndDate

Component name

CheckEndDate

Class name

com.cdrator.main.subscription.component.CheckEndDate

Description

This component will check the end date of a subscription.
A subscription is required in the context for this component to work. This component will check the end date on the subscription. If the endDate > today, outcome TERMINATE is returned.
If the endDate < today, outcome WAIT is returned.
If the endDate is null, outcome REACTIVATED is returned.

CreateSubscription

Component name

CreateSubscription

Class name

com.cdrator.main.subscription.component.CreateSubscription

Description

Creates a new subscription and adds it to the WfContext.
The subscription will be added to the context with key "SUBSCRIPTION"
The product config must be in the WfContext with key "PRODUCT_CONFIG"
The account must be in the WfContext with key "ACCOUNT"
The brand is an optional parameter in the context with key BRAND.
If there is already a subscription in the context it will be persisted.
Is possible to set the context key where to check for existing subscription by setting the parameter SUBSCRIPTION_CONTEXT_KEY.
Is possible to set the ProductId on subscription by setting the optional parameter SET_PRODUCT_IDto Y.
Is possible to set the CustomerType on subscription by setting the optional parameter CUSTOMER_TYPE.
Outcome is
DONE

GetCustomerInfo

Component name

GetCustomerInfo

Class name

com.cdrator.main.subscription.component.GetCustomerInfo

Description

Based on a subscription from context it adds the ownerUser and billingGroup to the context.
OwnerUser and BillingGroup objects are wrapped in a hashmap with key $OBJ which SOAP API framework handles.
The ownerUser is available in the context with key USER.
The billing group is available in the context with key BILLING_GROUP.
Outcome is
DONE

GetSubscriptionStatus

Component name

GetSubscriptionStatus

Class name

com.cdrator.main.subscription.component.GetSubscriptionStatus

Description

Returns the status of the SUBSCRIPTION object in the context.
Typical status returned could be 'Initial', 'Active', 'Cancellation pending' or 'Terminated',
but this could depend on customer configuration, please check STATUS table to get a complete list of Subscription statuses.

SaveSubscription

Component name

SaveSubscription

Class name

com.cdrator.main.subscription.component.SaveSubscription

Description

Save subscription
Makes deep save of subscription

Required context objects

SUBSCRIPTION - Subscription

Possible outcomes

DONE - Subscription saved

SetSubscriptionStatusActive

Component name

SetSubscriptionStatusActive

Class name

com.cdrator.main.subscription.component.SetSubscriptionStatusActive

Description

Update the subscription status to active.
A SUBSCRIPTION object is required in the context for this component to work.
Outcome is STATUS_CHANGED

SetSubscriptionStatusCancellationPending

Component name

SetSubscriptionStatusCancellationPending

Class name

com.cdrator.main.subscription.component.SetSubscriptionStatusCancellationPending

Description

Updates the subscription status to cancellation pending.
A SUBSCRIPTION object is required in the context for this component to work.
Outcome is STATUS_CHANGED.

SubCheckTerminationReason

Component name

SubCheckTerminationReason

Class name

com.cdrator.main.subscription.component.SubCheckTerminationReason

Description

This component will check the Termination Reason and can return a different outcome depending on the Reason.
Based on the Activity Parameter "OUTCOME_<TERMINATION_REASON>" the outcome is determined, e.g. If the Termination Reason is "REGRET" the component will look for an Activity Parameter "OUTCOME_REGRET".
The value of the "OUTCOME_REGRET" parameter will then be used as the outcome.
If no Outcome Parameter can be found for the Termination Reason the Parameter "OUTCOME_DEFAULT" will be used.
Optional parameter DEFAULT_REASON can be used to set a default reason id in case it's null.
A SUBSCRIPTION Context Object is expected for this component to work.
Possible outcomes are what is defined in the Activity Parameter.

SubscriptionHasActiveChild

Component name

SubscriptionHasActiveChild

Class name

com.cdrator.main.subscription.component.SubscriptionHasActiveChild

Description

This component will check if the subscription has an active child subscription on the current date.
A subscription is required in the context for this component to work. This component will use the Subscription Group Member to determine if the subscription has an active child.
Possible Outcomes are: YES, NO

SubscriptionHasParent

Component name

SubscriptionHasParent

Class name

com.cdrator.main.subscription.component.SubscriptionHasParent

Description

This component will check if the subscription has a parent on the current date.
A subscription is required in the context for this component to work. This component will use the Subscription Group Member to determine if the subscription has a parent.
Possible Outcomes are: YES, NO

SubscriptionHasRatePlan

Component name

SubscriptionHasRatePlan

Class name

com.cdrator.main.subscription.component.SubscriptionHasRatePlan

Description

Checks if a subscriptions current rate plan is the same as the specified rate plan.
Compares the subscriptions current rate plan with the rate plan in context, by comparing the rte plan keys to determine if they are identical.

Required context objects

SUBSCRIPTION - the subscription to check against.
RATEPLAN - the new rate plan to check.

Possible outcomes

YES - If the rate plans are identical
NO - If the rate plans are different

SubscriptionHasSpecificRatePlan

Component name

SubscriptionHasSpecificRatePlan

Class name

com.cdrator.main.subscription.component.SubscriptionHasSpecificRatePlan

Description

Checks if subscription has specific rate plan
Checks if subscription's rate plan has the rate_plan_key in a predefined list of rate plan keys

Required activity parameters

RP_KEY - The comma separated list of the predefined rate_plan_keys to be compared to the rate_plan.rate_plan_key

Required context objects

SUBSCRIPTION - SUBSCRIPTION context object

Possible outcomes

YES - Outcome YES when the rate_plan.rate_plan_key was found in the predefined list
NO - Outcome NO when the rate_plan.rate_plan_key was not found in the predefined list

SubscriptionParentActive

Component name

SubscriptionParentActive

Class name

com.cdrator.main.subscription.component.SubscriptionParentActive

Description

This component will check if the subscription has a parent and if it is active.
A subscription is required in the context for this component to work. This component will use the Subscription Group Member to determine if the subscription parent is active.
Possible Outcomes are: YES, NO

TerminateSubscription

Component name

TerminateSubscription

Class name

com.cdrator.main.subscription.component.TerminateSubscription

Description

This component will terminate a subscription.
A subscription is required in the context for this component to work. This component will only terminate the subscription in Rator. It will set the status to terminated on the subscription.
Outcome is DONE

TerminationType

Component name

TerminationType

Class name

com.cdrator.main.subscription.component.TerminationType

Description

Return the termination type.A SUBSCRIPTION object is needed in the context.
Outcomes can be: NO_TERMINATION if there is no end date, OUTPORT_TERMINATION if the service is outported or NORMAL_TERMINATION otherwise.

Main - Subscription - Lockin

HasSubscriptionLockin

Component name

HasSubscriptionLockin

Class name

com.cdrator.main.subscription.lockin.component.HasSubscriptionLockin

Description

Checks if the subscription has lockin.
Checks if the subscription has lockin.

Required context objects

SUBSCRIPTION - Subscription to be checked.

Possible outcomes

YES - When subscription has lockin.
NO - When subscription has no lockin.

Main - User

CheckUsernameAvailability

Component name

CheckUsernameAvailability

Class name

com.cdrator.main.user.component.CheckUsernameAvailability

Description

Check username availability.
Checks if the username (which is an email) is available.
The list will be available in the HookpointResult with key: "SOAP_CHECK_USERNAME_AVAILABILITY".
Possible input is
USERNAME
Possible outcomes are:
FAILED_TO_CHECK_USERNAME
DONE

CreateUser

Component name

CreateUser

Class name

com.cdrator.main.user.component.CreateUser

Description

Creates a user and adds it to the WfContext.
The user will be added to the context with key "USER".
If the context contains a "PASSWORD", this is assigned to the user.
To use a user which is already in the context with key: "USER" set the parameter "USER_ALREADY_IN_CONTEXT" = "Y"
Outcome is
DONE

Np

AddNpFlowInfoToHPR

Component name

AddNpFlowInfoToHPR

Class name

com.cdrator.np.component.AddNpFlowInfoToHPR

Description

NpFlow info added to context.
This component adds all active NP flows for a given user to the hookpoint result.

Optional activity parameters

USER_CONTEXT_KEY - The context key that contains the user in question

Optional context objects

USERS - the default context object that contains the user in question. If the USER_CONTEXT_KEY parameter is set, this will change. A user object is MANDATORY

Possible outcomes

DONE - outcome when all flows have been found and passed to the hookpoint result

CreateNpFlow

Component name

CreateNpFlow

Class name

com.cdrator.np.component.CreateNpFlow

Description

Creates an NpFlow and adds it to the context.
The NpFlow will be added to the context with key "NP_FLOW_INSTANCE".
By default an instance of com.CDRator.billing.np.NpFlow is created.
To override this set the parameter: "NP_FLOW_CLASS_NAME" to fully qualified NpFlow class name.
Outcome is
DONE

FindService

Component name

FindService

Class name

com.cdrator.np.component.FindService

Description

Search the service for the NP export based on the NP phone number and donor network operator.
If the service is found the NP flow object is updated with the subscription ID.

Optional activity parameters

REJECT_CODE - The reject code to set to the NP flow in case the service is not found. If the parameter is not set the default reject is 44 (unknown MSISDN).

Required context objects

NP_FLOW - The NP for which the service will be searched.

Possible outcomes

NOT_FOUND - If the service is not found.
FOUND - If the service is found and the NP is updated.

GetTeleOperators

Component name

GetTeleOperators

Class name

com.cdrator.np.component.GetTeleOperators

Description

Retrieving tele operators
This component gets all active tele operators if activity parameter FILTER is not provided. If parameter FILTER is provided then this value will be used to filter Tele Operator. Remark that the value of parameter must be provided in the context. Eg. if the parameter FILTER is 'OPERATOR_CODE' then context with name 'OPERATOR_CODE' within some value must be provided. And result will be put into hookpoint result TELE_OPERATORS

Optional activity parameters

FILTER - Filtering name

Possible outcomes

FOUND - Tele operators found
NOT_FOUND - Tele operators not found

NpFlowIsInStatus

Component name

NpFlowIsInStatus

Class name

com.cdrator.np.component.NpFlowIsInStatus

Description

This component will check if the noFlow has a set status id.
The id of the status to be checked, must be in the parameters as "STATUS_ID", the npflow must be in context with the key "NPFLOW".

Required activity parameters

STATUS_ID - The id to check if the status is in.

Required context objects

NPFLOW - The npFlow to check the status on.

Possible outcomes

YES - If the npFlow is in the checked status.
NO - If the npFlow is not in the checked status.

NpSetSubscription

Component name

NpSetSubscription

Class name

com.cdrator.np.component.NpSetSubscription

Description

This component will set the subscriptionId on an NPFlow.
A NPFLOW Context Object and a SERVICE context object are required.
Possible outcomes are: DONE

UpdateNpFlowStatus

Component name

UpdateNpFlowStatus

Class name

com.cdrator.np.component.UpdateNpFlowStatus

Description

Update NP Flow Case and/or Status id
either with context: NPFLOW_STATUS_ID or activity parameter: STATUS_ID
and/or with context: NPFLOW_CASE_STATUS_ID or activity parameter: CASE_STATUS_ID
and if optional activity parameter: SET_SIGNUP_DATE is set to Y then signupDate will set to current date on NPFLOW

Optional activity parameters

STATUS_ID - NP Flow status id
CASE_STATUS_ID - NP Flow case status id
SET_SIGNUP_DATE - NP Flow signup date

Required context objects

NPFLOW - NPFlow

Optional context objects

NPFLOW_STATUS_ID - NPFlow status id
NPFLOW_CASE_STATUS_ID - NPFlow case status id

Possible outcomes

DONE - NP Flow case and/or status id has been updated

WfCNPCreateANumber

Component name

WfCNPCreateANumber

Class name

com.cdrator.np.component.WfCNPCreateANumber

Description

This component creates a aNumber from a NPFlow.
Requires a NpFlow in context with the key "NPFLOW". Adds the ANumber object to context with the key "NEWANUMBER". Will throw a workflowException if the network operator of the anumberGroup from the subscription on the npFlow does not exist.

Np - De

GetServiceFromNpFlow

Component name

GetServiceFromNpFlow

Class name

com.cdrator.np.de.component.GetServiceFromNpFlow

Description

Retrieve the Service for the given NpFlow and add it to the context.
the Service will be put in the WfContext with key SERVICE

Optional activity parameters

NPFLOW_CONTEXT_KEY - The context object NpFlow's key if not default.

Required context objects

NP_FLOW - The NpFlow should be in context.

Possible outcomes

OK - When Service is found and added to context.

Number

BookAnumber

Component name

BookAnumber

Class name

com.cdrator.number.component.BookAnumber

Description

Book a A-number to a given service.
Book a A-number to a given service.

Optional activity parameters

ANUMBER_CONTEXT_KEY - It is used when to retrieve the A-Number from the context.
SERVICE_CONTEXT_KEY - It is used when to retrieve the Service from the context.
SUSPEND_OLD_ANUMBER - It is used when the old anumber status should be changed/suspended. PossibleValues are Y or N.Default is: Y

Required context objects

ANUMBER - The A-Number group that must be booked to the service.
SERVICE - The service to which that the A-Number must be booked.

Optional context objects

SUSPEND_PERIOD - Suspend period of the A_number.

Possible outcomes

DONE - When anumber is booked.
NOT_BOOKED - When anumber is not booked.

BookAnumberToTeleService

Component name

BookAnumberToTeleService

Class name

com.cdrator.number.component.BookAnumberToTeleService

Description

This component will change the a-number of a service.
An a-number and a teleService is required in the context for this component to work. Also, a suspendPeriod (Long) is required. This component will only change the a-number in Rator. It will set the status to In Use and assignedToServiceId to the ID of the service on the a-number and also update the phone number on the TeleService The old a-number will be put in reservation for X number of months where X = suspendPeriod.
Outcome is DONE.

CreateAnumber

Component name

CreateAnumber

Class name

com.cdrator.number.component.CreateAnumber

Description

Create a A-number in a given A-number group.
If the A-Number already exists nothing is done
Required context objects:
ANUMBER_GROUP: The A-Number group in which the a-number must be created.
ANUMBER: The phone number that the anumber must be created from. Type is string.
Optional activity parameter:
PHONE_NUMBER_CONTEXT_KEY: key used to retrieve the phone number from the context. Default is: ANUMBER
ANUMBER_CONTEXT_KEY: key used when the ANumber object is added to the context. Default is: ANUMBER
IGNORE_EXISTING_ANUMBER: used when the existing ANumber should be ignored. Default is: N
Outcomes are:
DONE
NOT_CREATED

FreeANumber

Component name

FreeANumber

Class name

com.cdrator.number.component.FreeANumber

Description

Reserve the number for a period of time so it can be reused after that or set the status to outported.
In special cases where the service no longer has the A-number assigned, then no change is done to the A-number.

Optional activity parameters

ANUMBER_RESERVE_MONTHS - The number of months to reserve the A-number before it can be reused. Only used when the service is not outported.

Required context objects

SUBSCRIPTION - The subscription which has the service which has the A-number assigned to be freed

Possible outcomes

DONE - When A-number has been freed.

GetAnumberGroup

Component name

GetAnumberGroup

Class name

com.cdrator.number.component.GetAnumberGroup

Description

This component will retrieve an a-number group and add it to the context.
The NetworkOperator must be in the WfContext with key "NETWORK_OPERATOR".
The parameter MARKETING_TYPE has to be set on the activity.
Possible outcomes are:
DONE

GetANumberGroups

Component name

GetANumberGroups

Class name

com.cdrator.number.component.GetANumberGroups

Description

Retrieves A-number groups.
This component will retrieve the list of A-number groups.
The list will be available in the context with key: "ANUMBER_GROUPS".
The PRODUCT must be in the WfContext with key "PRODUCT".
The RATEPLAN must be in the WfContext with key "RATEPLAN".
Possible outcomes are:
NO_ANUMBER_GROUPS_FOUND
DONE

GetANumbers

Component name

GetANumbers

Class name

com.cdrator.number.component.GetANumbers

Description

Retrieves A-Numbers.
This component will retrieve the list of phonenumbers according to the group_id.
Required context parameters are: ANUMBER_GROUP, SEARCH_METHOD (Long), PATTERN (String), COUNT (Long).
The context key ANUMBER_GROUP can be custormized by setting activity parameter ANUMBER_GROUP_KEY.
Default key value is: "ANUMBER_GROUP"
For SEARCH_METHOD 1-3 PATTERN is required. COUNT must be higher than 0.
The list will be available in the context with key: "PHONE_NUMBERS"
Available search methods are:
0 - random
1 - exact match of the pattern
2 - contains the pattern
3 - ending with the pattern
Possible outcomes are:
INVALID_SEARCH_PARAMETERS
NO_NUMBERS_FOUND
DONE

GetRandomAnumber

Component name

GetRandomAnumber

Class name

com.cdrator.number.component.GetRandomAnumber

Description

Find a random anumber from given Anumber Group.
Find a random anumber from given Anumber Group and add to context (the network operator is considered)

Optional activity parameters

ANUMBER_GROUP_CONTEXT_KEY - The context object Anumber Group's key if not default.
ANUMBER_CONTEXT_KEY - The context object Anumber's key if not default.

Required context objects

ANUMBER_GROUP - The Anumber Group should be in context.

Possible outcomes

OK - When Anumber is found and added to context.

ReserveAnumber

Component name

ReserveAnumber

Class name

com.cdrator.number.component.ReserveAnumber

Description

Reserves an A-number.
This component will reserve an a-number for a specified period of time and returns the reservationId.
If no RESERVE_TIME is found in the context, an activity parameter (DEFAULT_RESERVATION_TIME) is looked up for the value.
If the activity parameter value is not set default reserve time will be: 15
Required context parameters:
ANUMBER: A-number entity()
Optional context parameters:
ANUMBER_CONTEXT_KEY:Anumber Context Key
RESERVE_TIME (Long): # of minutes
The reservation id will be available in the context with key: "RESERVATION_ID"
USE_EXISTING_SERVICE: flag that indicates that the anumber should be reserved to the existing Service present in the context.If the parameter value is Y then the anumber is reserved to existing Service in the context.
SERVICE_CONTEXT_KEY: the Service context object key used to retrieve the Service from the context.It is mandatory and used only if the parameter USE_EXISTING_SERVICE is set to the value Y
Possible outcomes are:
ANUMBER_NO_LONGER_AVAILABLE
DONE

ReserveRandomAnumber

Component name

ReserveRandomAnumber

Class name

com.cdrator.number.component.ReserveRandomAnumber

Description

Finds a random A-number, reserves it and adds it to context.
The component will find an a-number from a configured A-number group and try to reserve it before adding it to the context.
If the reservation fails, it will try with a different a-number.
It is configurable how many a-numbers which will be tried if reservation is unsuccessful.
The A-number is added to the context with key: "ANUMBER". To override this, set activity parameter: "ANUMBER_CONTEXT_KEY"
The A-number groups from which to take random numbers are: "Normal". To override this, set activity parameter: "ANUMBER_GROUP_NAME" (comma seperated list if more than one group)
The number of attempts to try to reserve an anumber is: "3". To override this, set activity parameter: "RESERVATION_ATTEMPTS" (integer parsable value)
The number of minutes that the reservation should be valid is: "15". To override this, set activity parameter: "RESERVATION_MINUTES" (integer parsable value)
The component will find anumber groups by: "NAME". To override this, set activity parameter: "SEARCH_KEY" (string value)
By default the component will not check the brand of the anumber group.To override this, set activity parameter: "CHECK_BRAND" (Y)
Possible outcomes are:
UNABLE_TO_RESERVE_ANUMBER
DONE

ValidatePhoneNumber

Component name

ValidatePhoneNumber

Class name

com.cdrator.number.component.ValidatePhoneNumber

Description

Checks if there is an a-number for a given phone number.
This component will locate the a-number for a given PHONE_NUMBER (String).
By default it only validates the existence of an a-number for the PHONE_NUMBER.
Configurations:
Key: ADD_ANUMBER_TO_CONTEXT Value: Y: adds the ANUMBER to the context with default key ANUMBER.
Key: CONTEXT_KEY Value: SOME_CONTEXT_KEY: adds the ANUMBER to the context with key SOME_CONTEXT_KEY.
Required context parameter: PHONE_NUMBER (String)
Possible outcomes are:
ANUMBER_NOT_FOUND
DONE

ValidateReservationAndAddANumberToContext

Component name

ValidateReservationAndAddANumberToContext

Class name

com.cdrator.number.component.ValidateReservationAndAddANumberToContext

Description

Validates the phone number and reservationId and adds the A-Number to the context.
The validation is done according the the product config in the context.
The A-Number will be added to the context with the key "A_NUMBER".
The phone number must be in the context with the key "MSISDN".
The reservationId if it exists must be in the context with key "RESERVATION_ID".
Outcome is
RESERVATION_MSISDN_MISMATCH
DONE

Persistence

LoadObjectIntoContext

Component name

LoadObjectIntoContext

Class name

com.cdrator.persistence.component.LoadObjectIntoContext

Description

Loads a persistent object using id and adds it into the context.
The Activity Parameter "ID_KEY" represents the context key that should be used for retrieving from the context the database id of the persistent object.
The Activity Parameter "CLASS_NAME" represents the fully qualified name of the persistent object's class.
The Activity Parameter "CONTEXT_KEY" represents the context key that should be used for adding(saving) the persistent object into the context.
Outcome is DONE

Unknown package

AlertGroupReader

Component name

AlertGroupReader

Class name

com.cdrator.product.alertgroup.AlertGroupReader

Description

Add Alert Group To Context
Loads an alert group from DB based on ALERT GROUP ID and adds it to the context with key ALERT_GROUP.

Required activity parameters

ALERT_GROUP_ID - Id of the alert group to load

Possible outcomes

DONE - When Alert Group Is Added
NOT_FOUND - When alert group was not loaded

Product

AddProductConfigByCodeToContext

Component name

AddProductConfigByCodeToContext

Class name

com.cdrator.product.component.AddProductConfigByCodeToContext

Description

Finds and adds the product config to the WfContext.
This component will retrieve the product config given that a product code is present in the context.
The product code must be either in the activity parameters or in the WfContext with key "PRODUCT_CODE".
Outcome is
DONE

GetProductConfigs

Component name

GetProductConfigs

Class name

com.cdrator.product.component.GetProductConfigs

Description

Retrieves all product configurations.
This component will retrieve the list of product configurations available.
The list will be added to the context with key: "PRODUCT_CONFIGS".
Possible outcomes are:
NO_PRODUCT_CONFIGS_FOUND
DONE

ProductMakeChildSubscription

Component name

ProductMakeChildSubscription

Class name

com.cdrator.product.component.ProductMakeChildSubscription

Description

Makes a new subscription based on a given product
Makes a new subscription based on a given product. The subscription is not persisted. The new subscription will be pointing to the same account and rateplan as the provided subscription.

Optional activity parameters

SUBSCRIPTION - The key of the parent subscription
NEW_SUBSCRIPTION - The key of the new sub subscription

Required context objects

SUBSCRIPTION - The customers Subscripton
PRODUCT - The product on which the new Subscription should be signed up.

Possible outcomes

DONE - When the subscription is generated as expected

ProductMakeSubscription

Component name

ProductMakeSubscription

Class name

com.cdrator.product.component.ProductMakeSubscription

Description

Makes a new subscription based on a given product option
Makes a new subscription based on a given product option. The subscription is not persisted. The new subscription will be pointing to the same account and rateplan as the provided subscription.

Required activity parameters

METADATA_KEY - The metadata key containing the link to the product being subscribed.

Optional activity parameters

SUBSCRIPTION - The key of the parent subscription
OPTION - The option key
NEW_SUBSCRIPTION - The key of the new sub subscription

Required context objects

SUBSCRIPTION - The customers Subscripton

Possible outcomes

DONE - When the subscription is generated as expected

Product - Option

ActivateExtraCampaigns

Component name

ActivateExtraCampaigns

Class name

com.cdrator.product.option.component.ActivateExtraCampaigns

Description

This component is used to activate extra campaigns related to product option.
Extra Campaign should be linked to product option by product_option_meta_data.(name should start with CAMPAIGN_ and value is CampaignKey.)
Mandatory Context Objects:SERVICE_OPTION(Or Defined by parameter SERVICE_OPTION_CONTEXT_KEY): the new service option.START_DATE: the starting date of the SubscriptionCampaign.
Optional parameters:SERVICE_OPTION_CONTEXT_KEY: The service option is found in the context via the key defined in this parameter.Default service option CONTEXT_KEY is SERVICE_OPTION.
Possible outcome is: DONE

AddMetaDataFromServiceOptionToContext

Component name

AddMetaDataFromServiceOptionToContext

Class name

com.cdrator.product.option.component.AddMetaDataFromServiceOptionToContext

Description

This component expects a service option set in the context already. It finds this service option's product option and adds the meta data with the name defined by the activity parameter: META_DATA_NAME to the context. It uses the meta data name as the context key.

AddSelectedSubOptionToContext

Component name

AddSelectedSubOptionToContext

Class name

com.cdrator.product.option.component.AddSelectedSubOptionToContext

Description

Component to add selected sub service option to context
Finds and adds the selected service option which is a sub option of the product option with a pre-defined OPTION_KEY. The option key is defined in a parameter value called OPTION_KEY

Required activity parameters

OPTION_KEY - The option key of the option to find.

Optional activity parameters

USE_OPTION_IN_CONTEXT - If this is Y an option will be taken from context instead of the database

Required context objects

SUBSCRIPTION - The subscription, the service option is subscriped to.

Optional context objects

OPTION_KEY - Option to find the suboption from. Required if USE_OPTION_IN_CONTEXT is set to Y

Possible outcomes

DONE - If the sub option is added succesfully.
FAILED - If the sub option is not added.

AddServiceOptionParameterToContext

Component name

AddServiceOptionParameterToContext

Class name

com.cdrator.product.option.component.AddServiceOptionParameterToContext

Description

Adds service option parameter to context.
Service option parameter is added into the context with service option parameter's key as context key.

Required activity parameters

OPTION_KEY - Option key for which the parameter has to be fetched for.
OPTION_PARAMETER_KEY - Option parameter key for which the parameter has to be fetched.

Possible outcomes

FOUND - When service option parameter is found.
NOT_FOUND - When service option parameter is not found.

CheckIfShouldBeProvisioned

Component name

CheckIfShouldBeProvisioned

Class name

com.cdrator.product.option.component.CheckIfShouldBeProvisioned

Description

Checks if at least one of the specified service options should be provisioned.
For each service option that should be checked it is required to configure an activity parameter whose key starts with SERVICE_OPTION and the value is the context key of the service option.
The activity parameters' values specify the context keys of the service options which might be in workflow context and should be checked.
If the declared key as activity parameter is not in the workflow context, then a proper exception is thrown.
If at least one of the specified and found service options in the context should be provisioned then the component's outcome is: YES, else it is NO

CleanUpActivationPendingOption

Component name

CleanUpActivationPendingOption

Class name

com.cdrator.product.option.component.CleanUpActivationPendingOption

Description

This component is used for cleaning up the activation pending option,including its campaigns and fees.
The Activity Parameter "REFUND_NOW" is optional: It is used to determine if subscriptionFees should be refunded immediately.
Possible values: Y/N
Mandatory Context Objects:
NEW_OPTION: The active pending service option.
Possible outcome is: DONE

ContainsMandatoryOptionsForRatePlan

Component name

ContainsMandatoryOptionsForRatePlan

Class name

com.cdrator.product.option.component.ContainsMandatoryOptionsForRatePlan

Description

Checks if the list of options contains an option that is mandatory for the given rate plan.
Checks if the list of options contains an option that is mandatory for the given rate plan.

Required context objects

RATE_PLAN - the rate plan to check the product options against.
PRODUCT_OPTION_IDS - a list of product option ids.

Possible outcomes

YES - if there is just on mandatoey option in the list.
NO - if there is no mandatory option in the option list.

GetProductOptions

Component name

GetProductOptions

Class name

com.cdrator.product.option.component.GetProductOptions

Description

Uses product and rate plan to get a list of available product options
Uses product and rate plan to filter a list of available product options and store the list in the hookpoint result with the key: PRODUCT_OPTIONS

Required context objects

PRODUCT - to filter avaliable product options
RATE_PLAN - to filter avaliable product options

Possible outcomes

DONE - if the product options have been successfully added to context

IsOptionActive

Component name

IsOptionActive

Class name

com.cdrator.product.option.component.IsOptionActive

Description

Checks if a given service option is active
Checks if a given service option is active for a given customer

Required context objects

PRODUCT_OPTION - Option to check for active status for given customer
SUBSCRIPTION - Subscription of the customer who has the given option

Possible outcomes

TRUE - if option is active
FALSE - If option is inactive

ReActivateServiceOption

Component name

ReActivateServiceOption

Class name

com.cdrator.product.option.component.ReActivateServiceOption

Description

Re-activates a service option.
The date in the field End Date will be removed and the Status changed to Active (20).
A service_option is required in the context.
The value of the context key should be:
OPTION
OR the value defined in the activity parameter
SERVICE_OPTION_CONTEXT_KEY
If the parameter REACTIVATE_CAMPAIGN Is set to YES, the attached campaign will be reactivated.
Outcome is:
DONE

ScheduleFeesTerminationAtOptionEndDate

Component name

ScheduleFeesTerminationAtOptionEndDate

Class name

com.cdrator.product.option.component.ScheduleFeesTerminationAtOptionEndDate

Description

Schedule the service option fees' termination at service_option.end_date
The activity should have the parameter SERVICE_OPTION_CTX_KEY which represents the service option workflow context key.
A context object having the key equalling the activity parameter SERVICE_OPTION_CTX_KEY value is required for this component to work.
Outcome is DONE

ScheduleNewOption

Component name

ScheduleNewOption

Class name

com.cdrator.product.option.component.ScheduleNewOption

Description

This component is used for scheduling starting days for campains and fees related to the new service option.
The Activity Parameter "CHARGE_NOW" is mandatory: It is used to determine if subscriptionFees should be charged immediately.
Possible values: Y/N
The Activity Parameter "SAVE_NOW" is optional: It is used to determine if new service option should be save immediately.
Possible values: Y/N
Mandatory Context Objects:
NEW_OPTION: The new service option
START_DATE: DATE TYPE, the new option starting date
END_DATE: DATE TYPE, the old option ending date)
Possible outcome is: DONE

ScheduleTerminationForCurrentOption

Component name

ScheduleTerminationForCurrentOption

Class name

com.cdrator.product.option.component.ScheduleTerminationForCurrentOption

Description

This component is used for scheduling campaign and fee ending dates for the current service option.
The Activity Parameter "REFUND_NOW" is mandatory: It is used to determine if subscriptionFees should be refunded immediately.
Possible values: Y/N
Mandatory Context Objects:
SUBSCRIPTION
OPTION: the new service option
START_DATE: DATE TYPE, the new option starting date
END_DATE: DATE TYPE, the old option ending date
Optional Context Object: OLD_OPTION
Possible outcome is: DONE

SubscribeToOption

Component name

SubscribeToOption

Class name

com.cdrator.product.option.component.SubscribeToOption

Description

Subscribes to a product option defined by a product option key or ID in the parameters

Optional activity parameters

PRODUCT_OPTION_KEY - Key of the Product Option that should be assigned
PRODUCT_OPTION_ID - ID of the Product Option that should be assigned

Required context objects

SERVICE - The service to assign the new option

Possible outcomes

DONE - When the option has been assigned to the service

SubscribeToProductOption

Component name

SubscribeToProductOption

Class name

com.cdrator.product.option.component.SubscribeToProductOption

Description

Subscribes to a product option defined by a product option key in the parameter

Required activity parameters

PRODUCT_OPTION_KEY - Key of the Product Option that should be assigned

Required context objects

SERVICE - The service to assign the new option

Possible outcomes

DONE - When the option has been assigned to the service

SubscribeToProductOptions

Component name

SubscribeToProductOptions

Class name

com.cdrator.product.option.component.SubscribeToProductOptions

Description

Subscribes product options
Subscribes all product options which are in the context PRODUCT_OPTIONS to a SERVICE

Required context objects

PRODUCT_OPTIONS - ProductOptions which will be added
SERVICE - Service which product options will be added to

Possible outcomes

DONE - Product options has been subscribed.
PRODUCT_OPTION_NOT_FOUND - Product option not found.
FAILED_TO_SUBSCRIBE_PRODUCT_OPTIONS - Falied to subscribe to product options.

UpdateChangeDate

Component name

UpdateChangeDate

Class name

com.cdrator.product.option.component.UpdateChangeDate

Description

This component is used for updating service option change dates.
The new option StartDate is decided as follows:(reset to 0 hour 0 min).
If Context Object "START_DATE" is given, this date is used;
Otherwise if Activity Parameter "START_NOW" is "Y",current date will be used;
For rest cases the StartDate will be first day next month;
The Activity Parameter "START_NOW" is optional: It is used to determine if service option should change immediately.
Possible values: Y/N
The Context Object "START_DATE" is optional
Possible outcome is: DONE

UpdateNextChargeDateToOptionEndDate

Component name

UpdateNextChargeDateToOptionEndDate

Class name

com.cdrator.product.option.component.UpdateNextChargeDateToOptionEndDate

Description

This component updates the next_charge_date on the SubscriptionFee related to the ServiceOption.
A serviceOption is required in the context with the key "OPTION".
If the nextChargeDate is in the future, it will be set back to the end date of the service option or, if the end_date on the serviceOption is null, sysdate.
Outcome is: DONE

UpdatePendingOptionStatus

Component name

UpdatePendingOptionStatus

Class name

com.cdrator.product.option.component.UpdatePendingOptionStatus

Description

This component is used for updating the status of pending options.
The Activity Parameter "SAVE_NOW" is optional: It is used to determine if new service option should be save immediately.
Possible values: Y/N
Mandatory Context Objects:
OPTION:the new service option
Possible outcome is: DONE

ValidateAndAddProductOptionsToContext

Component name

ValidateAndAddProductOptionsToContext

Class name

com.cdrator.product.option.component.ValidateAndAddProductOptionsToContext

Description

Validates the product options and if valid adds the product options to the WfContext.
The validation is done according the the product config in the WfContext.
The product options will be added to the context with key: "PRODUCT_OPTIONS".
The product config must be in the WfContext with key "PRODUCT_CONFIG".
Outcome is
PRODUCT_OPTION_NOT_FOUND
DONE

WaitForOptionChangeDate

Component name

WaitForOptionChangeDate

Class name

com.cdrator.product.option.component.WaitForOptionChangeDate

Description

This component is used for waiting for the changing option date.
Context Object "END_DATE" is required.
Possible outcome is: WAIT or CONTINUE

Product - Service

ActivateService

Component name

ActivateService

Class name

com.cdrator.product.service.component.ActivateService

Description

This component will activate a service.
A Service or a subscription is required in the context for this component to work. This component will only activate the service in Rator.
Outcome is activated

CheckIfCustomerIsActive

Component name

CheckIfCustomerIsActive

Class name

com.cdrator.product.service.component.CheckIfCustomerIsActive

Description

This component can be used for checking if a customer's service and subscription are active
A SERVICE Context Object is required for this component to work.
Possible outcomes are: YES/NO

CreateService

Component name

CreateService

Class name

com.cdrator.product.service.component.CreateService

Description

Creates a new service and adds it to the WfContext.
The service will be added to the context with key: "SERVICE".
The product config must be in the context with key "PRODUCT_CONFIG".
The subscription must be in the context with key "SUBSCRIPTION".
The anumber must be in the context with key "A_NUMBER".
Outcome is
DONE

GetAndAddActiveService

Component name

GetAndAddActiveService

Class name

com.cdrator.product.service.component.GetAndAddActiveService

Description

Finds the service for a phone number and adds it to the context.
Calls Service.getActiveService for given phoneNumber and brand.
The phone number is taken from the context with key: PHONE_NUMBER.
The brand is taken from the context with key: BRAND.
Outcome is
PHONE_NUMBER_NOT_FOUND
DONE

GetNetworkOperator

Component name

GetNetworkOperator

Class name

com.cdrator.product.service.component.GetNetworkOperator

Description

retrieve the NetworkOperator for the given TeleService and add it to the context.
the NetworkOperator will be put in the WfContext with key NETWORK_OPERATOR

Required context objects

SERVICE - The TeleService should be in context.

Possible outcomes

OK - When Network Operator is added to context.

UpdateNetworkPhoneNumber

Component name

UpdateNetworkPhoneNumber

Class name

com.cdrator.product.service.component.UpdateNetworkPhoneNumber

Description

Update Network Phone Number to be same as phone number on Service.
The Network phone Number is set to be same as phone number on given Service

Required context objects

SERVICE - The TeleService should be in context.

Possible outcomes

OK - When network PhoneNumber is set on service.

Provisioning

ChangeProvisioningTaskStatus

Component name

ChangeProvisioningTaskStatus

Class name

com.cdrator.provisioning.component.ChangeProvisioningTaskStatus

Description

Set Status Id on a Provisioning Task
Set Status Id on a Provisioning Task.
Task must be in context.
Status is given by activity parameter.

Required activity parameters

STATUS_ID - The status id to set on task (See ProvisioningTask)

Required context objects

PROVISIONING_TASK - The Provisioning task to set status on

Possible outcomes

DONE - When status is set

CreateActivationProvisioningTask

Component name

CreateActivationProvisioningTask

Class name

com.cdrator.provisioning.component.CreateActivationProvisioningTask

Description

Creates a activation provisioning task for the subscription.
A subscription is required in the context for this component to work. This component will create a provisioning task of type activation.
Outcome is DONE.

CreateProvisioningTask

Component name

CreateProvisioningTask

Class name

com.cdrator.provisioning.component.CreateProvisioningTask

Description

Creates a provisioning task for the service.
A service is required in the context for this component to work. This component will create a provisioning task of specified type
Task type is specified using TASK_TYPE parameter.
Task description is specified using TASK_DESCRIPTION parameter.
If not passed the default description from task constructor will be used.
Task reference if needed is specified using TASK_REFERENCE parameter.
If not present in the parameter, will be retrieved from workflow context REFERENCE.
Outcome is DONE.

CreateProvisioningTaskForChildren

Component name

CreateProvisioningTaskForChildren

Class name

com.cdrator.provisioning.component.CreateProvisioningTaskForChildren

Description

Creates provisioning task for the children of a subscription
A subscription is required in the context for this component to work. This component will create a provisioning tasks of specified type for all the children of the subscription
Task type is specified using TASK_TYPE parameter
Task description is specified using TASK_DESCRIPTION parameter.
If not passed default description from task constructor will be used.
Task reference if needed is specified using TASK_REFERENCE parameter
If not present in the parameter, will be retrieved from workflow context REFERENCE
Outcome is DONE

ProvisioningTaskCallContinue

Component name

ProvisioningTaskCallContinue

Class name

com.cdrator.provisioning.component.ProvisioningTaskCallContinue

Description

Executes CallContinue Method on Provisioning Task
Executes CallContinue Method on Provisioning Task. Task must be in context.

Required context objects

PROVISIONING_TASK - Task to execute call continue

Possible outcomes

DONE - When call continue is executed

ProvisioningTaskCallError

Component name

ProvisioningTaskCallError

Class name

com.cdrator.provisioning.component.ProvisioningTaskCallError

Description

Executes CallError Method on Provisioning Task
Executes CallError Method on Provisioning Task. Task must be in context.

Required context objects

PROVISIONING_TASK - Task to execute call error

Possible outcomes

DONE - When call error is executed

ProvisioningTaskSetStatusToSent

Component name

ProvisioningTaskSetStatusToSent

Class name

com.cdrator.provisioning.component.ProvisioningTaskSetStatusToSent

Description

Sets the status to Sent on a provisioning task.
A provisioningTask is required in the context for this component to work.
This component will set the status to Sent on a provisioning task.
Outcome is DONE

SetProvisioningTaskComment

Component name

SetProvisioningTaskComment

Class name

com.cdrator.provisioning.component.SetProvisioningTaskComment

Description

Add Comment to Provisioning Task
Add a comment to a provisioning task in context

Required activity parameters

COMMENT - Text string which will be added to comment on task

Required context objects

PROVISIONING_TASK - Task to add comment to

Possible outcomes

DONE - When comment is set

SetProvisioningTaskCompleteDate

Component name

SetProvisioningTaskCompleteDate

Class name

com.cdrator.provisioning.component.SetProvisioningTaskCompleteDate

Description

Sets Complete Date On Provisioning Task
Sets Complete Date On Provisioning Task to current date and time. Uses context object to get date. If not found it uses sysdate

Optional activity parameters

COMPLETE_DATE - The key of the context object with the complete date (Object must be type date)

Required context objects

PROVISIONING_TASK - The Task to set Complete Date on

Possible outcomes

DONE - When date is set

Rateplan

HasActiveRateplanChange

Component name

HasActiveRateplanChange

Class name

com.cdrator.rateplan.component.HasActiveRateplanChange

Description

Checks if subscription has an active rate plan change.
Checks if subscription has an active rate plan change.

Required context objects

SUBSCRIPTION - the subscription for the rate plan change being chaecked.

Possible outcomes

YES - If subscription have an active rate plan change.
NO - If subscription does not have an active rate plan change.

Simcard

BookSimCardToService

Component name

BookSimCardToService

Class name

com.cdrator.simcard.component.BookSimCardToService

Description

This component will book a SIM card to the service.
A SIM card and a service is required in the context for this component to work. This component will only change the SIM card in Rator. It will set the status to In Use and assignedToServiceId to the ID of the service on the SIM card.
Optional activity parameters:
MAKE_ORDER_FOR set to "n", "false", "no" or uppercase versions, to disable making a SIM card order.
Outcome is DONE

CanChangeSimcard

Component name

CanChangeSimcard

Class name

com.cdrator.simcard.component.CanChangeSimcard

Description

Checks if simcard change is allowed.
Checks if a change simcard workflow, with the name: CHANGE_SIMCARD, is currently in progress for a given subscription.

Required context objects

SUBSCRIPTION - The subscription changing simcard.

Possible outcomes

DONE - When check is complete. If an active workflow is found, the HookpointResult is set to: FAILED, otherwise it is set to: SUCCESS.

ChangeSimcard

Component name

ChangeSimcard

Class name

com.cdrator.simcard.component.ChangeSimcard

Description

Change the SIM card for a given service.
If the SIM card already exists, the existing details are added to context.
Required context objects:
SIMCARD: The new SIM card to be created.
Optional activity parameter:
SIMCARD_SEND_SIMCARD: Boolean that defines if the SIM card should be sent.
SIMCARD_ADD_FEE: Boolean that defines if a fee should be added.
SIMCARD_TYPE: The SIM card type.
ADDRESS: The address the SIM card should be sent to.
CHANGE_DATE: The day the SIM card should be changed.
Outcomes are
DONE, NOT_OK

CreateSimcard

Component name

CreateSimcard

Class name

com.cdrator.simcard.component.CreateSimcard

Description

Create a SIM card with the given details.
If the SIM card already exists, the existing details are added to context.
Required context objects:
SIMCARD: The new SIM card to be created.
Optional activity parameter:
NEW_SIMCARD_CONTEXT_KEY: key used when looking up the details of the new SIM card. Default is: SIMCARD.
SIMCARD_CONTEXT_KEY: key used when the created or found SIM card object is added to the context. Default is: SIMCARD.
Outcomes are
DONE
NOT_CREATED

ReleaseSimCard

Component name

ReleaseSimCard

Class name

com.cdrator.simcard.component.ReleaseSimCard

Description

Releases a simcard from the paired anumber and makes it available for reuse.
Required object in the context is:
SIMCARD
Outcomes are
DONE

UnpairSimAndAnumber

Component name

UnpairSimAndAnumber

Class name

com.cdrator.simcard.component.UnpairSimAndAnumber

Description

Unpairs a SIM card from the paired a-number.
Required object in the context is:
SIMCARD
Outcomes are
DONE

UpdateSimcardStatus

Component name

UpdateSimcardStatus

Class name

com.cdrator.simcard.component.UpdateSimcardStatus

Description

Update Simcard Status.
Update Simcard Status to given status from activity parameter or from context, also update Simcard Network Status if needed.

Optional activity parameters

SIMCARD_CONTEXT_KEY - The Context key to get the Simcard.
SERVICE_CONTEXT_KEY - The Context key to get the TeleService.
STATUS_ID - The status id to be set on Simcard.One of STATUS_ID and STATUS_CONTEXT_KEY should be set.STATUS_ID has higher priority
STATUS_CONTEXT_KEY - The Context key to get the Simcard Status Id.One of STATUS_ID and STATUS_CONTEXT_KEY should be set.STATUS_ID has higher priority
NETWORK_STATUS_ID - The Network Status Id to be set on Simcard.
NETWORK_STATUS_CONTEXT_KEY - The Context key to get the Network Status Id.

Optional context objects

SIMCARD - The Simcard can be in context.The Simcard or Service at least one of them should be in context.
SERVICE - The Service can be in context.The Simcard or Service at least one of them should be in context.

Possible outcomes

DONE - When simcard status is set.

UseIccToAddSimcardToContext

Component name

UseIccToAddSimcardToContext

Class name

com.cdrator.simcard.component.UseIccToAddSimcardToContext

Description

Adds simcard to context by using ICC already on context
Adds simcard to context by using ICC already on context. If simcard is not found or is not free to assign, the component will return ERROR.

Required context objects

ICC - The Simcards ICC must be in context.

Possible outcomes

DONE - When Simcard is found and added to context.
ERROR - When Simcard is not found or free and is not added to context.

UseNetworkIccOfServiceToAddSimcardToContext

Component name

UseNetworkIccOfServiceToAddSimcardToContext

Class name

com.cdrator.simcard.component.UseNetworkIccOfServiceToAddSimcardToContext

Description

Adds simcard to context by using network ICC of service.
If simcard is not found, the component will return ERROR.

Required context objects

SERVICE - The service must be in context.

Possible outcomes

DONE - When Simcard is found and added to context.
ERROR - When Simcard is not found and is not added to context.

VerifySimcardState

Component name

VerifySimcardState

Class name

com.cdrator.simcard.component.VerifySimcardState

Description

Determines if the SIM card is in a specified state.
This component will check the SIM card to determine if the status
fits within a disallowed set of values.

Optional activity parameters

GET_NEW_SIMCARD_FROM_DB - If set a new simcard will be loaded from the database
USE_IMSI - If set imsi will be sued to load the new simard from the database.

Optional context objects

SUBSCRIPTION - A subscription to get a service from. Either this or a service object must be in context.
SERVICE - Must be a teleservice. Either this or a service object must be in context.

Possible outcomes

NEGATIVE - If simcard state is in the NEGATIVE parameter list.
DONE - If simcard state is in the DONE parameter list.
POSITIVE - If simcardstate is compatible. (Not DONE, FAILED, or NEGATIVE).

Util - Date

AddDateToContext

Component name

AddDateToContext

Class name

com.cdrator.util.date.component.AddDateToContext

Description

Adds a configurable date to context. By default the current date is added.
The current date can be altered be adding or setting calender field values for; year, month, day, houre, minute, second and millisecond.

Required activity parameters

CONTEXT_KEY - the context key to store the date in.

Optional activity parameters

ADD_OR_SET - defines weather calender fields should be set or added. This parameter must be set in order to alter the date.
YEARS - the years to set or add to current date.
MONTHS - the months to set or add to current date.
DAYS - the days to set or add to current date.
HOURES - the hours to set or add to current date.
MINUTES - the minutes to set or add to current date.
SECONDS - the seconds to set or add to current date.
MILLISECONDS - the milliseconds to set or add to current date.

Possible outcomes

DONE - when date is added.

Util - Expression

ExpressionEvaluator

Component name

ExpressionEvaluator

Class name

com.cdrator.util.expression.component.ExpressionEvaluator

Description

This component will evaluate MVEL expressions and add the value to the context.
The activity parameters will be evaluated using the MVEL expression language. The parameter key will be the key in the context and the result of parameter value will become value in the context. Outcome is ok.

Unknown package

CreateCdrParameter

Component name

CreateCdrParameter

Class name

com.cdrator.util.parameter.CreateCdrParameter

Description

Create cdr parameter.

Required activity parameters

CDR_PARAMETER_IF - Context object to link the cdr parameter to.
NAME - Name of the cdr parameter.
VALUE_EXPRESSION - Expression to set the value with.

Optional activity parameters

DESCRIPTION - Description of the cdr parameter.
CODE - Code specifying the type of the cdr parameter.

Possible outcomes

DONE - When cdr parameter has been created.

PutCdrParameterInContext

Component name

PutCdrParameterInContext

Class name

com.cdrator.util.parameter.PutCdrParameterInContext

Description

Add a cdr parameter to context.
It will be saved in the workflow context with a context object key specified by an activity parameter.

Required activity parameters

CDR_PARAMETER_IF - CdrParameterIf object to lookup a cdr parameter for.
CONTEXT_OBJECT_KEY - Context object key to save the cdr parameter under.
NAME - Name of the cdr parameter.

Possible outcomes

FOUND - Cdr parameter was found and added to the context.
NOT_FOUND - Cdr parameter was not found.

Util - Pdf

DynamicPDF

Component name

DynamicPDF

Class name

com.cdrator.util.pdf.component.DynamicPDF

Description

Populates the tagged text fields of a PDF document with String values.
It resolves the label activity parameters defined using the syntax LABEL_<NAME> and the image activity parameters defined using the syntax IMAGE_<NAME> against the context objects and other static activity parameters values defined between backslash characters, finds the tagged text fields/image button fields in the PDF document and populates them with the values of the resolved label/image parameters by mapping the label/image parameter keys after subtracting the LABEL_ prefix/IMAGE_ prefix to the names of the tagged text fields/image buttons in the PDF document. Example: activity parameter is LABEL_CITY=Copenhagen and the text field name is CITY. Then the text field value is set to Copenhagen.

Required activity parameters

DOC_ARCHIVE_CONTEXT_KEY - The context key used to put the created DocArchive object in the context.
DOC_ARCHIVE_DESCRIPTION - The description that is set on the created DocArchive object.
DOC_ARCHIVE_CODE - The code that is set on the created DocArchive object
DOC_ARCHIVE_REF_OBJECT_CONTEXT_KEY - The context key of the persistent object that will be referred by the created DocArchive object. That context object is mandatory.

Optional activity parameters

TEMPLATE_PATH - The location path of the PDF template document.
DOC_ARCHIVE_FILE_NAME - The file name of the created DocArchive object.
TEMPLATE_PATH_CONTEXT_KEY - The context key of the PDF template document's location path. If it is not configured the default value TEMPLATE_PATH of the context key is used.
DOC_ARCHIVE_FILE_NAME - The context key of the docArchive's file name. If it is not configured the default value DOC_ARCHIVE_FILE_NAME of the context key is used.

Required context objects

ACCOUNT - The Account object needed to create the DocArchive object.

Optional context objects

TEMPLATE_PATH - The file path of the PDF template document. It becomes required if the activity parameter TEMPLATE_PATH is not configured.
DOC_ARCHIVE_FILE_NAME - The file name of the created DocArchive object. It becomes required if the activity parameter DOC_ARCHIVE_FILE_NAME is not configured.

Possible outcomes

DONE - When the DocArchive object is created successfully.

DynamicPDFMvel

Component name

DynamicPDFMvel

Class name

com.cdrator.util.pdf.component.DynamicPDFMvel

Description

Populates the tagged text fields of a PDF document with String values.
It resolves using MVEL the label activity parameters defined using the syntax LABEL_<NAME> and the image activity parameters defined using the syntax IMAGE_<NAME> against the context objects and other static activity parameters values defined between backslash characters, finds the tagged text fields/image button fields in the PDF document and populates them with the values of the resolved label/image parameters by mapping the label/image parameter keys after subtracting the LABEL_ prefix/IMAGE_ prefix to the names of the tagged text fields/image buttons in the PDF document. Example: activity parameter is LABEL_CITY=Copenhagen and the text field name is CITY. Then the text field value is set to Copenhagen.

Required activity parameters

DOC_ARCHIVE_CONTEXT_KEY - The context key used to put the created DocArchive object in the context.
DOC_ARCHIVE_DESCRIPTION - The description that is set on the created DocArchive object.
DOC_ARCHIVE_CODE - The code that is set on the created DocArchive object
DOC_ARCHIVE_REF_OBJECT_CONTEXT_KEY - The context key of the persistent object that will be referred by the created DocArchive object. That context object is mandatory.

Optional activity parameters

TEMPLATE_PATH - The location path of the PDF template document.
DOC_ARCHIVE_FILE_NAME - The file name of the created DocArchive object.
TEMPLATE_PATH_CONTEXT_KEY - The context key of the PDF template document's location path. If it is not configured the default value TEMPLATE_PATH of the context key is used.
DOC_ARCHIVE_FILE_NAME - The context key of the docArchive's file name. If it is not configured the default value DOC_ARCHIVE_FILE_NAME of the context key is used.
ACCOUNT - The MVEL expression used to resolve the Account object against the workflow context.If this parameter is not configured the ACCOUNT context object is required

Required context objects

ACCOUNT - The Account object needed to create the DocArchive object. If the optional activity parameter ACCOUNT is configured the ACCOUNT context object is not required.

Optional context objects

TEMPLATE_PATH - The file path of the PDF template document. It becomes required if the activity parameter TEMPLATE_PATH is not configured.
DOC_ARCHIVE_FILE_NAME - The file name of the created DocArchive object. It becomes required if the activity parameter DOC_ARCHIVE_FILE_NAME is not configured.

Possible outcomes

DONE - When the DocArchive object is created successfully.

Util - Zip

FileGZip

Component name

FileGZip

Class name

com.cdrator.util.zip.component.FileGZip

Description

Zip a file.
Zip a file on the local host.

Required context objects

FILE_PATH - The absolut path to file
FILE_NAME - The filename.

Possible outcomes

DONE - Only possible outcome

Workflow

AddToContextFromHookpointResult

Component name

AddToContextFromHookpointResult

Class name

com.cdrator.workflow.component.AddToContextFromHookpointResult

Description

This component takes objects from the Hookpoint result and adds them to the context
If the hookpoint result does not contain the configured key, nothing will be added. If a key (CLEAR_HOOKPOINT) with value "Y" is configured then the hookpoint result is cleared after adding the objects to the context.

Possible outcomes

DONE - When objects has been added to the context

CheckIfActiveWorkflowExists

Component name

CheckIfActiveWorkflowExists

Class name

com.cdrator.workflow.component.CheckIfActiveWorkflowExists

Description

This component can be used for checking if an active workflow exists for the given subscription.
The Activity Parameter "HOOKPOINT_KEY" is used to determine which Workflow to check and is mandatory.
A SUBSCRIPTION Context Object is required for this component to work.
Possible outcomes are: YES/NO

CheckIfWorkflowActivityCompleted

Component name

CheckIfWorkflowActivityCompleted

Class name

com.cdrator.workflow.component.CheckIfWorkflowActivityCompleted

Description

This component checks a workflow to see if all activities with a specified name are completed.
The workflow is retrieved from the context with a key specified in the activity parameters: WORKFLOW_CONTEXT_KEY.
The activity is specified by the activity's name either in the context or in the parameters by the key: WORKFLOW_ACTIVITY_NAME.
Outcome is YES, if all the activities are completed - NO otherwise.

ComponentTemplate

Component name

ComponentTemplate

Class name

com.cdrator.workflow.component.ComponentTemplate

Description

Replace me with a short description
Replace me with a long description

Required activity parameters

RENAME_OR_REMOVE - this is a description of the required activity parameter

Optional activity parameters

RENAME_OR_REMOVE - this is a description of the optional activity parameter

Required context objects

RENAME_OR_REMOVE - this is a description of the required context objects

Optional context objects

RENAME_OR_REMOVE - this is a description of the optional context objects

Possible outcomes

DONE - this is a description of the possible outcomes of the activity
RENAME_OR_REMOVE - this is a description of the possible outcomes of the activity

ContextBasedOutcome

Component name

ContextBasedOutcome

Class name

com.cdrator.workflow.component.ContextBasedOutcome

Description

Component that will make outcome based on how it is configured.
This component will take a configured "CONTEXT_KEY" and retrieve the value from the context.
It will then take the value and lookup the StringValue in the context and compare them.
If the context value is the same as a configured value. That value becomes the outcome.
Example:
context contains key: "NETWORK" with value: "TELIA"
activity parameters are:

Unknown macro: {(CONTEXT_KEY, NETWORK), (TDC,TDC_OUTCOME), (TELIA, TELIA_OUTCOME)}

outcome will be: TELIA_OUTCOME
Possible outcomes are:
Configurable.
If no CONTEXT_KEY defined: DONE

ContinueStartingActivity

Component name

ContinueStartingActivity

Class name

com.cdrator.workflow.component.ContinueStartingActivity

Description

Continue the starting activity.
Specify the outcome for the starting activity in a parameter.

Required activity parameters

OUTCOME - Define the outcome the STARTING_ACTIVITY should be continued with.

Required context objects

STARTING_ACTIVITY - Reference to the activity which started this workflow.

Possible outcomes

DONE - Outcome when activity is continued.

DynamicWaitUntil

Component name

DynamicWaitUntil

Class name

com.cdrator.workflow.component.DynamicWaitUntil

Description

This component will wait for a specfic date before continuing.
A parameter named WAIT_UNTIL_DATE in the activity is required for this component to work. This component will resolve a date based on the value in the parameter WAIT_UNTIL_DATE. It returns WAIT if the date is after now or CONTINUE if date is before now. Whoever uses this component must create an outcome WAIT which returns to the activity itself. IMPORTANT: Add a delay of perferably at least 1 day to the outcome WAIT.
Outcome is WAIT or CONTINUE.

Forloop

Component name

Forloop

Class name

com.cdrator.workflow.component.Forloop

Description

This component will loop part of a workflow.
This component return YES the first MAX_LOOPS times it is called, afterwards it will return NO

Optional activity parameters

MAX_LOOPS - How many times it should loop
PREFIX - Used to prefix context objects so multiple loop can be used in the same workflow

Optional context objects

MAX_LOOPS - How many times it should loop. Only used if neither parameter MAX_LOOPS or parameter PREFIX are configured
<PREFIX>_MAX_LOOPS - How many times it should loop. Only used if parameter PREFIX is configured and parameter MAX_LOOPS isn't

Possible outcomes

YES - If the loop should continue
NO - If MAX_LOOPS has been reached

GenericBrandChecker

Component name

GenericBrandChecker

Class name

com.cdrator.workflow.component.GenericBrandChecker

Description

Checks if configured object in context is from BRAND in context.
This component will check if values in the context has same brand as BRAND in context.
The BRAND must be in the context with key "BRAND".
The configured values must be in the context.
Possible outcomes are:
BRAND_MISMATCH
DONE

GenericHookpointResultAdder

Component name

GenericHookpointResultAdder

Class name

com.cdrator.workflow.component.GenericHookpointResultAdder

Description

Adds objects from context to the hookpoint result.
This component will take objects from the context and add them to the hookpoint result based on configured key-value String pairs. Example: context contains ANUMBER and it needs to be in the hookpoint result as PHONE_NUMBER. Configure activity parameter key=value as: ANUMBER=PHONE_NUMBER. If the context does not contain the configured key, nothing will be added. If a key (CLEAR_HOOKPOINT) with value "Y" is configured then the hookpoint result is cleared before adding the objects.
Outcome is DONE

GenericWaitUntil

Component name

GenericWaitUntil

Class name

com.cdrator.workflow.component.GenericWaitUntil

Description

Component for waiting until some date
If the activity has object WAIT_UNTIL_DATE with this format dd-MM-yyyy then it uses this specific date to wait.
Otherwise the activity should have a parameter called WAIT_UNTIL_DAY within this format DD.
This parameter can be use to indicate until which day in every month the activity shall wait.
Parameter START_FROM_CURRENT_MONTH will indicate if the activity shall wait until some day in current month or starting next month.
The format is 'true' or 'false'. By default it will start from current month.
The component wil return OK or WAIT.

IsWorkflowActivitiesNewOrWaiting

Component name

IsWorkflowActivitiesNewOrWaiting

Class name

com.cdrator.workflow.component.IsWorkflowActivitiesNewOrWaiting

Description

Test if given workflow activities are waiting
Given a workflow key and an activity key check wether or not there exists waiting activities for the current subscription

Required activity parameters

ACTIVITY_KEY - The activity key of the activities to be tested

Optional activity parameters

WF_KEY - Workflow definition key used to filter the activities to be tested

Required context objects

SUBSCRIPTION - SUBSCRIPTION context object

Possible outcomes

NO - No waiting activity found
YES - One or more waiting activities found

PushWorkflowActivities

Component name

PushWorkflowActivities

Class name

com.cdrator.workflow.component.PushWorkflowActivities

Description

Pushes workflow activities
Pushes workflow activities having a specific key to a specific outcome and optionally filter them by a specific subscription_id, wf_def_key and/or by workflowId. Can optionally be set to enable pushing of all activity types. Default is Automatic and External.

Required activity parameters

ACTIVITY_KEY - The activity key of the activities to be pushed
ACTIVITY_OUTCOME - The activity outcome to push the activities to

Optional activity parameters

WF_KEY - Workflow definition key used to filter the activities to be pushed
PUSH_ALL_TYPES - Should All types of activities be pushable (y,true,yes)
WORKFLOW_ID_CTX_KEY - Defines the context of the WORKFLOW_ID. If not defined the default is WORKFLOW_ID

Required context objects

SUBSCRIPTION - SUBSCRIPTION context object

Possible outcomes

DONE - some description

StartWorkflowCopyContext

Component name

StartWorkflowCopyContext

Class name

com.cdrator.workflow.component.StartWorkflowCopyContext

Description

This component can be used for starting a new workflow with a copy of the context from this workflow.
The Activity Parameter "HOOKPOINT_KEY" is used to determine what Workflow will be started and is mandatory.
The context of the current workflow is copied into the new workflow.
The OUTCOME of this activity can be defined either in OUTCOME or RESULT object in the workflow result.
If no OUTOME is defined, RESULT is returned, if no RESULT is defined, the outcome defaults to: DONE.

UpdateHookpointResult

Component name

UpdateHookpointResult

Class name

com.cdrator.workflow.component.UpdateHookpointResult

Description

Adds/updates all configured parameters, key-value String pairs, to the HookpointResult.
This component will add/update all configured parameters key-value String pairs to the HookpointResult.
Outcome is DONE

WaitNumberOfDays

Component name

WaitNumberOfDays

Class name

com.cdrator.workflow.component.WaitNumberOfDays

Description

This component will activate a subscription.
A parameter named WAIT_NO_OF_DAYS (integer) in the activity is required for this component to work. It runs twice. First it calculates a date (now + WAIT_NO_OF_DAYS) It set the start date of the activity to this date and returns WAIT. Then the workflow engine will not pick it up, until the date has passed. Whoever uses this component must create an outcome WAIT which returns to the activity itself, and an outcome CONTINUE which leads to the next activity.
Outcomes are CONTINUE and WAIT

Workflow - Context

ContextObjectEqualsToValue

Component name

ContextObjectEqualsToValue

Class name

com.cdrator.workflow.context.component.ContextObjectEqualsToValue

Description

This component can be used to check if a context object equals to any specific value.
The Activity Parameter "CONTEXT_KEY" is used to determine which workflow context object should be checked.
If there is a context object with that key and it is not null the outcome value should be the value of The Activity Parameter CONTEXT_VALUE_<EXPECTED_VALUE>.
If the context object does not match to any of the expected values the outcome value should be NOT_FOUND.
Otherwise, if the object is not in the context or is null the outcome value should be NOT_EXIST.

DetermineContextObjType

Component name

DetermineContextObjType

Class name

com.cdrator.workflow.context.component.DetermineContextObjType

Description

Component that determines the type of context object, i.e. Object.getClass().getSimpleName().
The Activity Parameter "PARAMETER_CONTEXT_KEY" is used to determine which workflow context object to look for.
If the object exists and is not null, the outcome value is simple class name of object.
E.g. java.util.ArrayList would return 'ArrayList'.

ListIterator

Component name

ListIterator

Class name

com.cdrator.workflow.context.component.ListIterator

Description

Iterates over a list
Given a list, this component iterates through the list.
A reference to the current element is copied to the context_key value and the iteration starts (ITERATE_OUTCOME).
When the iteration is finished, there will be an end outcome. (END_OUTCOME)
Important: the activities started by the iterate_outcome has return to this component, else no iteration is done!

Required activity parameters

ITERATION_LIST - Context key which contains the list to iterate through
CONTEXT_KEY - Context key which each list element will be added to the context as

Optional activity parameters

ITERATION_COUNTER - Context key of the value which holds which iteration is in progress. By default the iteration list context key will be appended with _COUNTER
ITERATE_OUTCOME - Outcome for each iteration. Default is: ITERATE_OUTCOME
END_OUTCOME - Outcome when iteration is finished. Default is: END_OUTCOME

Possible outcomes

ITERATE_OUTCOME - The default iterate outcome. This can be reconfigured by setting activity parameter: ITERATE_OUTCOME
END_OUTCOME - The default end outcome. This can be reconfigured by setting activity parameter: END_OUTCOME

ObjectInContext

Component name

ObjectInContext

Class name

com.cdrator.workflow.context.component.ObjectInContext

Description

This component can be used to check if a specific element exist is in the context and if it is blank.
The Activity Parameter "CONTEXT_KEY" is used to determine which workflow context object to look for.
The CHECKIFBLANK parameter can be set to "Y" if this component should check if the object is blank. If CHECKIFBLANK is set, the object in context should be a string.
If the object exists and is not null and is not blank, the outcome value is YES, else it is NO

UpdateWorkflowInstanceWithContextData

Component name

UpdateWorkflowInstanceWithContextData

Class name

com.cdrator.workflow.context.component.UpdateWorkflowInstanceWithContextData

Description

Update the workflow instance record, i.e.: SUBSCRIPTION_ID, if relevant data found in the context.
Check for SUBSCRIPTION and ACCOUNT objects in the context and, if present, updates SUBSCRIPTION_ID and ACCOUNT_ID in the workflow instance.
If only SUBSCRIPTION is found, ACCOUNT_ID is updated from the account fetched from the SUBSCRIPTION context object.

Optional activity parameters

OUTCOME_NOT_SET - If both SUBSCRIPTION and ACCOUNT are not found in the context and parameter OUTCOME_NOT_SET defined and equals Y, the outcome will be NOT_SET.

Optional context objects

SUBSCRIPTION - The workflow instance data will be updated from this object.
ACCOUNT - The workflow instance data will be updated from this object.

Possible outcomes

DONE - If data found in context or parameter OUTCOME_NOT_SET not defined or not equals to Y.
NOT_SET - If data not found in context and parameter OUTCOME_NOT_SET equals to Y.

Unknown package

SetWfIdOnObject

Component name

SetWfIdOnObject

Class name

com.cdrator.workflow.SetWfIdOnObject

Description

This component sets the workflowId on an object in context.
This component requires that there is an Object in the context with the key: "KEY".
This component also requires that the Object has the method: "setWorkflowId(String)"
If there is no parameter with the key: "KEY", a nullpointerException will be thrown.
If the parameter "SAVE" is set to "TRUE" and the object is an instance of PersistentObject the component will save the object.
Possible outcomes:
DONE