Integrating existing S7 Multiprojects into octoplant using the client archive

These instructions are illustrated using an example project. The example project contains two S7 projects and a library. The S7 Multiproject is called S7 Multiproject. The two S7 projects are called S7 project 1 and S7 project 2. The library is called S7 library.

To integrate an existing project into octoplant, take the following steps

1. Open the S7 Multiproject you want to integrate into octoplant in SIMATIC Manager. Check whether the S7 Multiproject contains the desired content. If everything is correct, you can proceed.
2. Archive the S7 Multiproject you want to integrate into octoplant in the client archive via the SIMATIC Manager.
3. Step-by-step
   1. Go to File/Archive… in SIMATIC Manager.The Archiving dialog will open.
   2. In the Archiving dialog, select the Multiprojects tab.
   3. On the Multiprojects tab, select the S7 Multiproject you want to archive and click on OK.
      1. ![ 1. Image: SIMATIC Manager, Dialog Archive, Tab Multi Projects

](s7_SiManag_Multi_archive_01.PNG)

The Archive – Select archive dialog is displayed.

1. In the **Archiving - Select an archive** dialog, enter the following information:
    1. Under **Save**, select the **vdClientArchive** directory as the archive's location.

](s7_SiManag_Multi_archive_02.PNG)

1. Click **Save**.The **Archive - Options** dialog is displayed.
1. If the settings in the **Archive Options** dialog are not already inactive, deactivate them.

1. Retrieve the S7 Multiproject using the SIMATIC Manager from the client archive.
2. Step-by-step
   1. In SIMATIC Manager, go to File/Retrieve….Retrieving – Select an archive dialog will open.
   2. In the Retrieving – Select an archive dialog, select from the vdClientArchive directory the archive with the S7 Multiproject you want to integrate and click on Open. The Select destination directory dialog is displayed.
   3. In the Select destination directory dialog, select the vdClientArchive directory or one of its subdirectories as the location of the data you want to retrieve and click on OK.
      1. ![ 1. Image: Windows Explorer, select target directory

](s7_SiManag_select_target_directory.PNG)

1. If you want to integrate the S7 Multiproject into a specific location, then select this location in the client archive.

A message box will appear showing the path to the retrieved files (the message box can be turned off if necessary).

1. In the message box, click on **OK**.Another message box will appear informing you that the S7 Multiproject has been retrieved and can be opened.
1. Click on **Yes** if you want to open the S7 Multiproject. Click on **No** if you do not want to open the S7 Multiproject.

1. Create a directory for the S7 Multiproject in the UserClient. !!! note For technical reasons, this directory can not have the same name as the retrieved S7 Multiproject directory in the client archive. However, the path must stay the same. If the retrieved S7 Multiproject directory is located in the highest level of the client archive, for example, then the corresponding directory for the S7 Multiproject in octoplant must also be created in the highest level.

2. Step-by-step 1. In the project tree, find the location where you want to create the new directory. !!! note The file structure in the UserClient must be the same as the file structure in the client archive. 1. Right-click and select New directory in the context menu. 1. Enter a name for the new directory – name of the directory for this example: S7 multi-project octoplant – and press the ENTER key.The directory is created.

3. Create the components of the S7 Multiproject in the directory that you created for this purpose in the UserClient.

4. For each of the dearchived S7 multi-project subdirectories in the client archive, a corresponding component must be created in the S7 multi-project directory of the UserClient.
5. For the example project, create the following components in the S7 Multiprojekt octoplant directory:
   • Component S7 Multiproject octoplant based on the Simatic S7 Multiproject component type
   • Component S7 Library octoplant based on the Simatic S7 Library component type
   • Component S7 Project 1 octoplant based on the Simatic S7 component type
   • Component S7 Project 2 octoplant based on the Simatic S7 component type
     • ![ – Image: Project tree, example S7 multi-project

](s7_Structure_MultiProject_02.PNG)

1. For details on how to create a component, see: Tutorial UserClientNew component create.

