Skip to content

Commit

Permalink
Update from SAP DITA CMS (squashed):
Browse files Browse the repository at this point in the history
commit 0f23bf7cc3fdf629b3b90c9c8673e9c52fefa90d
Author: REDACTED
Date:   Mon Jul 3 09:55:58 2023 +0200

    Update from SAP DITA CMS ( 2023-07-03_09:55:58 )

    Project: loioaf2fcb3e6dd448f3af3c0ff9c70daaf9 (wbs1684219875323.project)

    * Project map: loioaf2fcb3e6dd448f3af3c0ff9c70daaf9 (bdk1685405765388.ditamap)

    * Output: loioc25299a38b6448f889a43b42c9e5897d

    * Buildable map: loio678695d903b546e5947af69e56ed42b8 (rlr1685405765339.ditamap)

    * Language: en-US

commit ff2bb98c648c11dec74fa88129d7067f202dce52
Author: REDACTED
Date:   Mon Jul 3 09:54:56 2023 +0200

    Update from SAP DITA CMS ( 2023-07-03_09:54:55 )

    Project: loioaf2fcb3e6dd448f3af3c0ff9c70daaf9 (wbs1684219875323.project)

    * Project map: loioaf2fcb3e6dd448f3af3c0ff9c70daaf9 (bdk1685405765388.ditamap)

    * Output: loiob8faae83b519439fb4ea9d0eb1a5f26e

    * Buildable map: loio4e1c1e1d5d1947f5875e93e7597c4f4c (nvm1685405765337.ditamap)

    * Language: en-US

##################################################
[Remaining squash message was removed before commit...]
  • Loading branch information
ditaccms-bot committed Jul 5, 2023
1 parent fe2363f commit 41b8a8d
Show file tree
Hide file tree
Showing 40 changed files with 143 additions and 115 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@ Add a source to read data from. You can add multiple sources and combine them to
The depth of an OData object refers to the level of related entities that are included in the response when querying the OData service. The depth is by default set to 1 so that only the properties of the requested entity are returned. You can change the depth to 2 to include a second level. Depth is useful when you want to optimize performance by controlling the amount of data returned in a single request.

> ### Example:
> If an OData service has two objects for ***Products*** and ***Orders***, and a ***Product*** object has a navigation property to related ***Order*** objects, a request for a specific ***Product*** with a depth of 1 will return the properties of that ***Product***, but not the related ***Order*** objects. But if you specify a depth of 2, it will also return the related ***Order*** objects and their properties.
> If an OData service has two objects for `Products` and `Orders`, and a `Product` object has a navigation property to related `Order` objects, a request for a specific `Product` with a depth of 1 will return the properties of that `Product`, but not the related `Order` objects. But if you specify a depth of 2, it will also return the related `Order` objects and their properties.
> ### Restriction:
> When the depth is set to 2, the *Columns* section shows the columns from the two collections \(or levels\) and the following problems occur:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Import a `.csv` file to create a table and fill it with the data from the file.
</td>
<td valign="top">

Select the character used to signify the boundary between columns. In general, the default value, ***Auto-detect*** is sufficient.
Select the character used to signify the boundary between columns. In general, the default value, `Auto-detect` is sufficient.



Expand All @@ -88,7 +88,7 @@ Import a `.csv` file to create a table and fill it with the data from the file.
> The values of a hana.REAL column are automatically converted when their format is invalid.
>
> > ### Example:
> > The value ***1.1*** will be read and written as ***1.100000023841858***.
> > The value `1.1` will be read and written as `1.100000023841858`.
>
> This will cause issues if this column is used as a calculated column. In that case, avoid conversion by setting the column to another data type.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,26 +55,26 @@ This topic contains information on performing the following tasks:

## Procedure

1. **Basic Creation of a Linear Task Chain**
**Basic Creation of a Linear Task Chain**

A basic or linear task chain allows you to define a group or series of tasks and execute those tasks in a serial process, one after another. A succeeding task is only executed once the previous task in the series has finished successfully with a completed status. The execution of tasks in the series will not resume if the previous task has a failed status.
A basic or linear task chain allows you to define a group or series of tasks and execute those tasks in a serial process, one after another. A succeeding task is only executed once the previous task in the series has finished successfully with a completed status. The execution of tasks in the series will not resume if the previous task has a failed status.

