{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Smartfacts Unattended Upload Tool","type":"text"}]},{"type":"paragraph","content":[{"text":"The Smartfacts ","type":"text"},{"text":"Unattended Upload Tool","type":"text","marks":[{"type":"strong"}]},{"text":" allows you to publish models without having to open them manually in the authoring tool or upload them manually.","type":"text"}]},{"type":"paragraph","content":[{"text":"Therefor, the model must be checked into a version management system like VCS. After check-in, the model is published to Smartfacts in a periodic interval.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"The Process of Auto-Publishing","type":"text"}]},{"type":"paragraph","content":[{"text":"The following tasks are performed for each configuration.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check out the model from the VCS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check whether any changes have occurred in the model since the last export to Smartfacts. If changes are found, the Smartfacts Export is called for the model.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After the Smartfacts publishing file has been generated, the file is uploaded to Smartfacts and imported into the Smartfacts database. All users who have access to the model receive a Smartfacts notification or an email.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported Modeling Tools","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rhapsody","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enterprise Architect","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Innovator","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cameo / CATIA Magic / MagicDraw with Teamwork Cloud","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported VCS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GIT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Teamwork Cloud","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The tool works with provided configuration files in the form JSON or y(a)ml. A configuration file represents one model that is to be published to Smartfacts.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The following tasks are performed for each configuration.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Checking out the model from the VCS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check whether any changes have occurred in the model since the last export to Smartfacts.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If changes are found, the Smartfacts Export is called for the model.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no changes are found, the model is skipped.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After the export file has been generated, the file is uploaded to Smartfacts. This file is then available after a short time. All users who have access to the model receive a notification within Smartfacts (\"Notification\") or a mail that a new model version is available.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Structure of the Configuration File","type":"text"}]},{"type":"paragraph","content":[{"text":"Each configuration file consists of the following parameters:","type":"text"}]},{"type":"paragraph","content":[{"text":"Source","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GIT repository","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Branch of the model","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Credentials for retrieving the model from GIT","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Target","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Smartfacts instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Model name under which the model is to be exported to Smartfacts","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Credentials to be allowed to publish the model according to smart facts.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"JSON Format: Exemplary structure of the configuration file in JSON format","type":"text"}]},{"type":"codeBlock","content":[{"text":"{ \"modelingTool\": \"RHAPSODY\",\n \"unitName\": \"MyModel\",\n \"doDeltaImport\": false,\n \"smartfactsURL\": \"https://developer-sfit.smartfacts.com/platform\",\n \"versionName\": \"Version.Automatically.Imported\",\n \"smartfactsCredentials\": { \"name\": \"j.nagl@mid.de\",\n \"password\": \"\"\n },\n \"mwhId\": \"mwhe8588029-3b55-4b54-81e0-50ce90aa9637\",\n \"enabled\": true,\n \"gitData\":{ \"url\":\"https://git.acme.com/HomeAlarm.git\",\n \"branch\":\"master\",\n \"credentials\": { \"password\": \"\",\n \"name\": \"gitea-admin\"\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"YAML Format: Exemplary structure of the configuration file in YAML format","type":"text"}]},{"type":"paragraph","content":[{"text":"Same content in YAML format, which is sometimes easier to write:","type":"text"}]},{"type":"codeBlock","content":[{"text":"---\nmodelingTool: RHAPSODY\nunitName: MyModel\ndoDeltaImport: false\nsmartfactsURL: https://developer-sfit.smartfacts.com/platform\nversionName: Version.Automatically.Imported\nsmartfactsCredentials:\n name: j.nagl@mid.de\n password: \"\"\nmwhId: mwhe8588029-3b55-4b54-81e0-50ce90aa9637\nenabled: true\ngitData:\n url: https://git.acme.com/HomeAlarm.git\n branch: master\n credentials:\n password: \"\"\n name: gitea-admin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Explanations for the individual parameters :","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1ca71b2c-9607-427b-90f3-4db98b654a27"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Values","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"modelingTool","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Name of the modeling tool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"[RHAPSODY, ENTERPRISE_ARCHITECT,MAGICDRAW,INNOVATOR]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"unitName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Name of the unit or model as it is named in Smartfacts","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"smartfactsURL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Url of the Smartfacts instance, please note that /platform is appended.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"URL","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"versionName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"The default value for the version name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Will be created by the Headless Publisher.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"smartfactsCredentials","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"User under whose ID the modell is to be published after Smartfacts, the user must be one model owner","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"smartfactsCredentials.name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"The user name of the Smartfacts user, normally its email address, in some installations this is the user name.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"smartfactsCredentials.password","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"The password of the Smartfacts user","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"mwhId","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Modelwarehouse Id","type":"text"}]},{"type":"paragraph","content":[{"text":"( See determination of the model warehouse Id )","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"enabled","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Default : true.","type":"text"}]},{"type":"paragraph","content":[{"text":"The switch can be used to activate or temporarily deactivate individual configurations.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"[true,false]","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"gitData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"GIT Connection Data","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"gitData.url","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"URL of Git Repositories","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"gitData.branch","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Branch of the model to be used, e.g. master, release/version1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"gitData.credentials","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Creditials for (read) access to the model","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"gitData.credentials.name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Name of the reading Git user","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"gitData.credentials.password","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Password of the reading Git user (if necessary)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"eaConnectionData ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"EA Connection Data Section","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"eaConnectionData.modelURL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"The url to the file of the ea model. If the model is checked out from a git model, the relative path to the EA model file must be specified, e.g. .//","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":" cameoConnectionData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"CAMEO Connection Data Section","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.twcSecure","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Use Secure connection ( TWC Setup determines this flag) true,false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.twcURL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"URL of TWC, e.g. twc.acme.com:4555","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.credentials","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Creditials for (read) access to the model","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.credentials.name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Name of the reading TWC user","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.credentials.password","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Password of the reading TWC user (if necessary)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.twcBranch","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Name of the branch on TWC, e.g trunk","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"cameoConnectionData.modelURL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Name of the model in TWC, or the name of the CAMEO file","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"doDeltaImport","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Use version delta publishing (true,","type":"text"},{"text":"false","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"strong"}]},{"text":", delta publishing is used","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"doVersionOverride","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Override last recent version (true,","type":"text"},{"text":"false","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"strong"}]},{"text":", the last version is overriden.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Special tags in the GIT version commentary to control the uploader","type":"text"}]},{"type":"paragraph","content":[{"text":"Since there is no special way in GIT to provide further information to control the uploader, the possibility was created to control the uploader by special tags in the GIT commit comment. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The following keywords are supported:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Name of the version:","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the value for the version\"","type":"text"}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"paragraph","content":[{"text":"VersionName: This is the value for the version name.","type":"text"}]},{"type":"paragraph","content":[{"text":"The specified value within the XML tag or the value of the text VersionName: is taken as the value for the version description after smartfacts.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Description of the version:","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the value for the version description","type":"text"}]},{"type":"paragraph","content":[{"text":"Or","type":"text"}]},{"type":"paragraph","content":[{"text":"VersionDescription:This is the value for the version description to the end of the line.","type":"text"}]},{"type":"paragraph","content":[{"text":"The specified value within the XML tag or the value of the text after Version Description: is taken as the value for the version description after smart facts.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Import priority","type":"text"}]},{"type":"paragraph","content":[{"text":"Each configuration is treated equally. Therefore it is usually not possible to influence which model configuration is processed first and which last.","type":"text"}]},{"type":"paragraph","content":[{"text":"However, if the text ","type":"text"},{"text":"priority:1","type":"text","marks":[{"type":"strong"}]},{"text":" is specified in a commit statement, this configuration is treated preferentially.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default priority of a model is 5, so priorities in the range 1-9 could be specified.","type":"text"}]},{"type":"paragraph","content":[{"text":"If several configurations with the same priority exist, no order can be determined within these configurations and it is \"random\" which model in a generation run is uploaded to smart facts sooner or later.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Mechanism for detecting whether a new upload is necessary","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GIT based models","type":"text"}]},{"type":"paragraph","content":[{"text":"The tool recognizes by the GIT Commit Id whether the model has been changed since the last upload. When uploading to Smartfacts, the current GIT Commit Id is stored with the model version in Smartfacts.","type":"text"}]},{"type":"paragraph","content":[{"text":"Before the model is converted to smart facts again or uploaded, the GIT Commit Id stored in smart facts and the Commit Id stored in the current branch are compared. If these do not differ, no upload is performed and the generation of the model is skipped.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CAMEO TWC Models","type":"text"}]},{"type":"paragraph","content":[{"text":"The tool queries the commit id of the specified model on TWC and checks, if the last model published to Smartfacts has a different it.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Directory structure","type":"text"}]},{"type":"paragraph","content":[{"text":"UUStarter.bat for Windows environment","type":"text"}]},{"type":"paragraph","content":[{"text":"UUStarter.sh for Linux environment","type":"text"}]},{"type":"paragraph","content":[{"text":"The batch file for starting the Uploader Tool","type":"text"}]},{"type":"paragraph","content":[{"text":"RhapsodyUploader.bat","type":"text"}]},{"type":"paragraph","content":[{"text":"Batch file that is called by the tool to start Rhapsody with the desired model and to invoke the Smartfacts Export.","type":"text"}]},{"type":"paragraph","content":[{"text":"Directory lib","type":"text"}]},{"type":"paragraph","content":[{"text":"The Java libraries required by the tool","type":"text"}]},{"type":"paragraph","content":[{"text":"Directory workdir: The working directory with configuration files and the \"Working Directory\" where the models are checked out","type":"text"}]},{"type":"paragraph","content":[{"text":"Content of workdir:","type":"text"}]},{"type":"paragraph","content":[{"text":"And therein the individual configuration files:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Detecting the modelwarehouse id","type":"text"}]},{"type":"paragraph","content":[{"text":"Log in to smartfacts and select the desired modelwarehouse","type":"text"}]},{"type":"paragraph","content":[{"text":"Now press F12 in the browser to open the console and debug windows.","type":"text"}]},{"type":"paragraph","content":[{"text":"Navigate to the web store page and select the “Local Storage”","type":"text"}]},{"type":"paragraph","content":[{"text":"You will now find the model warehouse id under the property “mwhid”","type":"text"}]},{"type":"paragraph","content":[{"text":" Copy the warehouse id to your configuration file.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Installing the tool","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy the structure to e.g. C:\\uploader.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Adapting batch file parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"It is assumed that the installation was performed on drive C: and that Java version 8/241 is used. If this is not the case, the batch files must be adapted.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to use another drive, you have to adapt the parameter BASEDRIVE in each batch file.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are not using the Java jre1.8.0_241, please adapt the parameter JAVAHOME","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Adapting the tool to the Rhapsody Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"Due to the great variance of the Rhapsody installations, another script must also be adapted.","type":"text"}]},{"type":"paragraph","content":[{"text":"It can be found under","type":"text"}]},{"type":"paragraph","content":[{"text":":uploader/tools/rhapsody/RhapsodyUploader.bat","type":"text"}]},{"type":"paragraph","content":[{"text":" Adjust the path of the Rhapsody installation here:","type":"text"}]},{"type":"paragraph","content":[{"text":"RHAPSODY_BASE_PATH","type":"text"}]},{"type":"paragraph","content":[{"text":"Also adjust the parameter JAVAHOME to specify the location of the java installation.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Test existing Rhapsody projects for Plugin confirmity","type":"text"}]},{"type":"paragraph","content":[{"text":"We provide a tool to check whether the Rhapsody projects can be processed by the Smartfacts Rhapsody Plugin.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this purpose, all projects must be provided in a common directory. Each project must have the Smartfacts profile activated and be saved with it.","type":"text"}]},{"type":"paragraph","content":[{"text":"A test run can then be performed with the tool :/uploader/TestRhapsody.bat. For this purpose, each model is fed to the plugin, which calls the Smartfacts converter, which creates an upload.zip for each Rhapsody model.","type":"text"}]},{"type":"paragraph","content":[{"text":"If an error occurs, this is logged in a log file.","type":"text"}]},{"type":"paragraph","content":[{"text":"The source model is not changed.","type":"text"}]},{"type":"paragraph","content":[{"text":"The storage point for the result and log files is located at the location","type":"text"}]},{"type":"paragraph","content":[{"text":"Log Files %TEMP%/smartfactsuploader/logs","type":"text"}]},{"type":"paragraph","content":[{"text":"Workspace files ( upload.zip )","type":"text"}]},{"type":"paragraph","content":[{"text":"%TEMP%/smartfactsuploader/workspaces.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please adapt the file the corresponding parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"PROJECTDIR : the base directory, where the Rhapsody projects are located","type":"text"}]},{"type":"paragraph","content":[{"text":"BASEDRIVE: The base drive","type":"text"}]},{"type":"paragraph","content":[{"text":"JAVAHOME: The Java Installation","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Automatic schedule","type":"text"}]},{"type":"paragraph","content":[{"text":"We use for automatic scheduling the windows task schedule service","type":"text"}]},{"type":"paragraph","content":[{"text":"To do so, please follow the following instructions:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Call the Task scheduler in the windows menu entering “task scheduler”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In actions, create a new task by “Create Task….”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the task according to the following values:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"General Page","type":"text"}]},{"type":"paragraph","content":[{"text":"Triggers Page:","type":"text"}]},{"type":"paragraph","content":[{"text":"Actions Page","type":"text"}]},{"type":"paragraph","content":[{"text":"Save it.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}

Browser not supported