the project type. If you want to store an S7 project in a component, the component type has to be Simatic S7. If an S7 project contains a WinCC project, the component type has to be Simatic S7 & WinCC. If an S7 project contains a WinCC flexible project, the component type has to be Simatic S7 & WinCC flexible 1. Cut the contents of the retrieved S7 Multiproject subdirectories in the client archive individually and insert them into the appropriate components.

1. You must cut the contents. Do not copy them. Copying the contents would lead to errors.
2. Repeat the process for all subdirectories.
3. In the case of the example project:
   • In the client archive, cut the content of the S7 Multiproject subdirectory and insert it into the octoplant S7 Multiproject component.
   • In the client archive, cut the content of the S7 Library subdirectory and insert it into the octoplant S7 Library component.
   • In the client archive, cut the content of the S7 Project 1 subdirectory and insert it into the octoplantS7 Project 1 component.
   • In the client archive, cut the content of the S7 Project 2 subdirectory and insert it into the octoplantS7 Project 2 component.
4. Delete the empty subdirectories in the client archive and, at the same time, rename the components to the names of the deleted subdirectories.
5. Step-by-step
   1. Select one of the empty subdirectories in the client archive and save the name of the selected subdirectory (for example, by copying the name to the clipboard).
   2. Delete the selected subdirectory.
   3. Switch to the UserClient.
   4. In the project tree, select the component that corresponds to the deleted subdirectory and change the name of the component to the name of the deleted subdirectory (for example, by pasting the name of the deleted subdirectory from the clipboard) For the example project, make the following name changes:
      • Rename the component S7 Multiproject octoplant to S7 Multiproject.
      • Rename the component S7 Library octoplant to S7 Library.
      • Rename the component S7 Project 1 octoplant to S7 Project 1.
      • Rename the component S7 Project 2 octoplant to S7 Project 2.
        • ![ – Image: Project tree, example S7 multiproject, changed names

](s7_Structure_MultiProject_03.PNG)

1. Repeat this process for all empty subdirectories of the S7 Multiproject in the client archive.
2. Delete the empty S7 Multiproject directory in the client archive and, at the same time, take the name of the deleted S7 Multiproject directory and apply it to its corresponding directory in the UserClient.
3. Step-by-step
   1. Select the empty S7 Multiproject directory in the client archive and save the name of the S7 Multiproject directory (for example, by copying the name to the clipboard).
   2. Delete the selected S7 Multiproject directory.
   3. Switch to the UserClient.
   4. In the project tree, select the directory that corresponds to the deleted S7 Multiproject directory and rename it to the name of the deleted S7 Multiproject directory in the client archive (for example, by pasting the copied name of the deleted S7 Multiproject directory from the clipboard).For the example project, make the following name change:
      • Rename the octoplant S7 Multiproject directory to S7 Multiproject.

4. Open the S7 Multiproject in the UserClient. !!! note Opening the project in the SIMATIC Manager using octoplant after the initial transfer of the project data to octoplant is necessary for technical reasons.

5. Step-by-step

   1. Select the component in which the S7 Multiproject is stored in the project tree – the S7 Multiproject component, in this example.
   2. Right-click on the selected component (S7 Multiproject in this example) and select Open with editor in the context menu. Alternatively press F4The S7 Multiproject will open in SIMATIC Manager. The S7 projects and the libraries of the S7 Multiproject are shown
6. Close the SIMATIC Manager. If you made changes in the project, save them before exiting.
7. Go back to the S7 Multiproject directory in the UserClient, version the project and then check it in.
8. Step-by-step
   1. Go to the directory in which the S7 Multiproject is stored in the project tree(the S7 Multiproject directory in this example).
   2. Right-click on the S7 Multiproject directory and select Create new version in the context menu.All project data in the directory will be versioned.
   3. Right-click on the S7 Multiproject directory and select Check-Inin the context menu.The dialog Check-In will open.
   4. Check whether the correct components are selected, making changes if necessary. If everything is correct, click on the Check-In and close button.The project data is checked in, meaning it was copied to the server and can now be checked out and edited by other users.
9. The S7 Multiproject is integrated and can be managed in octoplant.

Related Topics

• UserClient -> Creating new components