Walkthrough - Working with PILOT Companies and Creating a LIVE Company

In this walkthrough, you will learn how to copy your original PILOT company to a new PILOT company, on which you can test your data, and modify and delete data as required, and then create a LIVE company.

Important: In order to delete database data, you need a developer license. A customer license does NOT have permission to delete data from all of the tables that will be created in the Clean Company package. Your JustFood representative will likely have to perform these steps during your implementation phase.

About This Walkthrough

This walkthrough provides an overview on how to do the following:

Story

Louise's Bakery is implementing JustFood, and wants to test the product before going live. The JustFood team has already created the LouiseBakery_PILOT1 company, which contains all of the necessary setups and data.

Louise's Bakery has worked with the initial LouiseBakery_PILOT1 company, but now wants to make some changes to the setup. Because of existing transactions, some of the setup cannot be changed, so the LouiseBakery_PILOT1 company was copied over to the LouiseBakery_PILOT2 company, and the transactions were deleted from LouiseBakery_PILOT2. This company with no transaction data is known as a clean company.

After working with the data, Louise's Bakery discovered that the YOGIES items were incorrectly added to the database, and all of the YOGIES items need to be deleted. By creating a new configuration package that contained the Item table, and copying the database data to the package, the YOGIES items were deleted from the package, and then the package was applied to the database, which deleted the YOGIES items.

Louise's Bakery also wanted the customer address to have a consistent format. The first step, in making addresses consistent, was to change all references of "PO boxes" to "P.O. Boxes". This was done using an Excel spreadsheet, which allows you to perform a search and replace. While using the Excel spreadsheet, Louise's Bakery also discovered an incorrect record, which was then marked for deletion. By creating a new configuration package that contained the Customer table, and exporting the database data to an Excel spreadsheet, the data was replaced and the incorrect record was deleted. The spreadsheet was then reimported into the package, and the changes were applied to the database.

Louise's Bakery has completed their piloting, and is confident that the setup of the company is complete. The LouiseBakery_PILOT2 company was copied over to the LouiseBakery_LIVE company, and the transactions were deleted from LouiseBakery_LIVE. The number series was reset, and the company status was changed to Production. Louise's Bakery is now ready to go live.

Prerequisites

Creating a Clean Company

Louise's Bakery has worked with the initial LouiseBakery_PILOT1 company, but now wants to make some changes to the setup. Because of existing transactions, some of the setup cannot be changed, so you need to create a copy of the LouiseBakery_PILOT1 company, and then delete the transactions. The new PILOT company will be called LouiseBakery_PILOT2. This company with no transaction data is known as a clean company. You can repeat these steps as many times as you need to create new PILOT companies.

Important: In order to delete database data from the Clean Company package, you need a developer license. A customer license does NOT have permission to delete data from all of the tables created in the Clean Company package.

To do this, you must perform the following steps:

To copy an existing company

  1. Choose the Search icon, enter companies, and select Companies.

  2. Select the company that you want to copy. In this case, LouiseBakery_PILOT1.

  3. On the Home tab, choose Copy. The Copy Company window opens.

  4. Enter the name of the new company. In this case, LouiseBakery_PILOT2.

  5. Click OK.

  6. Select the company that you just created.

  7. On the Actions tab, choose Change Company Status. The Change Company Status window opens.

  8. Select Testing for the New Company Status field. Companies with a status of Testing or Development allow you to delete data from the company.

  9. Click OK.

  10. Click Yes at the warning message. The status of the new company is Testing.

  11. Switch to the company that you just created. In this case, LouiseBakery_PILOT2.

To create a clean company package

This steps creates a package that contains the tables that typically contain transaction data, which is what you want to delete from your LouiseBakery_PILOT2 company.

  1. Choose the Search icon, enter configuration packages, and select Configuration Packages.

  2. On the Actions tab, in the Functions group, choose Create Clean Company Package.

  3. In the Code field, enter the code to represent the Clean Company package. For example, CLEAN_PILOT2.

  4. In the Package Name field, enter the name that describes the package.

  5. Click OK. Once the package is created, the Config Package Card window opens. If required, you can now add any custom tables that you also want to delete data from, or remove any tables that you don't want to delete data from.

