Register an FT Optix Connector
Perform the following steps to register an FT Optix extractor:
- On the Management Console, select theExtractor Infotab.The Extractor Listing page is displayed.
- Click the Add [
] icon.TheExtractor Info Detailpage is displayed.Extractor Info Detail
- In theGeneral Infosection, provide a unique name for your Extractor in theSource Namefield. The Source Name works as the identifier for your extractor. You can search for an extractor using the Source Name. By default, DataMosaix populates a source name.Source Name example: EXT_1406230728_createproject_v1.Here, EXT stands for the extractor, 140623 is the date in ddmmyy format, 0728 is the timestamp in hhmm format, and createproject_v1 is the project in which you are currently working. You can use the default source name or create your own.
- (Optional) Provide the location details. It can help you identify an extractor when you have many extractors for different plants/sites/locations.
- From theAssociated Rolesdrop-down list, select at least one role. You can refer to various roles and capabilities by clickingRole Reference.NOTE:The Associated Roles drop-down is visible and available only for Project Admin users or users within the Organization with a Project Admin Role assigned.You can select multiple roles from the Associated Roles drop-down list. In the search bar, you can search for any specific role from the list. If you want to apply all the roles to the application, select theSelect Allcheckbox.Next, you can select a pipeline or create a new pipeline. When you create a new pipeline, you have the option of selecting from an existing dataset or creating a new dataset.
- In thePipeline Namefield, search for a specific pipeline by entering the first characters and select a pipeline. On selecting a pipeline, the Pipeline External ID and Dataset Name fields are generated.To create a new pipeline, select the+ Create Pipelineoption.TheCreate Pipelinedialog box is displayed.Create Pipeline

- Provide the following Pipeline information to create a new pipeline:
- Pipeline Name
- Pipeline External ID
- Pipeline Description (Optional)
- When you create a pipeline, you can either select an existing dataset or create a new dataset. Select a Dataset from theDataset Namesearch field, if you want to use an existing Dataset.If you choose to create a new Dataset, the Dataset-related fields will be displayed. Provide the following dataset information:
- Dataset Name
- Dataset Description
- ClickAdd. Based on the options you choose (select or create), the Pipeline and Dataset information is either populated or created and displayed on the Extractor Info Detail page.
- In theSource Infosection, select the source type of extractor asFT OPTIX.Extractor Info Detail - FT OPTIX Connector
NOTE:- ClickGet FactoryTalk Optixlink to download or open the release build of FactoryTalk Optix.
- ClickGet FactoryTalk Optix DataMosaix Connectorto view the PCDC portal and download the installer file.
- ClickFor detailed instructions to download the connectorto view theDownload the FactoryTalk Optix from PCDCsection in the online help documentation.
- ClickWhat else should be done in FactoryTalk Optix to connect to DataMosaix?to view theRegister an FT Optix Connectorsection in the online help documentation.
- ClickSave and Apply.TheGenerated info Saveddialog box is displayed and it contains the configuration information. You can view the configuration file details by clickingView generated configuration file. Alternatively, you can also copy and save the information for future use by clickingCopy All. ClickDownloadto download the config.yml file that includes all the configuration information that you can use to run the extractor.Extractor Configuration File Download

- ClickDownload.Theconfig.ymlfile is downloaded in the Downloads folder of your local machine.NOTE:The user can view theApplication Id,Client secret,pipeline-id, anddatasetidin theconfig.ymlfile.
- ClickCloseto close the pop-up window.The new extractor is displayed under Extractor Listing.
- Perform the following steps to addEnvironment Variablein theconfig.ymlfile:IMPORTANT: For security reasons, it is recommended to move the client secret from theconfig.ymlfile to the User Environment Variable.NOTE:TheEnvironment Variableis only accessible in Windows environment, not in Optix Panel. For Optix panel, use the defaultconfig.ymlfile generated by FactoryTalk DataMosaix.
- Go to Windows search and search forEnvironment Variable.
- ClickEdit the system environment variables.TheSystem Propertieswindow is displayed.
- Navigate toAdvanced>Environment Variables....TheEnvironment Variablesdialog box is displayed.
- ClickNew.TheNew User Variabledialog box is displayed.
- Provide the following details:
- Variable name: Provide variable name asoptix-connector-secret.
- Variable value: Refer to the client secret from theconfig.ymlfile.
- ClickOK.Environment Variable Details
Add Environment Variable
- Delete the client secret from theconfig.ymlfile.
- Uncomment thesecret: ${optix-connector-secret}line and save the file.Uncomment Environment Variable

Provide Feedback