2. From the *Data Builder*, click *New Task Chain*.
1. From the *Data Builder*, click *New Task Chain*.

3. From the left-side panel, drag and drop a first object on to the task chain canvas from those available in the repository.
2. From the left-side panel, drag and drop a first object on to the task chain canvas from those available in the repository.

> ### Note:
> In the repository, you can see the remote tables, views, and data flow objects that meet prerequisites and are available to be added to the task chain.
4. Drag a second object on to the first object in the task chain. As you drag the object over the top of the first object, a context menu displays options *Add as New Task* \(the default\), *Replace Existing*, or *Add as Parallel* \(described in the next section\) to place the new object.
3. Drag a second object on to the first object in the task chain. As you drag the object over the top of the first object, a context menu displays options *Add as New Task* \(the default\), *Replace Existing*, or *Add as Parallel* \(described in the next section\) to place the new object.

Choosing the *Add as New Task* option automatically connects the new object task to the previous object task. The properties panel for the task chain is also updated with the added objects.

5. Continue adding remaining object tasks you want to include in the task chain.
4. Continue adding remaining object tasks you want to include in the task chain.

In addition to adding or replacing object tasks in a task chain, you can drag objects already on the task chain canvas to change the order in which tasks are executed.

6. In the properties panel, specify a name for the task chain.
5. In the properties panel, specify a name for the task chain.

![](images/Task_chain_properties_55f7187.png)

Expand Down Expand Up @@ -315,19 +315,20 @@ This topic contains information on performing the following tasks:
> ### Note:
> When you select an object, you can delete it from the task chain or navigate to the corresponding editor for that object.
7. Save and deploy your task chain.
6. Save and deploy your task chain.

The properties of your task chain are updated.

![](images/Properties_Update_with_Deploy_3674719.png)