To delete data from the company

This step deletes the data from the LouiseBakery_PILOT2 company using the CLEAN_PILOT2 package that you just created. Database data can only be deleted for companies that have a status of Testing or Development on the Companies window. This function does NOT run data deletion integrity checks.

Note: You can only delete data from tables that you are licensed to access.

You should be on the Config. Package Card for the CLEAN_PILOT2 package that you just created.

  1. On the Home tab, in the Process group, choose Delete Database Data.

    Warning: All data will be deleted in the listed tables. This process does NOT validate the data being deleted.

  2. Click Yes at the confirmation message. The data is deleted. This may take a while depending on the number of records.

    The transaction data has now been removed from your LouiseBakery_PILOT2 company, and you can now adjust your setup.

Importing Opening Inventory

When the database data was deleted, all of the inventory was deleted as well. You need to reimport the opening inventory.

The OPENING INVENTORY package allows you to add inventory. The Item Journal table, in the OPENING INVENTORY package, allows lot numbers, item expiration dates and net weights to be loaded into the Item Journal, and then be posted without adding item tracking.

These steps are going to explain how to add lot numbers to the data without adding item tracking.

Prerequisites

To populate the item journal

You need to populate the Item Journal window with the items that you want to add data to.

  1. Open the Item Journal window.

  2. Select a batch name. For example, OPENINV. Make note of the batch name.

  3. Delete any lines in the journal.

  4. Add the following information for each item that you want to add inventory to:

To export the OPENING INVENTORY package

  1. Choose the Search icon, enter configuration packages, and select Configuration Packages.

  2. On the Config. Packages window, open the OPENING INVENTORY package. This package is added when a new company is created.

  3. Select the Item Journal Line record.

  4. In the Excel tab, choose Export to Excel.

  5. Click Yes.

  6. Save the file.

To populate the Excel spreadsheet

From the Excel spreadsheet, you can enter the lot number, and choose the setting that allows you to add inventory without item tracking.

  1. Open the Excel spreadsheet that you just created.

  2. Delete all of the lines except for the ones where the Journal Batch Name is the same as the batch that you selected when populating the item journal.

  3. Enter the lot numbers in the values in the Lot No. field.

  4. If required, enter the total net weight of the items in the Net Weight field. Note: If the Net Weight field is blank, then the net weight will be inherited from the item card. If the Net Weight field is zero (0), then the net weight will remain zero.

  5. Enter TRUE in the Post Using Line-Level Lot No. field for all items that you want to add the lot number. This will allow you to post the records from the Item Journal without having to add item tracking.

  6. Save and close the spreadsheet. Important: If you do not close the spreadsheet, you cannot import it into JustFood.

To import the Excel spreadsheet

  1. From the OPENING INVENTORY Config. Package Card window, select the Item Journal Line record.

  2. In the Excel tab, choose Import from Excel.

  3. Select the Excel spreadsheet that you just saved. The value in the No. of Package Records field is updated once the spreadsheet is imported.

  4. On the Functions tab, choose Apply Data.

  5. Click Yes to continue. You will receive a message saying how many records were modified.

To post the items to inventory

Now that the lot numbers have been assigned to the item, you can return to the Item Journal window, and add the items to inventory.

  1. Open the Item Journal window.

  2. Select the batch name that corresponds with the batch name where you added your items for opening inventory.

  3. On the Home tab, choose Post.

  4. Click Yes to post the journal lines.

    The items have now been added to inventory.

Creating a Live Company

Louise's Bakery has completed their piloting, and is confident that the setup of the company is complete. Now you need to create a transaction-free copy of the latest pilot company that you can go live with.

To do this, you must perform the following steps:

