This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
app:app_how_to [2019/07/28 19:44] dtucker [How To Set Up APP Advanced Delivery] |
app:app_how_to [2019/07/28 22:01] (current) |
||
|---|---|---|---|
| Line 1282: | Line 1282: | ||
| ===== How To Create an Advanced Delivery Query ===== | ===== How To Create an Advanced Delivery Query ===== | ||
| - | Create an SAP® Business One query to retrieve the data elements that you may want to use as filters in the document delivery process. The query must be saved before opening the APP Report Definition function. Otherwise the query will not be available for use. | + | Create an SAP® Business One query to retrieve the data elements that you may want to use as filters in the document delivery process. The query must be saved before opening the **APP Report Definition** function. Otherwise the query will not be available for use. |
| - | Save the query in the standard fashion. It may be appropriate to create a special category in Query Manager as a common place to hold APP-related queries; however this is not a requirement. | + | Save the query in the standard fashion. It may be appropriate to create a special category in **Query Manager** as a common place to hold APP-related queries; however this is not a requirement. |
| - | {{:app/image297.jpeg? | + | <WRAP center round info> |
| + | In some cases the query execution process in APP can encounter issues with very complex queries. Therefore if your query utilizes multiple <color # | ||
| + | </ | ||
| - | **Note** - In some cases the query execution process in APP can encounter issues with very complex queries. Therefore if your query utilizes multiple **JOIN** statements or includes multiple summary functions (**SUM**, **AVG**, etc.) we recommend that the actual query statement be created as a View in the SQL database. The query in SAP Business One is then simply | + | **SAMPLE QUERIES** |
| - | **Sample Queries** | + | |
| - | **Customer List** - including customer code, customer name, contact person name, customer group name, salesperson name, and customer balance. | + | |
| - | **SELECT T0.[CardCode], | + | **QUERY LIMITATIONS** |
| - | **t0.groupnum as [PayGroupCode], t3.pymntgroup as [PayGroupName] FROM OCRD T0 INNER JOIN OCRG T1 ON T0.GroupCode = T1.GroupCode INNER JOIN OSLP T2 ON** | + | * There are certain limitations while creating a query. |
| + | * The <color # | ||
| + | | ||
| - | **T0.SlpCode = T2.SlpCode inner join octg t3 on t0.groupnum = t3.groupnum WHERE T0. [CardType] = ' | ||
| - | |||
| - | **Query Limitations** | ||
| - | |||
| - | There are certain limitations while creating a query. | ||
| - | |||
| - | The **ORDER BY** clause is invalid in views, inline functions, derived tables, subqueries, and common table expressions, | ||
| - | |||
| - | specify th**e** **TOP** keyword. For example the query **Select * from ORDR** **(NOLOCK) ORDER BY CardCode** is not a valid query. So specify theTOP keyword like this - **Select TOP 100 * from ORDR (NOLOCK) ORDER BY CardCode.** | ||
| - | |||
| - | | ||
| - | |||
| - | for the column. For example **Select CardCode AS [Alias1], * from ORDR** **(NOLOCK), | ||
| + | {{: | ||
| ===== How To Create an APP Report Definition ===== | ===== How To Create an APP Report Definition ===== | ||
| - | |||
| - | {{: | ||
| **General Tab** | **General Tab** | ||
| - | Create a basic Report Definition. The Report Definition for a sample Advanced Delivery setup is shown above. | + | Create a basic Report Definition. The Report Definition for a sample Advanced Delivery setup is shown below. |
| - | {{:app/image299.jpeg?766x596}} | + | {{:app/image298.jpeg?786x629}} |
| **Delivery Preferences Tab** | **Delivery Preferences Tab** | ||
| Delivery Preferences is information about how a report/ | Delivery Preferences is information about how a report/ | ||
| + | |||
| + | {{: | ||
| **Create a new Message ID** | **Create a new Message ID** | ||
| - | | + | * |
| - | + | | |
| - | Enter a **Message Description**. This is displayed to the user so it should be descriptive. | + | |
| - | + | | |
| - | Enter the **Email Subject**. This is the subject line of the e-mail. | + | |
| - | + | | |
| - | Enter the **Attachment Name** . This is used as the name of the | + | |
| - | + | | |
| - | attachment sent with the e-mail. | + | |
| - | + | | |
| - | Select the **Query** option for customization type. A list of queries in SAP® Business One is displayed. The first column shows the Query Category and the second column shows the query name. | + | |
| - | + | ||
| - | Once a query has been assigned to the message the columns in the query are available for use in the e-mail body (called “tags”) from the **Select Tag** drop down list. | + | |
| - | + | ||
| - | Standard data tags can also be selected by selecting the **Standard** customization type option. | + | |
| - | + | ||
| - | Enter the text and tags needed to create the body of the e-mail. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | The **Insert** button will insert the tag text at the current cursor position. | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | The **Copy** button will copy the tag text to the Windows clipboard. You can the position the cursor as needed and right-click/ | + | |
| - | + | ||
| - | | + | * <color #22b14c>**Save**</ |
| + | * <color # | ||
| - | | + | {{: |
| ===== How To Set Up Advanced Delivery Configurations ===== | ===== How To Set Up Advanced Delivery Configurations ===== | ||
| - | **Advanced Delivery Definitions can be added from the Report Maintenance | + | <WRAP center round info> |
| + | Advanced Delivery Definitions can be added from the **Report Maintenance** | ||
| + | </ | ||
| - | Click the SAP menu option for **Report | + | * Click the **<color #22b14c>Report |
| - | + | | |
| - | Click on the Report that you want to add an Advanced Delivery Definition to in order to load the report data to the Maintenance screen. | + | |
| {{: | {{: | ||
| - | Click on the **Advanced Delivery Definitions** tab. | + | * Click on the <color #22b14c>**Advanced Delivery Definitions**</ |
| - | + | | |
| - | Click the **New** button. | + | |
| {{: | {{: | ||
| - | The **Use Default Report** and **Use Specific Report** options are selected automatically based on the report definitions already set up. | + | * The <color #00a2e8>**Use Default Report**</ |
| + | * Enter a <color # | ||
| + | * Assign the desired Additional Query Fields values as needed... | ||
| + | * Select the desired <color # | ||
| + | * Select the desired filter <color # | ||
| + | * Enter the value to be used for comparison in <color # | ||
| + | * Enter a second value to be used for comparison in <color # | ||
| + | * Select a <color # | ||
| + | * Click the <color # | ||
| + | * Click the <color # | ||
| + | * Click the <color # | ||
| - | Enter a **Name** for the delivery option. This name is displayed to the user for selection. | ||
| - | | + | <WRAP center round info> |
| + | Advanced Delivery Definitions can be created from the <color # | ||
| + | </ | ||
| - | {{: | + | |
| - | + | ||
| - | The fields shown here are columns in the associated query. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | Click the **Update** button to save the filter information. | + | |
| - | + | ||
| - | Click the **Ok** button to close the Advanced Delivery Definition screen. | + | |
| - | + | ||
| - | Click the **Update** button to save the report definition revisions. | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | **Advanced Delivery Definitions can be created from the Advanced Delivery function of the APP Reports menu.** | + | |
| - | + | ||
| - | Click the SAP menu option for **Advanced Delivery** under the **APP** **Reports** menu to load the Advanced Delivery screen. | + | |
| {{: | {{: | ||
| - | Select the SAP® Business One form that is the primary source for the delivery rules from the **Select Form** drop down list. Only those forms that are associated with queries are displayed. | + | * Select the SAP® Business One form that is the primary source for the delivery rules from the <color #00a2e8>**Select Form**</ |
| + | * Select the APP report definition that uses the desired query from the <color # | ||
| + | * Assign the desired <color # | ||
| + | * Click the <color # | ||
| + | * Click the <color # | ||
| + | * Enter a <color # | ||
| + | * Click the <color # | ||
| + | * Click the <color # | ||
| - | | + | {{:app/image44.jpeg?786}} |
| - | + | ||
| - | | + | |
| - | + | ||
| - | Click the **Ok** button to see the results of the filtering process and to execute the delivery process if desired. | + | |
| - | + | ||
| - | Click the **Save As Config** button to save this configuration for future use. | + | |
| - | + | ||
| - | {{:app/image6.jpeg?10x10}} Enter a **Name** for this new delivery option. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | Click the **Refresh APP Menu** button to refresh the APP menus so that the new configuration is displayed. | + | |
| ===== How To Edit an Advanced Delivery Configuration ===== | ===== How To Edit an Advanced Delivery Configuration ===== | ||
| - | **Advanced Delivery Definitions can be edited from the Report Maintenance screen.** | + | <WRAP center round info> |
| - | + | Advanced Delivery Definitions can be edited from the **Report | |
| - | Click the SAP menu option for **Report | + | </WRAP> |
| - | + | ||
| - | {{:app/image67.jpeg? | + | |
| - | Click on the Report that you want to edit the Advanced Delivery Definition for in order to load the report data to the Maintenance screen. | + | * Click the **<color # |
| + | * Click on the Report that you want to edit the Advanced Delivery Definition for in order to load the report data to the Maintenance screen. | ||
| {{: | {{: | ||
| - | Highlight the definition row that you want to edit. | + | * Highlight the definition row that you want to edit. |
| - | + | | |
| - | Click on the **Advanced Delivery Definitions** tab. | + | |
| - | + | ||
| - | {{: | + | |
| {{: | {{: | ||
| - | The data for the Delivery Definition will be loaded to the screen for editing. | + | * The data for the Delivery Definition will be loaded to the screen for editing. Make any necessary modifications. |
| - | + | | |
| - | Make any necessary modifications. | + | |
| - | + | | |
| - | Click the **Update** button to save the filter information. | + | |
| - | + | ||
| - | Click the **Ok** button to close the Advanced Delivery Definition screen. | + | |
| - | + | ||
| - | Click the **Update** button to save the report definition revisions. | + | |
| - | {{:app/image34.jpeg?804}} | + | {{:app/image44.jpeg?786}} |
| ===== How To Clone an Advanced Delivery Configuration ===== | ===== How To Clone an Advanced Delivery Configuration ===== | ||
| - | **Advanced Delivery Definitions can be cloned from the Report Maintenance | + | <WRAP center round info> |
| + | Advanced Delivery Definitions can be cloned from the **Report Maintenance** | ||
| + | </ | ||
| - | Click the SAP menu option for **Report | + | * Click the **<color #22b14c>Report |
| - | + | | |
| - | {{: | + | |
| - | + | ||
| - | Click on the Report that you want to clone the Advanced Delivery Definition for in order to load the report data to the Maintenance screen. | + | |
| {{: | {{: | ||
| - | Highlight the definition row that you want to clone. | + | * Highlight the definition row that you want to edit. |
| - | + | | |
| - | Click on the **Advanced Delivery Definitions** tab. | + | |
| - | + | ||
| - | {{: | + | |
| {{: | {{: | ||
| - | The data for the Delivery Definition being cloned will be loaded to the screen. | + | * The data for the Delivery Definition being cloned will be loaded to the screen. |
| - | + | | |
| - | Enter a new name for the cloned definition and alter any data needed. | + | |
| - | + | | |
| - | Click the **Update** button to save the filter information. | + | |
| - | + | ||
| - | Click the **Ok** button to close the Advanced Delivery Definition screen. | + | |
| - | + | ||
| - | Click the **Update** button to save the report definition revisions. | + | |
| - | {{:app/image34.jpeg?804}} | + | {{:app/image44.jpeg?786}} |
| ===== How To Remove an Advanced Delivery Configuration ===== | ===== How To Remove an Advanced Delivery Configuration ===== | ||
| - | **Advanced Delivery Definitions can be removed from the Report Maintenance | + | <WRAP center round info> |
| + | Advanced Delivery Definitions can be removed from the **Report Maintenance** | ||
| + | </ | ||
| - | Click the SAP menu option for **Report | + | * Click the **<color #22b14c>Report |
| + | * Click on the Report that you want to remove the Advanced Delivery Definition for in order to load the report data to the Maintenance screen. | ||
| - | {{: | + | {{: |
| - | + | ||
| - | Click on the Report that you want to remove the Advanced Delivery Definition from in order to load the report data to the Maintenance screen. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | Click on the **Advanced Delivery Definitions** tab. | + | |
| - | + | ||
| - | | + | |
| - | + | ||
| - | Click the **Delete** button. | + | |
| - | + | ||
| - | The user will be prompted for confirmation to remove the Delivery Definition. | + | |
| - | + | ||
| - | Click the **Yes** button to confirm definition removal. | + | |
| - | + | ||
| - | Click the **Update** button. | + | |
| - | {{:app/image306.jpeg? | + | * Highlight the definition row that you want to edit. |
| + | * Click on the <color # | ||
| + | * Click the <color # | ||
| + | * The user will be prompted for confirmation to remove the Delivery Definition. | ||
| + | * Click the <color # | ||
| + | * Click the <color # | ||
| - | **Warning** - Once a definition has been removed from the system, it **cannot** be recovered and must be recreated manually. | + | <WRAP center round important> |
| + | Once a definition has been removed from the system, it **cannot** be recovered and must be recreated manually. | ||
| + | </ | ||
| + | {{: | ||
| ===== How To Execute APP Advanced Delivery Definitions ===== | ===== How To Execute APP Advanced Delivery Definitions ===== | ||
| - | **Execution of Previously Defined Advanced Delivery Definitions.** | + | ==== How To Execute |
| - | Click the SAP menu option for the Advanced Delivery Definition that you want to execute under the **APP Reports** | + | * Click the SAP menu option for the Advanced Delivery Definition that you want to execute under the <color #22b14c>**APP Reports**</ |
| + | | ||
| + | | ||
| + | * Click the check boxes of the records to be processed further. All records are selected by default. | ||
| + | * Click the header of the checkbox column to select or clear all records. | ||
| - | | + | <WRAP center round info> |
| + | To select a group of records... | ||
| - | Click **Ok** to execute | + | * |
| + | | ||
| + | * Click the checkbox | ||
| + | * All records | ||
| + | </ | ||
| - | Click the check boxes of the records | + | <WRAP center round info> |
| + | To select a mixed group of records... | ||
| - | Click the header | + | * Click the checkbox |
| + | * Hold down the **CTRL** key while selecting the desired | ||
| + | </ | ||
| - | {{:app/image307.jpeg? | + | * Click <color # |
| + | * You can continue with other tasks while the Advanced Delivery process is working. A progress bar is displayed to show you how many records have been processed. | ||
| - | **Note** - To select a group of records... | ||
| - | Click the checkbox of the first record | + | ==== Define and Execute an Advanced Delivery Definition |
| - | + | ||
| - | Hold down the **SHIFT** key | + | |
| - | + | ||
| - | Click the checkbox of the last record | + | |
| - | + | ||
| - | All records between the two check boxes are selected. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | **Note** - To select a mixed group of records... | + | |
| - | + | ||
| - | Click the checkbox of the first record | + | |
| - | + | ||
| - | Hold down the **CTRL** key while selecting the desired records. | + | |
| - | + | ||
| - | Click **Print** button, **Deliver** button, or **Both** button to execute the delivery process. | + | |
| - | + | ||
| - | You can continue with other tasks while the Advanced Delivery process is working. A progress bar is displayed to show you how many records have been processed. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | **Define and Execute an Advanced Delivery Definition.** | + | |
| A special or one time Advanced Delivery Definition can be created and executed from the Advanced Delivery function of the APP Reports menu. This definition can also be saved for reuse. | A special or one time Advanced Delivery Definition can be created and executed from the Advanced Delivery function of the APP Reports menu. This definition can also be saved for reuse. | ||
| - | Click the SAP menu option for **Advanced Delivery** under the **APP** **Reports** menu to load the Advanced Delivery screen. | + | * Click the SAP menu option for <color #22b14c>**Advanced Delivery**</ |
| {{: | {{: | ||
| - | Select the SAP® Business One form that is the primary source for the delivery rules from the **Select Form** drop down list. Only those forms that are associated with queries are displayed. | + | * Select the SAP® Business One form that is the primary source for the delivery rules from the <color #00a2e8>**Select Form**</ |
| - | + | | |
| - | Select the APP report definition that uses the desired query from the **Use Specific Report** drop down list. Only those report definitions associated with the SAP® Business One form selected are displayed. | + | |
| - | + | | |
| - | Assign the desired **Additional Query Filters** (see above). | + | |
| - | + | | |
| - | Click **Ok** to execute the filtering process. A list of the records that will be processed is displayed. | + | |
| - | + | ||
| - | Click the check boxes of the records to be processed further. All records are selected by default. | + | |
| - | + | ||
| - | Click the header of the checkbox column to select or clear all records. | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | **Note** - To select a group of records... | + | |
| - | + | ||
| - | {{: | + | |
| - | + | ||
| - | Hold down the **SHIFT** key | + | |
| - | + | ||
| - | Click the checkbox of the last record | + | |
| - | + | ||
| - | All records between the two check boxes are selected. | + | |
| - | {{: | + | <WRAP center round info> |
| + | To select a group of records... | ||
| - | **Note** - To select a mixed group of records... | + | |
| + | | ||
| + | * Click the checkbox | ||
| + | * All records | ||
| + | </ | ||
| - | Click the checkbox | + | <WRAP center round info> |
| + | To select a mixed group of records... | ||
| - | Hold down the **CTRL** key while selecting the desired records. | + | * Click the checkbox of the first record |
| + | * Hold down the **CTRL** key while selecting the desired records. | ||
| + | </ | ||
| - | You can continue with other tasks while the Advanced Delivery process is working. A progress bar is displayed to show you how many records have been processed. | + | * You can continue with other tasks while the Advanced Delivery process is working. A progress bar is displayed to show you how many records have been processed. |
| - | {{:app/image34.jpeg?804}} | + | {{:app/image44.jpeg?786}} |
| ===== How To Use APP Pivot Grids and KPIs ===== | ===== How To Use APP Pivot Grids and KPIs ===== | ||