Touring the Interface¶

A short guided tour of the screens you will use, in the order you meet them.

The Projects List¶

The Projects List page is the default landing page after logging in.

This is where you will start every new Project with SLIM using the New Project pane at the top of the view, which asks for a Project Name, a Team, and an optional Description before you click Create Project.

You can also review and explore all the Projects to which you have access, with the most recently created at the top.

The list defaults to a tile view, with important Project details displayed, but the pair of buttons above the list switches between Tile view and a more compact List view if preferred.

Each Project tile (or row in the list view) contains:

Project Name and (optional) Description
Any labels you have applied: used to filter the Projects displayed. Labels are private to you, so what you see here is your own, not your team’s
Team with access (note this could be limited to your own personal access)
Number of Export files imported
Number of integrations analyzed and number of pipelines generated, each shown against the total found
Creation Date

When you hover over each tile or row in the Project list, a trashcan icon appears. Clicking this icon allows you to delete erroneous projects, and clean up the Project list.

NOTE: deleting a Project will delete all of its assets, so ensure you have downloaded anything you need to preserve via the Project Page before deleting the Project.

The Project Sidebar¶

The Project Sidebar is a black bar at the left side of the application screen whose contents will change depending on whether you have an active Project selected. It carries no title of its own, so this documentation names it for you.

If no Project is selected, the Project Sidebar contains links to the Project List, and one-click access to Recent Projects, ordered by the most recent first.

If a Project is Active or Selected, it appears under the heading Current Project, below the Project List link and above the list of Recent Projects. The Project Name is followed by a list of the Stage Page and Job Status links, providing single-click access to any stage of the modernization process for that Project.

Clicking the Project Name in the Project Sidebar takes you to the Project Home Page.

The Project Home Page¶

The Project Home Page is the highest-value screen for each Project as it gives you access to the original Export file, all of the contained integrations, the generated assets, stage log files (if Diagnostic Logging is enabled), and any Design or Reference Documents uploaded to guide the modernization process.

All of these components are arranged in a navigable tree, whose structure will vary depending on the source system that generated the Export file.

All assets are accessible for preview and download. Downloading folder structures from the Project Tree in the Project Home Page compresses the contained assets into a single zipped file.

You can also select a single markdown document in the Project Tree and download or preview it. If you preview a markdown document, you can select to download it as a PDF file, otherwise the default download option is as an editable markdown (.md) file.

Finally, the Project Tree also contains a Logs directory where you can access all of the log files from every operation run in the project. Each sub-directory represents one operation execution and is uniquely named to track back to the operation and/or integration it represents. This is a particularly helpful location when troubleshooting or tracking live progress of an operation.

A Stage Page¶

Each Stage Page represents one stage of the modernization process, but they all share a common structure:

the instruction panel: what the stage does,
what information the stage needs to execute in an editable pane: this is usually the output from the previous stage, so the Integration Analysis stage displays the Export Analysis markdown document,
any stage-specific prompt refinement or additional instructions,
for integration-specific operations, an integration selection pane: this allows you to set a defined scope of the operation so you do not have to process everything at once; this is helpful for large Export files, for situations where not all integrations will be modernized (some will be retired), and to prioritize the order of modernization activity,
the run control: the buttons to initiate or stop the stage executing, in the header at the top of the page,
the Activity Log: a live update of the stage’s progress as it happens.

Two banners can also appear above the log: one when a stage was interrupted and left work unfinished, and one when it failed outright. Both tell you what to do next.

Job Status¶

A read-only cross-integration roll-up of progress through the modernization process for all integrations in the current Project. Each Job state is color-coded to be distinguished at a glance:

Job Status	Color	Deliverables available	Next Stage
Pending	Gray	Export Analysis	Integration Analysis
Integration Analyzing	Blue	Export Analysis
Integration Analyzed	Orange	Export Analysis, Integration Analysis (for specific integrations)	Pipeline Generation
Analysis Incomplete	Orange	Export Analysis, Integration Analysis (depending on when the Integration Analysis process failed; this may be a false negative)	Pipeline Generation (or re-run Integration Analysis, if Pipeline Generation not permitted)
Analysis Failed	Red	Export Analysis	Re-run Integration Analysis for that integration
Generating Pipelines	Blue	Export Analysis, Integration Analysis
Pipeline Incomplete	Orange	Export Analysis, Integration Analysis, and whatever was generated before the interruption	Re-run Pipeline Generation for that integration
Pipeline Generation Failed	Red	Export Analysis, Integration Analysis	Re-run Pipeline Generation for that integration
Completed	Green	Export Analysis, Integration Analysis, Migration Comparison	Platform Deploy

Red means the stage stopped and reported an error. Orange on an Incomplete state means it stopped part-way through without reporting one - usually an interruption rather than a fault - so there is output on disk, just not all of it. Either way the remedy is the same: re-run that stage for that integration.

In addition to the at-a-glance status view, you can also review key documents produced to date for the integrations listed.

For all integrations, the Export Analysis will be available to view either in the standard pane, or in full-screen mode.

For integrations already processed through the more in-depth, Integration Analysis stage, the corresponding document will be similarly available.

For integrations that have had asset generated, the Migration Comparison document will be accessible, covering the behavioral equivalence from the Functional Representation (Python) assets to the SnapLogic pipeline(s) and expression library.

To download these documents or to view all of the other assets, you can use the Project Home Page that lists the complete Project contents.

Note: the Job Status is only updated once a Stage is complete; for live updates on progress, use the appropriate Stage Page, or review the logs (if enabled) in the Project Home Page.

The Header Bar and Menu¶

In the top Header Bar of the SLIM application screen are three controls:

The label filter: this allows you to narrow the Project List view to Projects carrying one of your labels. It reads All projects until you pick one. This is an easy way to clear a screen if you have sensitive or older projects that you do not want to display in the Project List.
The User Menu: opened from the button showing your name, it displays the email address you are signed in with and a Logout button for when you have finished your work for the current period.
The waffle menu, the grid of squares on the right: depending on your access permissions, this offers Admin for configuring your organization’s security, Task Queue to check on the status of all operations, and a link to this Documentation. Everyone sees Documentation; the other two appear only if you have been granted them.