Once the task chain is deployed, you can then run the task chain or create a schedule to run your task chain periodically, and navigate to the Task Chain Monitor to monitor your task chain runs. For more information, see [Scheduling Data Integration Tasks](https://help.sap.com/viewer/be5967d099974c69b77f4549425ca4c0/cloud/en-US/7fa07621d9c0452a978cb2cc8e4cd2b1.html "Schedule data integration tasks to run periodically at a specified date or time.") :arrow_upper_right: and [Monitoring Task Chains](https://help.sap.com/viewer/be5967d099974c69b77f4549425ca4c0/cloud/en-US/4142201ec1aa49faad89a688a2f1852c.html "Monitor the status and progress of running and previously run task chains.") :arrow_upper_right:.

8. **Executing Parallel Tasks in a Task Chain**

In addition to linear task chains in which one task is executed after another, you can also create task chains in which individual tasks are run in parallel and continuation of the entire task chain run depends on whether ANY or ALL parallel tasks are completed successfully.
**Executing Parallel Tasks in a Task Chain**

9. After adding an object to the task chain canvas, there are a few different ways in which you can specify that the object or task you added is part of a parallel branch in the task chain:
In addition to linear task chains in which one task is executed after another, you can also create task chains in which individual tasks are run in parallel and continuation of the entire task chain run depends on whether ANY or ALL parallel tasks are completed successfully.

7. After adding an object to the task chain canvas, there are a few different ways in which you can specify that the object or task you added is part of a parallel branch in the task chain:

- Select the task object you added to the canvas and then click the *Add as Parallel Branch* option from the list of context menu options available.

Expand Down Expand Up @@ -357,24 +358,24 @@ This topic contains information on performing the following tasks:
You may continue to add additional parallel task objects in the same way. There is no predefined limit on the number of tasks you can include in a parallel task chain branch, however you cannot nest another task chain within an existing one.


10. When you have finished adding task objects to the parallel task chain branch, select the ANY or ALL operator to apply to the execution of the parallel task objects in the chain.
8. When you have finished adding task objects to the parallel task chain branch, select the ANY or ALL operator to apply to the execution of the parallel task objects in the chain.

To do that, select one of the parallel branch task objects and select either the *ANY* or *ALL* operator from the task object’s context menu. Or, you can click and drag the ANY or ALL operator from the shell bar on to the task chain canvas below the parallel task chain branch you’ve created.

> ### Note:
> To switch the ANY or ALL operator, after adding it to the task chain canvas, simply select the current operator and then toggle the ANY/ALL option in the task chain's Properties panel.
11. Next, connect each of the parallel branch task objects to the ANY or ALL operator you placed on the canvas. To do that, select a task object in the branch, then click and drag the :arrow_right: arrow to the ANY or ALL operator to connect the selected task object.
9. Next, connect each of the parallel branch task objects to the ANY or ALL operator you placed on the canvas. To do that, select a task object in the branch, then click and drag the :arrow_right: arrow to the ANY or ALL operator to connect the selected task object.

![](images/connect_to_operator_1_258e262.png)

![](images/connect_to_operator_2_6be4c2b.png)

12. Connect the remaining task objects in the branch to the ANY or ALL operator, in the same way, to complete creation of the parallel task chain branch.
10. Connect the remaining task objects in the branch to the ANY or ALL operator, in the same way, to complete creation of the parallel task chain branch.

Following the completion of the task chain branch, you can then continue to add additional linear tasks, or create additional task object branches in the task chain.

13. When you’ve finished adding tasks objects to the task chain, save and deploy your new task chain.
11. When you’ve finished adding tasks objects to the task chain, save and deploy your new task chain.

> ### Note:
> SAP Datasphere allows you to save task chains that may have unconnected task objects on the canvas. However, you will not be able to deploy and run them until all task objects are connected to define their order of execution when the task chain is run.
Expand All @@ -385,13 +386,14 @@ This topic contains information on performing the following tasks:

After finishing a task chain run that includes one or more parallel task branches, it may be possible that one or more tasks may be reported in an error state \(in each branch\). For example, in branches where completion of tasks is evaluated with the ANY operator. In that case, if you restart or retry the task chain, SAP Datasphere will then restart previously-failed tasks and run all subsequent tasks that had not yet run. In particular, this means that if a failed task is in a parallel branch which was evaluated with the ANY operator, those tasks in the same branch which had run successfully will not be run again. Only those tasks that have failed will be retried or run again.

14. **Configuring Email Notifications**

After creating and deploying a task chain, you can set up email notification for completion of task chain runs.
**Configuring Email Notifications**

After creating and deploying a task chain, you can set up email notification for completion of task chain runs.

To set up email notification:
To set up email notification:

15. In the *Email Notifications* section of the *Properties* panel, select when you want notifications to be sent for the current task chain. You can choose from the following options:
12. In the *Email Notifications* section of the *Properties* panel, select when you want notifications to be sent for the current task chain. You can choose from the following options:

- Send email notification only when the run has completed with an error.

Expand All @@ -409,13 +411,13 @@ This topic contains information on performing the following tasks:
> ### Note:
> Task chains must also first be deployed before you can select or specify users to receive notifications.
16. Click the <span class="SAP-icons"></span> link on the right side of the *Recipient Email Address* field to open a popup dialog in which you can add recipients of task chain notification email messages.
13. Click the <span class="SAP-icons"></span> link on the right side of the *Recipient Email Address* field to open a popup dialog in which you can add recipients of task chain notification email messages.

![](images/Recipients_List_527a05c.png)

From this dialog, you can select member users of the same tenant or click the *Others* tab to specify email addresses of other users you want to receive notifications \(up to 20 total recipients\). Email addresses must match the domain of the tenant owner, for example, [email protected]. After saving your selections, the display returns to the *Properties* panel, showing the selected users in the *Recipient Email Address* field.

17. Review the default email subject and message body text and make any updates to either the text or placeholder variables used in the notification email message sent for the current task chain.
14. Review the default email subject and message body text and make any updates to either the text or placeholder variables used in the notification email message sent for the current task chain.

Placeholder variables within the subject and message fields are enclosed by $$ characters, for example, $$status$$. You can click the <span class="SAP-icons"></span> icon to display a list of available placeholder variable names you may include in either the email subject or message body text fields.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ The following options are available:

- Select *Use first row as column header* if your file contains column headers in its first line.
- Next to *Insert missing string value as*, select *Empty value* or *NULL* before adding a record. All new empty values are stored as the selected value.
- Select the character used to signify the boundary between columns in *CSV Delimiter*. In general, the default value ***Auto-detect*** is sufficient.
- Select the character used to signify the boundary between columns in *CSV Delimiter*. In general, the default value `Auto-detect` is sufficient.

Review the matching of columns in your table with those in your CSV file.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ You can maintain data in local tables that:
> - The values of a hana.REAL column are automatically overwritten when their format is invalid.
>
> > ### Example:
> > The value ***1.1*** is incorrectly formatted and will be overwritten as ***1.100000023841858***.
> > The value `1.1` is incorrectly formatted and will be overwritten as `1.100000023841858`.
>
> This will cause issues if this column is used as a calculated column. In that case, avoid conversion by setting the column to another data type.
>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -152,8 +152,8 @@ Filter by any of the categories listed in the *Filter By* area of the left panel

You can select one or more values in each filter category in the *Filter By* section:

- Each value selected in a category acts as an ***OR*** condition.
- Each value selected in separate categories acts together as ***AND*** conditions.
- Each value selected in a category acts as an `OR` condition.
- Each value selected in separate categories acts together as `AND` conditions.


<table>
Expand Down Expand Up @@ -1045,11 +1045,11 @@ For those filter options that are not related to date or time, you can create a

1. Click *Show More* at the bottom of a filter category to open the Filter Settings dialog. Some filters have a *Select Items* and a *Define Conditions* tab.
2. On the *Define Conditions* tab, choose an operator and enter a value in the *Filter Condition* box.
3. Click the plus icon to create an alternative condition. Each condition in one category acts as an ***OR*** operator, so that an object must meet one of the conditions to be included in the search results. If you define one condition in two categories, then each category acts as an ***AND*** operator, so that both conditions must be true for the object to be returned in the search results.
3. Click the plus icon to create an alternative condition. Each condition in one category acts as an `OR` operator, so that an object must meet one of the conditions to be included in the search results. If you define one condition in two categories, then each category acts as an `AND` operator, so that both conditions must be true for the object to be returned in the search results.

You can create advanced filter conditions for multiple filter categories. An object must meet one of the conditions in each of the categories to be included in the search results.

For example, if you are viewing terms and want to create a condition to filter on the keywords “investment” and “stock”, you would click :heavy_plus_sign:. Then choose *Contains all of these words*. In the Filter Condition box, enter ***investment***. Click :heavy_plus_sign: again. Choose *Contains all of these words*. In the Filter Condition box, enter ***stock***, and then click *OK*. The new condition is listed in the Keyword group in the filter panel, and the filter results are automatically shown.
For example, if you are viewing terms and want to create a condition to filter on the keywords “investment” and “stock”, you would click :heavy_plus_sign:. Then choose *Contains all of these words*. In the Filter Condition box, enter `investment`. Click :heavy_plus_sign: again. Choose *Contains all of these words*. In the Filter Condition box, enter `stock`, and then click *OK*. The new condition is listed in the Keyword group in the filter panel, and the filter results are automatically shown.



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -236,7 +236,7 @@ For those filter options that are not related to date or time, you can create a

1. Click *Show More* at the bottom of a filter category to open the Filter Settings dialog. Some filters have a *Select Items* and a *Define Conditions* tab.
2. On the *Define Conditions* tab, choose an operator and enter a value in the *Filter Condition* box.
3. Click the plus icon to create an alternative condition. Each condition in one category acts as an ***OR*** operator, so that an object must meet one of the conditions to be included in the search results. If you define one condition in two categories, then each category acts as an ***AND*** operator, so that both conditions must be true for the object to be returned in the search results.
3. Click the plus icon to create an alternative condition. Each condition in one category acts as an `OR` operator, so that an object must meet one of the conditions to be included in the search results. If you define one condition in two categories, then each category acts as an `AND` operator, so that both conditions must be true for the object to be returned in the search results.

You can create advanced filter conditions for multiple filter categories. An object must meet one of the conditions in each of the categories to be included in the search results.

Expand Down
Loading

0 comments on commit 41b8a8d

Please sign in to comment.