To copy an existing company

  1. Choose the Search icon, enter companies, and select Companies.

  2. Select the latest PILOT company that you want to copy.

  3. On the Home tab, choose Copy. The Copy Company window opens.

  4. Enter the name of the new company. In this case, LouiseBakery_LIVE.

  5. Click OK.

  6. Switch to the company that you just created. In this case, LouiseBakery_LIVE.

To create a clean company package

This steps creates a package that contains the tables that contain transaction data, which is what you want to delete from your LouiseBakery_LIVE company.

  1. Choose the Search icon, enter configuration packages, and select Configuration Packages.

  2. On the Actions tab, in the Functions group, choose Create Clean Company Package.

  3. In the Code field, enter the code to represent the Clean Company package. For example, CLEAN_LIVE.

  4. In the Package Name field, enter the name that describes the package.

  5. Click OK. Once the package is created, the Config Package Card window opens. If required, you can now add any custom tables that you also want to delete data from, or remove any tables that you don't want to delete data from.

To delete data from the company

This step deletes the data from the LouiseBakery_LIVE company using the CLEAN_LIVE package that you just created. Database data can only be deleted for companies that have a status of Testing or Development on the Companies window. This function does NOT run data deletion integrity checks.

Note: You can only delete data from tables that you are licensed to access.

You should be on the Config. Package Card for the CLEAN_LIVE package that you just created.

  1. On the Home tab, in the Process group, choose Delete Database Data.

    Warning: All data will be deleted in the listed tables. This process does NOT validate the data being deleted.

  2. Click Yes at the confirmation message. The data is deleted. This may take a while depending on the number of records.

    The transaction data has now been removed from your LouiseBakery_LIVE company.

To import opening inventory

Once you're confident that your inventory levels will not be changing prior to going live, you can enter your final opening inventory.

See Importing Opening Inventory.

To reset the number series

This step clears the number series that were incremented during piloting.

  1. Create a new configuration package.

    1. From the Configuration Packages window, click New. The Config. Package Card window opens.

    2. In the Code field, enter NUMBER_SERIES.

    3. In the Package Name field, enter Number Series.

    4. Select the Exclude Config. Tables check box.

    5. In the Tables FastTab, select 309 in the Table ID field.

    6. Click OK.

  2. Export the data to Excel.

    1. From the Tables FastTab, choose Export to Excel.

    2. Click Yes to export the data to the Excel spreadsheet.

    3. Enter Number Series as the name for the spreadsheet and click Save. The Excel spreadsheet opens.

  3. Update the data in the Excel spreadsheet.

    Warning: Make sure that the corresponding tables using the number series have had their data cleared, otherwise resetting the number series may result in duplicate entry errors.

    1. Open the spreadsheet.

    2. Clear the data in the Last No. Used and Last Date Used columns for the number series where corresponding tables have had their data cleared.

    3. Save the spreadsheet.

  4. Import the Excel spreadsheet.

    1. Return to the Config. Package Card window, and from the Tables Fast tab, choose Excel>Import from Excel.

    2. Click Yes to import the data to the package.

    3. Navigate to the spreadsheet, and click Open.

  5. Apply the changed data to the database.

    1. On the Home tab, in the Process group, choose Apply Package.

    2. Click Yes to apply the data.

    The number series have now been reset, and records will be numbered according to the starting number in the series.

To change the company status to production

This step changes the status of the company to Production.

  1. Choose the Search icon, enter companies, and select Companies.

  2. Select the LIVE company. In this case, LouiseBakery_LIVE.

  3. On the Actions tab, choose Change Company Status.

  4. Select Production in the New Company Status field.

  5. Click OK.

    The status of the LIVE company is now Production, and Louise's Bakery is ready to start using the LouiseBakery_LIVE company.

Video

Video Icon How Do I: Work with PILOT Companies and Create a LIVE Company

See Also

About JustFood RapidStart
About RapidStart Walkthroughs
About JustFood Walkthroughs



© 2018 Microsoft and IndustryBuilt. All rights reserved.

JustFood 2018 (11.00.00.00) | February 2018